Repolode
Enviar
deedy5

deedy5/ddgs

Una biblioteca de metabúsqueda en Python que consulta varios motores y devuelve resultados unificados de texto, imágenes, videos, noticias y libros.

Alternativa open source a:Google Custom Search API

Ver en GitHub
Estrellas
3,024
Forks
287
Issues abiertos
33
Último commit
hace 2 meses

¿Qué es?

DDGS es una biblioteca de metabúsqueda en Python que envía una consulta a varios servicios de búsqueda web y devuelve los resultados en un formato común. Su método text() puede usar backends como Bing, Brave, DuckDuckGo, Google, Mojeek, Startpage, Yandex, Yahoo y Wikipedia; el backend predeterminado es auto.

Además de búsquedas de texto en la web, la biblioteca ofrece los métodos images(), videos(), news() y books(), además de extract(), que obtiene una URL y convierte la página a Markdown, texto sin formato, texto enriquecido, HTML sin procesar o bytes sin procesar. Los resultados se devuelven como listas de diccionarios, y las mismas funciones están disponibles mediante una interfaz de línea de comandos.

Para facilitar la integración, DDGS incluye un servidor API basado en FastAPI, con endpoints para cada tipo de búsqueda y para la extracción, y un servidor MCP sobre stdio que expone estas operaciones como herramientas para clientes como Cursor o Claude Desktop. Las solicitudes pueden enrutarse a través de un proxy HTTP, HTTPS o SOCKS5.

Funciones clave

  • 01Agrega resultados de búsqueda de texto de varios backends, como Bing, Brave, Google y DuckDuckGo.
  • 02Ofrece métodos de búsqueda de imágenes, videos, noticias y libros, con filtros específicos para cada tipo.
  • 03Extrae el contenido de una página desde una URL como Markdown, texto sin formato, texto enriquecido, HTML o bytes sin procesar.
  • 04Incluye una CLI, un servidor API basado en FastAPI y un servidor MCP para clientes que usan herramientas.
  • 05Admite proxies HTTP, HTTPS y SOCKS5, y tiempos de espera configurables.

Casos de uso

  • Añadir búsqueda web a una aplicación Python o a un agente LLM sin usar una API de búsqueda de pago.
  • Exponer la búsqueda y la extracción de páginas como herramientas para asistentes de IA compatibles con MCP.
  • Ejecutar un endpoint de búsqueda autohospedado para servicios internos mediante el servidor API preparado para Docker.
  • Recopilar resultados de búsqueda o texto de páginas desde la línea de comandos para usar en scripts.

Inicio rápido

  1. 1

    Instala el paquete base con pip

    pip install -U ddgs
  2. 2

    Realiza una búsqueda de texto desde Python

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

Antes de usarlo

  • Los resultados proceden de servicios de búsqueda de terceros, por lo que su disponibilidad y calidad dependen de esos servicios.

Temas

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

Preguntas frecuentes

¿Qué es ddgs?
Una biblioteca de metabúsqueda en Python que consulta varios motores y devuelve resultados unificados de texto, imágenes, videos, noticias y libros. DDGS es una biblioteca de metabúsqueda en Python que envía una consulta a varios servicios de búsqueda web y devuelve los resultados en un formato común. Su método text() puede usar backends como Bing, Brave, DuckDuckGo, Google, Mojeek, Startpage, Yandex, Yahoo y Wikipedia; el backend predeterminado es auto.
¿ddgs es gratuito? ¿Qué licencia tiene?
ddgs es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿ddgs sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de ddgs fue el 26 ago 2026.
¿Para qué puedo usar ddgs?
Añadir búsqueda web a una aplicación Python o a un agente LLM sin usar una API de búsqueda de pago. Exponer la búsqueda y la extracción de páginas como herramientas para asistentes de IA compatibles con MCP. Ejecutar un endpoint de búsqueda autohospedado para servicios internos mediante el servidor API preparado para Docker. Recopilar resultados de búsqueda o texto de páginas desde la línea de comandos para usar en scripts.
¿Cómo se instala ddgs?
Instala el paquete base con pip: pip install -U ddgs Realiza una búsqueda de texto desde Python: python3 -c "from ddgs import DDGS; print(DDGS().text('python programming', max_results=5))"
¿Dónde consigo ddgs?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/deedy5/ddgs

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados