# Пакет для работы с поисковыми системами Google, Yandex через сервис xmlriver.com
*English description below*
Привет! Добро пожаловать на страницу пакета xmlriver, который позволяет взаимодействовать по API с сервисом xmlriver.com и получать результаты выдачи из поисковых систем Яндекс и Google.
## Установка
pip install xmlriver
## Использование
import xmlriver
user = 000 #Ваш user_id со страницы https://xmlriver.com/queries/
key = '' #Ваш ключ со страницы https://xmlriver.com/queries/
google = xmlriver.Google(user, key)
query = 'Ваш запрос'
if google.request(query):
print(google.results)
## Дополнительные параметры
Вы можете передавать дополнительные параметры, которые представлены на странице https://xmlriver.com/apidoc/api-about/ (для Google) и https://xmlriver.com/apiydoc/apiy-about/ (для Яндекс)
Можно доработать по примерам https://xmlriver.com/apidoc/api-organic/
**Пример передачи параметров:**
google = xmlriver.Google(user, key, country=10, device='desktop')
Или прямо в запросе:
google.query(query, country=10, device='desktop')
## Доступные методы и атрибуты
1. google.get_balance() - Получить информацию о балансе
2. google.get_cost() - Получить стоимость за 1 000 запросов
3. google.request(query, **kwargs) - Отправить запрос к Google
4. google.pages - Число, количество найденных результатов
5. google.results - Список найденных документов
6. google.get_urls() - Список найденных URL
7. google.get_titles() - Список заголовков результатов поисковой выдачи
8. google.get_results_with_domain(domain, **kwargs) - Аналог запроса "domain" -site:domain. Выводит количество результатов
9. google.is_trust_domain(domain, **kwargs) - Простая проверка домена на траст. True / False
10. google.is_url_pessimised(url, **kwargs) - Проверка url на наличие фильтра - True / False. Перед этим проверьте, что URL проиндексирован
11. google.is_url_indexed(url, **kwargs) - Проверка url на индексацию
12. google.get_onebox_documents(query, types, **kwargs) - получить OneBox документы. Смотри https://xmlriver.com/apidoc/api-organic/#onebox
## Поддержка
xmlriver использует пакеты requests и xmltodict и должен работать везде, где работает Python.
## Автор
Иван Шарков
Мой блог https://0pl.ru
Моя организация: https://kurshub.ru
# Package for working with search engines Google, Yandex via xmlriver.com service
Hi! Welcome to the xmlriver package page, which allows you to interact via API with xmlriver.com service and get results from Yandex and Google search engines.
## Install
pip install xmlriver
## Usage
import xmlriver
user = 000 #Your user_id from the page https://xmlriver.com/queries/
key = '' #Your key from page https://xmlriver.com/queries/
google = xmlriver.Google(user, key)
query = 'Your query'
if google.request(query):
print(google.results)
## Additional parameters
You can pass additional parameters, which can be found at https://xmlriver.com/apidoc/api-about/ (for Google) and https://xmlriver.com/apiydoc/apiy-about/ (for Yandex).
**Example of passing parameters:**
google = xmlriver.Google(user, key, country=10, device='desktop')
Or directly in the query:
google.query(query, country=10, device='desktop')
## Available methods and attributes
1. google.get_balance() - Get balance information
2. google.get_cost() - Get cost per 1,000 queries
3. google.request(query, **kwargs) - Send a query to Google
4. google.pages - Number, number of results found
5. google.results - List of documents found
6. google.get_urls() - List of URLs found
7. google.get_titles() - List of titles of search results
8. google.get_results_with_domain(domain, **kwargs) - Analogous to the query "domain"-site:domain. Outputs the number of results
9. google.is_trust_domain(domain, **kwargs) - Simple domain trust check. True / False
10. google.is_url_pessimized(url, **kwargs) - Check url for filter - True / False. Before doing this, check that the url is indexed
11. google.is_url_indexed(url, **kwargs) - Check url for indexing
12. google.get_onebox_documents(query, types, **kwargs) - get OneBox documents. See https://xmlriver.com/apidoc/api-organic/#onebox
## Support
xmlriver uses the requests and xmltodict packages and should work wherever Python is running.
## Author
Ivan Sharkov
My blog: https://0pl.ru
My organization: https://kurshub.ru
Raw data
{
"_id": null,
"home_page": "https://github.com/KursHub-ru/xmlriver",
"name": "xmlriver",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "google,yandex,xmlriver,xmlriver.com",
"author": "Ivan Sharkov",
"author_email": "admin@kurshub.ru",
"download_url": "https://files.pythonhosted.org/packages/d5/a3/9cf36b6ebbbdf2e7f0a3ea8b5346ab2f68dbbd4d5429adb3fbdbc609dbca/xmlriver-0.13.tar.gz",
"platform": null,
"description": "# \u041f\u0430\u043a\u0435\u0442 \u0434\u043b\u044f \u0440\u0430\u0431\u043e\u0442\u044b \u0441 \u043f\u043e\u0438\u0441\u043a\u043e\u0432\u044b\u043c\u0438 \u0441\u0438\u0441\u0442\u0435\u043c\u0430\u043c\u0438 Google, Yandex \u0447\u0435\u0440\u0435\u0437 \u0441\u0435\u0440\u0432\u0438\u0441 xmlriver.com\n\n*English description below*\n\n\n\u041f\u0440\u0438\u0432\u0435\u0442! \u0414\u043e\u0431\u0440\u043e \u043f\u043e\u0436\u0430\u043b\u043e\u0432\u0430\u0442\u044c \u043d\u0430 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0443 \u043f\u0430\u043a\u0435\u0442\u0430 xmlriver, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u0432\u0437\u0430\u0438\u043c\u043e\u0434\u0435\u0439\u0441\u0442\u0432\u043e\u0432\u0430\u0442\u044c \u043f\u043e API \u0441 \u0441\u0435\u0440\u0432\u0438\u0441\u043e\u043c xmlriver.com \u0438 \u043f\u043e\u043b\u0443\u0447\u0430\u0442\u044c \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u044b \u0432\u044b\u0434\u0430\u0447\u0438 \u0438\u0437 \u043f\u043e\u0438\u0441\u043a\u043e\u0432\u044b\u0445 \u0441\u0438\u0441\u0442\u0435\u043c \u042f\u043d\u0434\u0435\u043a\u0441 \u0438 Google.\n\n## \u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430\n\n pip install xmlriver\n\n## \u0418\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435\n\n import xmlriver\n user = 000 #\u0412\u0430\u0448 user_id \u0441\u043e \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u044b https://xmlriver.com/queries/\n key = '' #\u0412\u0430\u0448 \u043a\u043b\u044e\u0447 \u0441\u043e \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u044b https://xmlriver.com/queries/\n google = xmlriver.Google(user, key)\n query = '\u0412\u0430\u0448 \u0437\u0430\u043f\u0440\u043e\u0441'\n if google.request(query):\n\t print(google.results)\n\n## \u0414\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b\n\u0412\u044b \u043c\u043e\u0436\u0435\u0442\u0435 \u043f\u0435\u0440\u0435\u0434\u0430\u0432\u0430\u0442\u044c \u0434\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u043f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u0435\u043d\u044b \u043d\u0430 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0435 https://xmlriver.com/apidoc/api-about/ (\u0434\u043b\u044f Google) \u0438 https://xmlriver.com/apiydoc/apiy-about/ (\u0434\u043b\u044f \u042f\u043d\u0434\u0435\u043a\u0441)\n\n\u041c\u043e\u0436\u043d\u043e \u0434\u043e\u0440\u0430\u0431\u043e\u0442\u0430\u0442\u044c \u043f\u043e \u043f\u0440\u0438\u043c\u0435\u0440\u0430\u043c https://xmlriver.com/apidoc/api-organic/\n\n**\u041f\u0440\u0438\u043c\u0435\u0440 \u043f\u0435\u0440\u0435\u0434\u0430\u0447\u0438 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u043e\u0432:**\n\n google = xmlriver.Google(user, key, country=10, device='desktop')\n\n\u0418\u043b\u0438 \u043f\u0440\u044f\u043c\u043e \u0432 \u0437\u0430\u043f\u0440\u043e\u0441\u0435:\n\n google.query(query, country=10, device='desktop')\n\n## \u0414\u043e\u0441\u0442\u0443\u043f\u043d\u044b\u0435 \u043c\u0435\u0442\u043e\u0434\u044b \u0438 \u0430\u0442\u0440\u0438\u0431\u0443\u0442\u044b\n 1. google.get_balance() - \u041f\u043e\u043b\u0443\u0447\u0438\u0442\u044c \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044e \u043e \u0431\u0430\u043b\u0430\u043d\u0441\u0435\n 2. google.get_cost() - \u041f\u043e\u043b\u0443\u0447\u0438\u0442\u044c \u0441\u0442\u043e\u0438\u043c\u043e\u0441\u0442\u044c \u0437\u0430 1 000 \u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432\n 3. google.request(query, **kwargs) - \u041e\u0442\u043f\u0440\u0430\u0432\u0438\u0442\u044c \u0437\u0430\u043f\u0440\u043e\u0441 \u043a Google\n 4. google.pages - \u0427\u0438\u0441\u043b\u043e, \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u043d\u0430\u0439\u0434\u0435\u043d\u043d\u044b\u0445 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u043e\u0432\n 5. google.results - \u0421\u043f\u0438\u0441\u043e\u043a \u043d\u0430\u0439\u0434\u0435\u043d\u043d\u044b\u0445 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u043e\u0432\n 6. google.get_urls() - \u0421\u043f\u0438\u0441\u043e\u043a \u043d\u0430\u0439\u0434\u0435\u043d\u043d\u044b\u0445 URL\n 7. google.get_titles() - \u0421\u043f\u0438\u0441\u043e\u043a \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043a\u043e\u0432 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u043e\u0432 \u043f\u043e\u0438\u0441\u043a\u043e\u0432\u043e\u0439 \u0432\u044b\u0434\u0430\u0447\u0438\n 8. google.get_results_with_domain(domain, **kwargs) - \u0410\u043d\u0430\u043b\u043e\u0433 \u0437\u0430\u043f\u0440\u043e\u0441\u0430 \"domain\" -site:domain. \u0412\u044b\u0432\u043e\u0434\u0438\u0442 \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u043e\u0432\n 9. google.is_trust_domain(domain, **kwargs) - \u041f\u0440\u043e\u0441\u0442\u0430\u044f \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0430 \u0434\u043e\u043c\u0435\u043d\u0430 \u043d\u0430 \u0442\u0440\u0430\u0441\u0442. True / False\n 10. google.is_url_pessimised(url, **kwargs) - \u041f\u0440\u043e\u0432\u0435\u0440\u043a\u0430 url \u043d\u0430 \u043d\u0430\u043b\u0438\u0447\u0438\u0435 \u0444\u0438\u043b\u044c\u0442\u0440\u0430 - True / False. \u041f\u0435\u0440\u0435\u0434 \u044d\u0442\u0438\u043c \u043f\u0440\u043e\u0432\u0435\u0440\u044c\u0442\u0435, \u0447\u0442\u043e URL \u043f\u0440\u043e\u0438\u043d\u0434\u0435\u043a\u0441\u0438\u0440\u043e\u0432\u0430\u043d\n 11. google.is_url_indexed(url, **kwargs) - \u041f\u0440\u043e\u0432\u0435\u0440\u043a\u0430 url \u043d\u0430 \u0438\u043d\u0434\u0435\u043a\u0441\u0430\u0446\u0438\u044e\n 12. google.get_onebox_documents(query, types, **kwargs) - \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u044c OneBox \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u044b. \u0421\u043c\u043e\u0442\u0440\u0438 https://xmlriver.com/apidoc/api-organic/#onebox\n\n## \u041f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0430\nxmlriver \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442 \u043f\u0430\u043a\u0435\u0442\u044b requests \u0438 xmltodict \u0438 \u0434\u043e\u043b\u0436\u0435\u043d \u0440\u0430\u0431\u043e\u0442\u0430\u0442\u044c \u0432\u0435\u0437\u0434\u0435, \u0433\u0434\u0435 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 Python.\n\n## \u0410\u0432\u0442\u043e\u0440\n\u0418\u0432\u0430\u043d \u0428\u0430\u0440\u043a\u043e\u0432\n\u041c\u043e\u0439 \u0431\u043b\u043e\u0433 https://0pl.ru\n\u041c\u043e\u044f \u043e\u0440\u0433\u0430\u043d\u0438\u0437\u0430\u0446\u0438\u044f: https://kurshub.ru\n\n\n\n# Package for working with search engines Google, Yandex via xmlriver.com service\n\n\nHi! Welcome to the xmlriver package page, which allows you to interact via API with xmlriver.com service and get results from Yandex and Google search engines.\n\n## Install\n\n pip install xmlriver\n\n## Usage\n\n import xmlriver\n user = 000 #Your user_id from the page https://xmlriver.com/queries/\n key = '' #Your key from page https://xmlriver.com/queries/\n google = xmlriver.Google(user, key)\n query = 'Your query'\n if google.request(query):\n\t print(google.results)\n\n## Additional parameters\nYou can pass additional parameters, which can be found at https://xmlriver.com/apidoc/api-about/ (for Google) and https://xmlriver.com/apiydoc/apiy-about/ (for Yandex).\n\n**Example of passing parameters:**\n\n google = xmlriver.Google(user, key, country=10, device='desktop')\n\nOr directly in the query:\n\n google.query(query, country=10, device='desktop')\n\n## Available methods and attributes\n 1. google.get_balance() - Get balance information\n 2. google.get_cost() - Get cost per 1,000 queries\n 3. google.request(query, **kwargs) - Send a query to Google\n 4. google.pages - Number, number of results found\n 5. google.results - List of documents found\n 6. google.get_urls() - List of URLs found\n 7. google.get_titles() - List of titles of search results\n 8. google.get_results_with_domain(domain, **kwargs) - Analogous to the query \"domain\"-site:domain. Outputs the number of results\n 9. google.is_trust_domain(domain, **kwargs) - Simple domain trust check. True / False\n 10. google.is_url_pessimized(url, **kwargs) - Check url for filter - True / False. Before doing this, check that the url is indexed\n 11. google.is_url_indexed(url, **kwargs) - Check url for indexing\n 12. google.get_onebox_documents(query, types, **kwargs) - get OneBox documents. See https://xmlriver.com/apidoc/api-organic/#onebox\n\n## Support\nxmlriver uses the requests and xmltodict packages and should work wherever Python is running.\n\n## Author\nIvan Sharkov\nMy blog: https://0pl.ru\nMy organization: https://kurshub.ru\n",
"bugtrack_url": null,
"license": "",
"summary": "\u041f\u0430\u043a\u0435\u0442 \u0434\u043b\u044f \u0440\u0430\u0431\u043e\u0442\u044b \u0441 \u043f\u043e\u0438\u0441\u043a\u043e\u0432\u043e\u0439 \u0432\u044b\u0434\u0430\u0447\u0435\u0439 Google \u0438 Yandex \u043f\u043e API \u0447\u0435\u0440\u0435\u0437 \u0441\u0435\u0440\u0432\u0438\u0441 XMLRiver / Package for working with Google and Yandex search results via API via XMLRiver service.",
"version": "0.13",
"project_urls": {
"Documentation": "https://github.com/KursHub-ru/xmlriver",
"GitHub": "https://github.com/KursHub-ru/xmlriver",
"Homepage": "https://0pl.ru",
"Organization": "https://kurshub.ru",
"Telegram": "https://t.me/sharkovseo"
},
"split_keywords": [
"google",
"yandex",
"xmlriver",
"xmlriver.com"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9a70df39f06f49c3654e05293e547df0caf6008239f53755f3edeabcb21c75d4",
"md5": "d906749875692cc35189fd8970e2154a",
"sha256": "0ec750c2ca0f3f8030e180100c3243e016772cddf291a1b114a7526d04c3d3e0"
},
"downloads": -1,
"filename": "xmlriver-0.13-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d906749875692cc35189fd8970e2154a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 20130,
"upload_time": "2024-03-12T11:21:12",
"upload_time_iso_8601": "2024-03-12T11:21:12.072293Z",
"url": "https://files.pythonhosted.org/packages/9a/70/df39f06f49c3654e05293e547df0caf6008239f53755f3edeabcb21c75d4/xmlriver-0.13-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d5a39cf36b6ebbbdf2e7f0a3ea8b5346ab2f68dbbd4d5429adb3fbdbc609dbca",
"md5": "59c6042d42fe5b2caf9a41bb91629429",
"sha256": "3ece41da3f025001590b176ab83c84f7364de050418b618f9d89f967dcb4c6d2"
},
"downloads": -1,
"filename": "xmlriver-0.13.tar.gz",
"has_sig": false,
"md5_digest": "59c6042d42fe5b2caf9a41bb91629429",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 20726,
"upload_time": "2024-03-12T11:21:13",
"upload_time_iso_8601": "2024-03-12T11:21:13.547635Z",
"url": "https://files.pythonhosted.org/packages/d5/a3/9cf36b6ebbbdf2e7f0a3ea8b5346ab2f68dbbd4d5429adb3fbdbc609dbca/xmlriver-0.13.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-12 11:21:13",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "KursHub-ru",
"github_project": "xmlriver",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "xmlriver"
}
JSON
