Quatro faces, um binário
Interface web, API REST, servidor MCP e respostas de IA opcionais — tudo servido por um único binário Go, na porta 8089 no compose padrão.
Searchgirl
O buscador da suíte. By SearXNG.
O Searchgirl é a busca privada da família Escriba: metabusca com quatro faces em um único binário — uma interface web, uma API REST, um servidor MCP para agentes e LLMs, e um modo opcional de Resposta de IA que sintetiza respostas com citações. Sem rastreamento, sem perfis: os motores veem o seu servidor, nunca você.
O Searchgirl é uma camada de valor sobre o SearXNG, o metabuscador de código aberto que agrega resultados de dezenas de motores. O SearXNG roda como seu container oficial sem modificações, interno e nunca exposto; o Searchgirl o consome via HTTP e adiciona a API normalizada, o servidor MCP, a interface da família Escriba e a síntese via LLM. Não é um fork — veja Licença.
Para quem é
Seção intitulada “Para quem é”- Qualquer pessoa que queira busca privada — os resultados agregados de dezenas de motores, com os motores vendo o seu servidor em vez de você, e miniaturas passando por um proxy para que seu navegador nunca toque os hosts deles.
- Construtores de agentes que dão ao Claude Code, ao Claude Desktop ou a qualquer cliente MCP busca web ao vivo, leitura de URLs e respostas com citações através de um único endpoint
/mcp. - Desenvolvedores e automatizadores que querem um formato JSON normalizado e estável (dedup por URL, scores, domínios, datas ISO) em vez de raspar as respostas cruas dos motores.
- Self-hosters da suíte que querem que a busca compartilhe o single sign-on do Lockatus e entregue aos agentes tokens Bearer nomeados e revogáveis individualmente.
Recursos principais
Seção intitulada “Recursos principais”Metabusca privada
O container oficial do SearXNG roda interno e não exposto, agregando dezenas de motores. Sem rastreamento, sem perfis: os motores veem o seu servidor, nunca você.
Uma interface web limpa
Resultados por categoria (Geral, Notícias, Imagens, Vídeos, Ciência, TI), filtros de idioma/data/SafeSearch, respostas diretas e infoboxes, tema claro e escuro. As miniaturas passam pelo proxy próprio do Searchgirl.
API REST normalizada
GET /api/search mais sugestões e um catálogo de motores, retornando um formato estável — dedup por URL, score, domínio, datas ISO — independente do JSON cru do SearXNG.
MCP para agentes
Ferramentas search, url_read e answer via HTTP streamable em /mcp. Um comando o adiciona ao Claude Code; o mesmo binário também fala MCP via stdio.
Resposta de IA com citações
Opcional e desativada por padrão: busca, lê as melhores fontes e escreve uma resposta curta citando [1][2], com a lista de fontes no rodapé. Anthropic nativo ou qualquer endpoint compatível com OpenAI (Ollama, OpenRouter, DeepSeek).
URL para Markdown
POST /api/read (e a ferramenta MCP url_read) busca qualquer URL pública e a retorna como Markdown, atrás de uma proteção contra SSRF.
Fail-safe por padrão
O compose publica a porta apenas em 127.0.0.1; o binário puro se recusa a servir sem autenticação em uma interface pública. Rate limiting por IP cobre API, MCP e login.
Standalone ou federado
Um login local de um usuário (a tela padrão do Escriba) ou single sign-on OIDC via Lockatus. Tokens Bearer nomeados para agentes se combinam com qualquer um dos dois — revogar um não rotaciona os demais.