Repolode
Enviar
fatwang2

fatwang2/search2ai

Gateway de busca self-hosted que oferece a agentes de IA busca unificada, notícias e extração de páginas via MCP, HTTP API ou biblioteca TypeScript, com fallback entre provedores.

Alternativa open source a:Tavily

Ver no GitHubSite
Estrelas
1,287
Forks
195
Issues abertas
18
Último commit
há 4 dias

O que é?

search2ai fica entre agentes de IA ou aplicações e vários serviços de busca e extração de páginas. Você configura os provedores para os quais tem credenciais, e o gateway retorna resultados em um formato consistente, com título, URL, trecho e campos opcionais de data ou conteúdo.

Cada operação (search, news, crawl) tem sua própria cadeia ordenada de provedores. Quando um provedor limita as requisições, excede o tempo limite ou falha, o gateway tenta o próximo e registra o motivo em um campo de avisos, para que os clientes saibam qual serviço respondeu. Os resultados podem ser armazenados em cache na memória ou no Cloudflare KV.

O projeto pode rodar como servidor MCP local para clientes como Claude Desktop ou Cursor, como serviço HTTP independente em Node.js, Docker ou Cloudflare Workers, como biblioteca importada em um processo Node ou como rotas Hono montadas em um app existente. Um proxy de chat opcional permite que clientes de chat com uma URL base personalizada compatível com OpenAI usem chamadas de ferramentas para fazer buscas enquanto respondem. As rotas de compatibilidade aceitam requisições no formato do Exa, Tavily, Search1API, SearXNG e do scrape de página única do Firecrawl.

Recursos principais

  • 01Interface unificada para busca, notícias e extração de páginas em vários provedores
  • 02Fallback automático entre provedores, com os motivos registrados nos avisos
  • 03Servidor MCP local ou remoto, HTTP API e biblioteca TypeScript
  • 04Cache em memória e no Cloudflare KV
  • 05Endpoints de compatibilidade para clientes Exa, Tavily, Search1API, SearXNG e Firecrawl

Casos de uso

  • Disponibilizar ferramentas de busca na web para Claude Desktop ou Cursor via MCP
  • Fornecer resultados de busca a um agente ou serviço de backend via REST
  • Migrar integrações existentes com os SDKs do Tavily ou Exa para um gateway self-hosted
  • Adicionar acesso à web a um cliente de chat que aceite uma URL base personalizada compatível com OpenAI

Início rápido

  1. 1

    Crie um arquivo .env com a chave do seu provedor de busca

  2. 2

    Inicie um serviço HTTP local

    npx -y search2ai serve --host 127.0.0.1
  3. 3

    Faça uma busca em outro terminal

    curl http://localhost:3014/v1/search -H 'Content-Type: application/json' -d '{"query":"hono cloudflare workers","max_results":3}'

Antes de usar

  • Para buscar, é necessário configurar pelo menos um provedor, e a maioria exige uma chave de API.
  • A CLI local e o pacote npm exigem Node.js 22.18 ou posterior.
  • Alguns provedores ignoram determinados filtros, como país, idioma ou intervalo de datas, sem acionar uma busca alternativa.

Em coleções

Frameworks e apps de agentes de IA open sourceServidores MCPApps auto-hospedados

Tópicos

#search#mcp#ai-agents#web-search#typescript#self-hosted#search-api#cloudflare-workers#hono#mcp-server

Perguntas frequentes

O que é search2ai?
Gateway de busca self-hosted que oferece a agentes de IA busca unificada, notícias e extração de páginas via MCP, HTTP API ou biblioteca TypeScript, com fallback entre provedores. search2ai fica entre agentes de IA ou aplicações e vários serviços de busca e extração de páginas. Você configura os provedores para os quais tem credenciais, e o gateway retorna resultados em um formato consistente, com título, URL, trecho e campos opcionais de data ou conteúdo.
search2ai é gratuito? Qual é a licença?
search2ai é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
search2ai ainda é mantido?
Manutenção ativa. O último commit de search2ai foi em 2 de nov. de 2026.
Para que posso usar search2ai?
Disponibilizar ferramentas de busca na web para Claude Desktop ou Cursor via MCP Fornecer resultados de busca a um agente ou serviço de backend via REST Migrar integrações existentes com os SDKs do Tavily ou Exa para um gateway self-hosted Adicionar acesso à web a um cliente de chat que aceite uma URL base personalizada compatível com OpenAI
Como instalar search2ai?
Crie um arquivo .env com a chave do seu provedor de busca Inicie um serviço HTTP local: npx -y search2ai serve --host 127.0.0.1 Faça uma busca em outro terminal: curl http://localhost:3014/v1/search -H 'Content-Type: application/json' -d '{"query":"hono cloudflare workers","max_results":3}'
Onde consigo search2ai?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/fatwang2/search2ai

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

Projetos relacionados