Metadata-Version: 2.0
Name: yandex-search
Version: 0.3.0
Summary: Yandex search library
Home-page: https://github.com/codinguncut/yandex-search
Author: Johannes Ahlmann
Author-email: johannes@fluquid.com
License: MIT
Keywords: yandex-search
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Requires-Dist: requests
Requires-Dist: lxml
Requires-Dist: six

=============
Yandex Search
=============

.. image:: https://img.shields.io/pypi/v/yandex-search.svg
        :target: https://pypi.python.org/pypi/yandex-search

.. image:: https://img.shields.io/travis/fluquid/yandex-search.svg
        :target: https://travis-ci.org/fluquid/yandex-search

.. image:: https://codecov.io/github/fluquid/yandex-search/coverage.svg?branch=master
    :alt: Coverage Status
    :target: https://codecov.io/github/fluquid/yandex-search

.. image:: https://requires.io/github/fluquid/yandex-search/requirements.svg?branch=master
    :alt: Requirements Status
    :target: https://requires.io/github/fluquid/yandex-search/requirements/?branch=master


Search library for yandex.ru search engine.

Yandex allows **10,000 searches per day** when registered with a validated (international) mobile number.

Example
-------
::

    >>> yandex = yandex_search.Yandex(api_user='asdf', api_key='asdf')
    >>> yandex.search('"Interactive Saudi"')
    {"items": [{
          "snippet": "Your Software Development Partner In  Saudi   Arabia . Since our early days in 2003, our main goal in  Interactive   Saudi   Arabia  has been: \"To earn customer respect and maintain long-term loyalty\".",
          "url": "http://www.interactive.sa/en",
          "title": "Interactive   Saudi   Arabia  Limited",
          "domain": "www.interactive.sa"
        }]
    }

Getting Started
---------------
* register account: https://passport.yandex.ru/registration

  * use google translate addon (right-click "translate page")

* configure yandex: https://xml.yandex.ru/settings.xml

  * find "key" under "test"
  * set IP to your querying machine


Notes
-----
* Yandex highlights matching terms, leading to extra whitespace from `' '.join`

Alternatives
------------
* pyyaxml is py2-only and was giving me grief ;)

Documentation
-------------
search operators:

* https://yandex.com/support/search/how-to-search/search-operators.html

settings:

* https://xml.yandex.ru/settings.xml

docs:

* https://tech.yandex.ru/xml/doc/dg/concepts/restrictions-docpage/
* https://yandex.com/support/search/robots/search-api.html

=======
History
=======


0.3.0 (2017-06-11)
------------------

* better log output for issues with error message code parsing

0.2.0 (unreleased)
----------------------

* made it better ;)

0.1.0-dev (unreleased)
----------------------

* First release on PyPI.

