Repolode
Предложить
deedy5

deedy5/ddgs

Библиотека метапоиска на Python, которая обращается к нескольким поисковым системам и возвращает единообразные результаты по веб-страницам, изображениям, видео, новостям и книгам.

Open source альтернатива:Google Custom Search API

Открыть на GitHub
Звёзды
3,024
Форки
287
Открытые issues
33
Последний коммит
2 месяца назад

Что это?

DDGS — библиотека метапоиска на Python: она отправляет один запрос сразу в несколько поисковых сервисов и возвращает результаты в едином формате. Метод text() работает с такими источниками, как Bing, Brave, DuckDuckGo, Google, Mojeek, Startpage, Yandex, Yahoo и Wikipedia; по умолчанию используется backend auto.

Помимо веб-поиска по тексту, библиотека предоставляет методы images(), videos(), news() и books(), а также extract(), который загружает страницу по URL и преобразует её в Markdown, обычный или форматированный текст, исходный HTML либо байты. Результаты возвращаются в виде списков словарей, а те же функции доступны через интерфейс командной строки.

Для интеграции DDGS включает API-сервер на FastAPI с эндпоинтами для каждого типа поиска и извлечения содержимого, а также MCP-сервер, работающий через stdio и предоставляющий эти операции в виде инструментов для клиентов, таких как Cursor или Claude Desktop. Запросы можно направлять через HTTP-, HTTPS- или SOCKS5-прокси.

Ключевые возможности

  • 01Объединяет результаты текстового поиска из нескольких источников, например Bing, Brave, Google и DuckDuckGo.
  • 02Предоставляет методы поиска изображений, видео, новостей и книг с фильтрами для каждого типа.
  • 03Извлекает содержимое страницы по URL в формате Markdown, обычного или форматированного текста, HTML либо исходных байтов.
  • 04Включает CLI, API-сервер на FastAPI и MCP-сервер для клиентов, работающих с инструментами.
  • 05Поддерживает HTTP-, HTTPS- и SOCKS5-прокси, а также настройку таймаутов.

Сценарии использования

  • Добавление веб-поиска в приложение на Python или LLM-агента без платного поискового API.
  • Предоставление поиска и извлечения содержимого страниц в виде инструментов для AI-ассистентов с поддержкой MCP.
  • Запуск собственного поискового эндпоинта для внутренних сервисов с помощью API-сервера, готового к работе с Docker.
  • Сбор результатов поиска или текста страниц из командной строки для скриптов.

Быстрый старт

  1. 1

    Установите базовый пакет с помощью pip

    pip install -U ddgs
  2. 2

    Выполните текстовый поиск из Python

    python3 -c "from ddgs import DDGS; print(DDGS().text('python programming', max_results=5))"

Что важно знать

  • Результаты предоставляются сторонними поисковыми системами, поэтому доступность и качество результатов зависят от этих сервисов.

Темы

#metasearch#web-search#python#api#mcp#web-scraping#llm-tools#ddgs#dht#mcp-server

Частые вопросы

Что такое ddgs?
Библиотека метапоиска на Python, которая обращается к нескольким поисковым системам и возвращает единообразные результаты по веб-страницам, изображениям, видео, новостям и книгам. DDGS — библиотека метапоиска на Python: она отправляет один запрос сразу в несколько поисковых сервисов и возвращает результаты в едином формате. Метод text() работает с такими источниками, как Bing, Brave, DuckDuckGo, Google, Mojeek, Startpage, Yandex, Yahoo и Wikipedia; по умолчанию используется backend auto.
ddgs можно использовать бесплатно? Какая у него лицензия?
ddgs распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
ddgs всё ещё поддерживается?
Обновлялся за последние 6 месяцев. Последний коммит в ddgs — 26 авг. 2026 г..
Для чего можно использовать ddgs?
Добавление веб-поиска в приложение на Python или LLM-агента без платного поискового API. Предоставление поиска и извлечения содержимого страниц в виде инструментов для AI-ассистентов с поддержкой MCP. Запуск собственного поискового эндпоинта для внутренних сервисов с помощью API-сервера, готового к работе с Docker. Сбор результатов поиска или текста страниц из командной строки для скриптов.
Как установить ddgs?
Установите базовый пакет с помощью pip: pip install -U ddgs Выполните текстовый поиск из Python: python3 -c "from ddgs import DDGS; print(DDGS().text('python programming', max_results=5))"
Где скачать ddgs?
Исходный код и инструкции по установке — на GitHub: https://github.com/deedy5/ddgs

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты