yandex-search 0.3.2

Yandex search library

Yandex Search

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

  • Navigate to “Settings”

    • switch language to english in bottom left (En/Ru)

    • enter email for “Email notifications”

    • set “Search type” to “Worldwide”

    • set “Main IP-address” to your querying machine

    • “I accept the terms of License Agreement”

    • Save

  • Navigate to “Test”

    • “? user = “ is your credentials username

    • “& key = “ is your crednetials key

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.2 (2017-06-12)

• updated readme to include “accept terms of license agreement”

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.