Pesquisa-web-offline: Uma Alternativa Local ao Google Search para Agentes de IA

O Que É Isso

offline-web-search é uma alternativa totalmente local ao Google Search projetada especificamente para agentes de IA que precisam de capacidades de busca web offline. Foi criado como uma substituição direta para as ferramentas web do Claude, permitindo que LLMs o usem sem prompts complexos.

Problema Central Resolvido

O desenvolvedor identificou que as soluções de busca offline existentes para agentes de IA têm limitações significativas. A maioria das ferramentas despeja arquivos HTML brutos na janela de contexto ou tem funcionalidade de busca básica que impede os agentes de encontrar documentação específica. Isso é particularmente problemático em ambientes isolados, ao lidar com dados sensíveis ou ao construir stacks totalmente locais.

Principais Características Técnicas

• Comportamento do Mecanismo de Busca: Em vez de despejos de texto, ele indexa o conteúdo em um banco de dados SQLite FTS5 local usando classificação BM25, reforço de título, expansão de sinônimos, correspondência de prefixo e rebaixamento de idiomas não ingleses.
• Fontes de Conteúdo: Suporta nativamente arquivos ZIM do Kiwix (contendo capturas offline do Stack Overflow, documentação do Python, DevDocs, Wikipedia) e inclui uma API de indexação e um rastreador para conteúdo personalizado como Confluence interno, documentos da empresa ou páginas HTML aleatórias.
• Arquitetura: Usa um modelo cliente-servidor com uma API HTTP. O servidor de conteúdo "pesado" roda centralmente em sua rede, enquanto clientes leves se conectam via servidor MCP para o Claude Desktop ou habilidade nativa do Claude Code.
• Ferramentas Expostas: Fornece duas ferramentas padrão: Google Search para busca classificada BM25 e visit_page para retornar Markdown limpo de páginas completas.

Como Funciona

A ferramenta foi construída por engenharia reversa das ferramentas Web-Fetch e Web-Search do Claude, seus prompts de sistema e funcionalidade. Os resultados da busca fornecem snippets altamente relevantes e classificados para o LLM, que pode então usar a ferramenta visit_page para acessar versões limpas e legíveis em Markdown de páginas completas.

Para Quem É

Desenvolvedores que constroem agentes de IA offline ou configurações fortemente locais que precisam de capacidades de busca confiáveis sem acesso à internet.