Repolode
Enviar
deedy5

deedy5/ddgs

Biblioteca de metabusca em Python que consulta vários mecanismos de busca e retorna resultados unificados de texto, imagens, vídeos, notícias e livros.

Alternativa open source a:Google Custom Search API

Ver no GitHub
Estrelas
3,024
Forks
287
Issues abertas
33
Último commit
há 2 meses

O que é?

DDGS é uma biblioteca de metabusca em Python que envia uma consulta a vários serviços de busca na web e retorna os resultados em um formato comum. O método text() pode usar backends como Bing, Brave, DuckDuckGo, Google, Mojeek, Startpage, Yandex, Yahoo e Wikipedia, com o backend padrão definido como auto.

Além da busca por texto na web, a biblioteca oferece os métodos images(), videos(), news() e books(), além de extract(), que acessa uma URL e converte a página para Markdown, texto simples, rich text, HTML bruto ou bytes brutos. Os resultados são retornados como listas de dicionários, e as mesmas funções também estão disponíveis por uma interface de linha de comando.

Para integração, o DDGS inclui um servidor de API baseado em FastAPI, com endpoints para cada tipo de busca e para extração, além de um servidor MCP via stdio que expõe essas operações como ferramentas para clientes como Cursor ou Claude Desktop. As requisições podem ser encaminhadas por um proxy HTTP, HTTPS ou SOCKS5.

Recursos principais

  • 01Agrupa resultados de busca por texto de vários backends, como Bing, Brave, Google e DuckDuckGo.
  • 02Oferece métodos de busca por imagens, vídeos, notícias e livros, com filtros específicos para cada tipo.
  • 03Extrai o conteúdo de uma página a partir de uma URL como Markdown, texto simples, rich text, HTML ou bytes brutos.
  • 04Inclui uma CLI, um servidor de API FastAPI e um servidor MCP para clientes que usam ferramentas.
  • 05Oferece suporte a proxies HTTP, HTTPS e SOCKS5, além de timeouts configuráveis.

Casos de uso

  • Adicionar busca na web a um aplicativo Python ou agente de LLM sem depender de uma API de busca paga.
  • Disponibilizar busca e extração de páginas como ferramentas para assistentes de IA compatíveis com MCP.
  • Executar um endpoint de busca próprio para serviços internos usando o servidor de API pronto para Docker.
  • Coletar resultados de busca ou o texto de páginas pela linha de comando para usar em scripts.

Início rápido

  1. 1

    Instale o pacote básico com pip

    pip install -U ddgs
  2. 2

    Faça uma busca de texto pelo Python

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

Antes de usar

  • Os resultados vêm de serviços de busca de terceiros, portanto a disponibilidade e a qualidade dos resultados dependem desses serviços.

Tópicos

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

Perguntas frequentes

O que é ddgs?
Biblioteca de metabusca em Python que consulta vários mecanismos de busca e retorna resultados unificados de texto, imagens, vídeos, notícias e livros. DDGS é uma biblioteca de metabusca em Python que envia uma consulta a vários serviços de busca na web e retorna os resultados em um formato comum. O método text() pode usar backends como Bing, Brave, DuckDuckGo, Google, Mojeek, Startpage, Yandex, Yahoo e Wikipedia, com o backend padrão definido como auto.
ddgs é gratuito? Qual é a licença?
ddgs é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
ddgs ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de ddgs foi em 26 de ago. de 2026.
Para que posso usar ddgs?
Adicionar busca na web a um aplicativo Python ou agente de LLM sem depender de uma API de busca paga. Disponibilizar busca e extração de páginas como ferramentas para assistentes de IA compatíveis com MCP. Executar um endpoint de busca próprio para serviços internos usando o servidor de API pronto para Docker. Coletar resultados de busca ou o texto de páginas pela linha de comando para usar em scripts.
Como instalar ddgs?
Instale o pacote básico com pip: pip install -U ddgs Faça uma busca de texto pelo Python: python3 -c "from ddgs import DDGS; print(DDGS().text('python programming', max_results=5))"
Onde consigo ddgs?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/deedy5/ddgs

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados