DDGS
DDGS — это мощная метапоисковая библиотека и API, которая агрегирует результаты из Google, Bing, DuckDuckGo и других. Выполняйте поиск по тексту, изображениям, видео, новостям и книгам на Python, с поддержкой Docker и ИИ-помощью.
Чтобы поставить лайк, войдите в аккаунт или зарегистрируйтесь:
DDGS, или Dux Distributed Global Search, — это мощная метапоисковая библиотека на Python, предназначенная для объединения информации из нескольких веб-поисковых систем. Она предоставляет программный интерфейс для выполнения разнообразных поисков, включая текст, изображения, видео, новости и книги, используя различные внутренние сервисы. Помимо функциональности библиотеки, DDGS предлагает API-сервер со встроенной поддержкой MCP (протокол многоагентной связи), что обеспечивает возможность поиска с помощью ИИ и простое развертывание через Docker.
Ключевые возможности
01Поддерживает различные типы поиска: текст, изображения, видео, новости и книги
022,026 звезд на GitHub
03Интегрируется с MCP для поиска с помощью ИИ
04Предлагает развертываемый API-сервер с поддержкой Docker
05Агрегирует результаты из нескольких поисковых систем (например, Bing, Google, DuckDuckGo, Yandex)
06Предоставляет библиотеку Python для легкой интеграции и использования
Варианты использования
01Создание приложений, требующих консолидированных результатов поиска из различных веб-источников
02Интеграция расширенных возможностей поиска в AI-агентов или ассистенты через MCP
03Автоматизация обнаружения веб-контента и сбора данных для исследований или анализа
A metasearch library that aggregates results from diverse web search services.
- API Server (with MCP Integration)
- Install
- CLI version
- Engines
- DDGS class
- 1. text()
- 2. images()
- 3. videos()
- 4. news()
- 5. books()
- Disclaimer
- Docker compose
git clone https://github.com/deedy5/ddgs && cd ddgs
docker-compose up --build- Bash
git clone https://github.com/deedy5/ddgs && cd ddgs
chmod +x start_api.sh
./start_api.sh- MCP Endpoints (for AI assistance):
http://localhost:8000/mcp- HTTP transporthttp://localhost:8000/sse- SSE transport
- API Docs:
http://localhost:8000/docs - Health Check:
http://localhost:8000/health
search_text- Web text searchessearch_images- Image searchessearch_news- News searchessearch_videos- Video searchessearch_books- Book searches
{
"mcpServers": {
"ddgs-search": {
"url": "http://localhost:8000/sse",
"disabled": false,
"alwaysAllow": []
}
}
}pip install -U ddgsddgs --help| DDGS function | Available backends |
|---|---|
| text() | bing, brave, duckduckgo, google, grokipedia, mojeek, yandex, yahoo, wikipedia |
| images() | duckduckgo |
| videos() | duckduckgo |
| news() | bing, duckduckgo, yahoo |
| books() | annasarchive |
DDGS class is lazy-loaded.
class DDGS:
"""Dux Distributed Global Search. A metasearch library that aggregates results from diverse web search services.
Args:
proxy (str, optional): proxy for the HTTP client, supports http/https/socks5 protocols.
example: "http://user:pass@example.com:3128". Defaults to None.
timeout (int, optional): Timeout value for the HTTP client. Defaults to 5.
verify: (bool | str): True to verify, False to skip, or a str path to a PEM file. Defaults to True.
"""Here is an example of initializing the DDGS class.
from ddgs import DDGS
results = DDGS().text("python programming", max_results=5)
print(results)def text(
query: str,
region: str = "us-en",
safesearch: str = "moderate",
timelimit: str | None = None,
max_results: int | None = 10,
page: int = 1,
backend: str = "auto",
) -> list[dict[str, str]]:
"""DDGS text metasearch.
Args:
query: text search query.
region: us-en, uk-en, ru-ru, etc. Defaults to us-en.
safesearch: on, moderate, off. Defaults to "moderate".
timelimit: d, w, m, y. Defaults to None.
max_results: maximum number of results. Defaults to 10.
page: page of results. Defaults to 1.
backend: A single or comma-delimited backends. Defaults to "auto".
Returns:
List of dictionaries with search results.
"""Example
results = DDGS().text('live free or die', region='us-en', safesearch='off', timelimit='y', page=1, backend="auto")
# Searching for pdf files
results = DDGS().text('russia filetype:pdf', region='us-en', safesearch='off', timelimit='y', page=1, backend="auto")
print(results)
[
{
"title": "News, sport, celebrities and gossip | The Sun",
"href": "https://www.thesun.co.uk/",
"body": "Get the latest news, exclusives, sport, celebrities, showbiz, politics, business and lifestyle from The Sun",
}, ...
]def images(
query: str,
region: str = "us-en",
safesearch: str = "moderate",
timelimit: str | None = None,
max_results: int | None = 10,
page: int = 1,
backend: str = "auto",
size: str | None = None,
color: str | None = None,
type_image: str | None = None,
layout: str | None = None,
license_image: str | None = None,
) -> list[dict[str, str]]:
"""DDGS images metasearch.
Args:
query: images search query.
region: us-en, uk-en, ru-ru, etc. Defaults to us-en.
safesearch: on, moderate, off. Defaults to "moderate".
timelimit: d, w, m, y. Defaults to None.
max_results: maximum number of results. Defaults to 10.
page: page of results. Defaults to 1.
backend: A single or comma-delimited backends. Defaults to "auto".
size: Small, Medium, Large, Wallpaper. Defaults to None.
color: color, Monochrome, Red, Orange, Yellow, Green, Blue,
Purple, Pink, Brown, Black, Gray, Teal, White. Defaults to None.
type_image: photo, clipart, gif, transparent, line.
Defaults to None.
layout: Square, Tall, Wide. Defaults to None.
license_image: any (All Creative Commons), Public (PublicDomain),
Share (Free to Share and Use), ShareCommercially (Free to Share and Use Commercially),
Modify (Free to Modify, Share, and Use), ModifyCommercially (Free to Modify, Share, and
Use Commercially). Defaults to None.
Returns:
List of dictionaries with images search results.
"""Example
results = DDGS().images(
query="butterfly",
region="us-en",
safesearch="off",
timelimit="m",
page=1,
backend="auto",
size=None,
color="Monochrome",
type_image=None,
layout=None,
license_image=None,
)
print(images)
[
{
"title": "File:The Sun by the Atmospheric Imaging Assembly of NASA's Solar ...",
"image": "https://upload.wikimedia.org/wikipedia/commons/b/b4/The_Sun_by_the_Atmospheric_Imaging_Assembly_of_NASA's_Solar_Dynamics_Observatory_-_20100819.jpg",
"thumbnail": "https://tse4.mm.bing.net/th?id=OIP.lNgpqGl16U0ft3rS8TdFcgEsEe&pid=Api",
"url": "https://en.wikipedia.org/wiki/File:The_Sun_by_the_Atmospheric_Imaging_Assembly_of_NASA's_Solar_Dynamics_Observatory_-_20100819.jpg",
"height": 3860,
"width": 4044,
"source": "Bing",
}, ...
]def videos(
query: str,
region: str = "us-en",
safesearch: str = "moderate",
timelimit: str | None = None,
max_results: int | None = 10,
page: int = 1,
backend: str = "auto",
resolution: str | None = None,
duration: str | None = None,
license_videos: str | None = None,
) -> list[dict[str, str]]:
"""DDGS videos metasearch.
Args:
query: videos search query.
region: us-en, uk-en, ru-ru, etc. Defaults to us-en.
safesearch: on, moderate, off. Defaults to "moderate".
timelimit: d, w, m. Defaults to None.
max_results: maximum number of results. Defaults to 10.
page: page of results. Defaults to 1.
backend: A single or comma-delimited backends. Defaults to "auto".
resolution: high, standart. Defaults to None.
duration: short, medium, long. Defaults to None.
license_videos: creativeCommon, youtube. Defaults to None.
Returns:
List of dictionaries with videos search results.
"""Example
results = DDGS().videos(
query="cars",
region="us-en",
safesearch="off",
timelimit="w",
page=1,
backend="auto",
resolution="high",
duration="medium",
)
print(results)
[
{
"content": "https://www.youtube.com/watch?v=6901-C73P3g",
"description": "Watch the Best Scenes of popular Tamil Serial #Meena that airs on Sun TV. Watch all Sun TV serials immediately after the TV telecast on Sun NXT app. *Free for Indian Users only Download here: Android - http://bit.ly/SunNxtAdroid iOS: India - http://bit.ly/sunNXT Watch on the web - https://www.sunnxt.com/ Two close friends, Chidambaram ...",
"duration": "8:22",
"embed_html": '<iframe width="1280" height="720" src="https://www.youtube.com/embed/6901-C73P3g?autoplay=1" frameborder="0" allowfullscreen></iframe>',
"embed_url": "https://www.youtube.com/embed/6901-C73P3g?autoplay=1",
"image_token": "6c070b5f0e24e5972e360d02ddeb69856202f97718ea6c5d5710e4e472310fa3",
"images": {
"large": "https://tse4.mm.bing.net/th?id=OVF.JWBFKm1u%2fHd%2bz2e1GitsQw&pid=Api",
"medium": "https://tse4.mm.bing.net/th?id=OVF.JWBFKm1u%2fHd%2bz2e1GitsQw&pid=Api",
"motion": "",
"small": "https://tse4.mm.bing.net/th?id=OVF.JWBFKm1u%2fHd%2bz2e1GitsQw&pid=Api",
},
"provider": "Bing",
"published": "2024-07-03T05:30:03.0000000",
"publisher": "YouTube",
"statistics": {"viewCount": 29059},
"title": "Meena - Best Scenes | 02 July 2024 | Tamil Serial | Sun TV",
"uploader": "Sun TV",
}, ...
]def news(
query: str,
region: str = "us-en",
safesearch: str = "moderate",
timelimit: str | None = None,
max_results: int | None = 10,
page: int = 1,
backend: str = "auto",
) -> list[dict[str, str]]:
"""DDGS news metasearch.
Args:
query: news search query.
region: us-en, uk-en, ru-ru, etc. Defaults to us-en.
safesearch: on, moderate, off. Defaults to "moderate".
timelimit: d, w, m. Defaults to None.
max_results: maximum number of results. Defaults to 10.
page: page of results. Defaults to 1.
backend: A single or comma-delimited backends. Defaults to "auto".
Returns:
List of dictionaries with news search results.
"""Example
results = DDGS().news(query="sun", region="us-en", safesearch="off", timelimit="m", page=1, backend="auto")
print(results)
[
{
"date": "2024-07-03T16:25:22+00:00",
"title": "Murdoch's Sun Endorses Starmer's Labour Day Before UK Vote",
"body": "Rupert Murdoch's Sun newspaper endorsed Keir Starmer and his opposition Labour Party to win the UK general election, a dramatic move in the British media landscape that illustrates the country's shifting political sands.",
"url": "https://www.msn.com/en-us/money/other/murdoch-s-sun-endorses-starmer-s-labour-day-before-uk-vote/ar-BB1plQwl",
"image": "https://img-s-msn-com.akamaized.net/tenant/amp/entityid/BB1plZil.img?w=2000&h=1333&m=4&q=79",
"source": "Bloomberg on MSN.com",
}, ...
]def books(
query: str,
max_results: int | None = 10,
page: int = 1,
backend: str = "auto",
) -> list[dict[str, str]]:
"""DDGS books metasearch.
Args:
query: news search query.
max_results: maximum number of results. Defaults to 10.
page: page of results. Defaults to 1.
backend: A single or comma-delimited backends. Defaults to "auto".
Returns:
List of dictionaries with news search results.
"""Example
results = DDGS().books(query="sea wolf jack london", page=1, backend="auto")
print(results)
[
{
'title': 'The Sea-Wolf',
'author': 'Jack London',
'publisher': 'DigiCat, 2022',
'info': 'English [en], .epub, 🚀/zlib, 0.5MB, 📗 Book (unknown)',
'url': 'https://annas-archive.li/md5/574f6556f1df6717de4044e36c7c2782',
'thumbnail': 'https://s3proxy.cdn-zlib.sk//covers299/collections/userbooks/da4954486be7c2b2b9f70b2aa5bcf01292de3ea510b5656f892821950ded9ada.jpg',
}, ...
]This library is for educational purposes only.
DDGS — Dux Distributed Global Search
DDGS — это метапоисковая библиотека на Python, которая агрегирует результаты из различных веб-поисковых сервисов (Bing, Brave, DuckDuckGo, Google, Yandex, Yahoo и других). Помимо текстового поиска, поддерживает поиск изображений, видео, новостей и книг. Библиотека предоставляет как программный интерфейс (класс DDGS), так и готовый API-сервер с интеграцией MCP (Model Context Protocol) для использования в AI-агентах.
Установка
pip install -U ddgs
Быстрый старт (Python)
from ddgs import DDGS
results = DDGS().text("python programming", max_results=5)
print(results)
API-сервер с MCP
Запуск через Docker Compose
git clone https://github.com/deedy5/ddgs && cd ddgs
docker-compose up --build
Запуск через Bash
git clone https://github.com/deedy5/ddgs && cd ddgs
chmod +x start_api.sh
./start_api.sh
Доступные эндпоинты
- MCP (HTTP):
http://localhost:8000/mcp - MCP (SSE):
http://localhost:8000/sse - Документация API:
http://localhost:8000/docs - Health Check:
http://localhost:8000/health
MCP-инструменты
search_text— текстовый поискsearch_images— поиск изображенийsearch_news— поиск новостейsearch_videos— поиск видеоsearch_books— поиск книг
Типовая конфигурация MCP-клиента
{
"mcpServers": {
"ddgs-search": {
"url": "http://localhost:8000/sse",
"disabled": false,
"alwaysAllow": []
}
}
}
CLI-версия
ddgs --help
Доступные поисковые движки
| Функция | Поддерживаемые бэкенды |
|---|---|
text() |
bing, brave, duckduckgo, google, grokipedia, mojeek, yandex, yahoo, wikipedia |
images() |
duckduckgo |
videos() |
duckduckgo |
news() |
bing, duckduckgo, yahoo |
books() |
annasarchive |
Класс DDGS
Класс загружается лениво (lazy-loaded).
Параметры конструктора:
proxy(str, опционально) — прокси для HTTP-клиента (http/https/socks5). Пример:"http://user:pass@example.com:3128".timeout(int, опционально) — таймаут HTTP-клиента. По умолчанию 5.verify(bool | str) —Trueдля проверки SSL,Falseдля пропуска, или путь к PEM-файлу. По умолчаниюTrue.
1. text() — текстовый поиск
def text(
query: str,
region: str = "us-en",
safesearch: str = "moderate",
timelimit: str | None = None,
max_results: int | None = 10,
page: int = 1,
backend: str = "auto",
) -> list[dict[str, str]]:
Параметры:
region— регион:us-en,uk-en,ru-ruи т.д.safesearch— уровень безопасного поиска:on,moderate,off.timelimit— ограничение по времени:d(день),w(неделя),m(месяц),y(год).max_results— максимальное количество результатов (по умолчанию 10).page— номер страницы результатов.backend— один или несколько бэкендов через запятую, или"auto".
Пример:
results = DDGS().text('live free or die', region='us-en', safesearch='off', timelimit='y', page=1, backend="auto")
# Поиск PDF-файлов
results = DDGS().text('russia filetype:pdf', region='us-en', safesearch='off', timelimit='y', page=1, backend="auto")
print(results)
2. images() — поиск изображений
def images(
query: str,
region: str = "us-en",
safesearch: str = "moderate",
timelimit: str | None = None,
max_results: int | None = 10,
page: int = 1,
backend: str = "auto",
size: str | None = None,
color: str | None = None,
type_image: str | None = None,
layout: str | None = None,
license_image: str | None = None,
) -> list[dict[str, str]]:
Дополнительные параметры:
size— размер:Small,Medium,Large,Wallpaper.color— цвет:color,Monochrome,Red,Orange,Yellow,Green,Blue,Purple,Pink,Brown,Black,Gray,Teal,White.type_image— тип:photo,clipart,gif,transparent,line.layout— макет:Square,Tall,Wide.license_image— лицензия:any(All Creative Commons),Public(Public Domain),Share(Free to Share and Use),ShareCommercially(Free to Share and Use Commercially),Modify(Free to Modify, Share, and Use),ModifyCommercially(Free to Modify, Share, and Use Commercially).
Пример:
results = DDGS().images(
query="butterfly",
region="us-en",
safesearch="off",
timelimit="m",
page=1,
backend="auto",
size=None,
color="Monochrome",
type_image=None,
layout=None,
license_image=None,
)
print(results)
3. videos() — поиск видео
def videos(
query: str,
region: str = "us-en",
safesearch: str = "moderate",
timelimit: str | None = None,
max_results: int | None = 10,
page: int = 1,
backend: str = "auto",
resolution: str | None = None,
duration: str | None = None,
license_videos: str | None = None,
) -> list[dict[str, str]]:
Дополнительные параметры:
resolution— разрешение:high,standart.duration— длительность:short,medium,long.license_videos— лицензия:creativeCommon,youtube.
Пример:
results = DDGS().videos(
query="cars",
region="us-en",
safesearch="off",
timelimit="w",
page=1,
backend="auto",
resolution="high",
duration="medium",
)
print(results)
4. news() — поиск новостей
def news(
query: str,
region: str = "us-en",
safesearch: str = "moderate",
timelimit: str | None = None,
max_results: int | None = 10,
page: int = 1,
backend: str = "auto",
) -> list[dict[str, str]]:
Пример:
results = DDGS().news(query="sun", region="us-en", safesearch="off", timelimit="m", page=1, backend="auto")
print(results)
5. books() — поиск книг
def books(
query: str,
max_results: int | None = 10,
page: int = 1,
backend: str = "auto",
) -> list[dict[str, str]]:
Пример:
results = DDGS().books(query="sea wolf jack london", page=1, backend="auto")
print(results)
Предупреждение
Данная библиотека предназначена только для образовательных целей.
Релизы и дополнительная информация: GitHub Releases, PyPI
Какие типы поиска может выполнять DDGS?
DDGS поддерживает широкий спектр типов поиска, позволяя пользователям искать текст, изображения, видео, новости и книги. Для каждого типа контента используются разные поисковые системы.
Что такое DDGS (Dux Distributed Global Search)?
DDGS — это комплексная метапоисковая библиотека и API, предназначенная для агрегации результатов поиска из различных веб-сервисов, включая популярные поисковики, такие как Google, Bing, DuckDuckGo и Yandex, в единый унифицированный интерфейс.
Как интегрировать DDGS в моё приложение?
DDGS предоставляет удобную библиотеку для Python для прямой интеграции (`pip install ddgs`). Для более масштабных развёртываний или доступа через API предлагается развёртываемый API-сервер с поддержкой Docker, что обеспечивает гибкость для различных потребностей разработки.
Поддерживает ли DDGS функции поиска с помощью ИИ?
Да, DDGS интегрируется с MCP (Modular Chat Protocol) для предоставления расширенных возможностей поиска с помощью ИИ. Эта интеграция улучшает поиск, обеспечивая более интеллектуальные и точные результаты через API-сервер.
Из каких поисковых систем DDGS агрегирует результаты?
DDGS агрегирует результаты из множества поисковых систем, включая, но не ограничиваясь: Bing, Google, DuckDuckGo, Yandex, Yahoo, Wikipedia, Brave, Grokipedia, Mojeek и Annasarchive, в зависимости от используемой функции поиска.
Источник: https://mcpmarket.com/server/ddgs-1
Комментарии
Комментариев пока нет. Будьте первым.