Quattro volti, un solo binario
Interfaccia web, API REST, server MCP e risposte IA opzionali — tutto servito da un singolo binario Go, sulla porta 8089 nel compose standard.
Searchgirl
Il motore di ricerca della suite. By SearXNG.
Searchgirl è la ricerca privata della famiglia Escriba: metaricerca con quattro volti in un singolo binario — un’interfaccia web, un’API REST, un server MCP per agenti e LLM, e una modalità opzionale di Risposta IA che sintetizza risposte con citazioni. Nessun tracciamento, nessun profilo: i motori vedono il tuo server, mai te.
Searchgirl è un livello di valore sopra SearXNG, il motore di metaricerca open source che aggrega i risultati di decine di motori. SearXNG gira come container ufficiale non modificato, interno e mai esposto; Searchgirl lo consuma via HTTP e aggiunge l’API normalizzata, il server MCP, l’interfaccia della famiglia Escriba e la sintesi LLM. Non è un fork — vedi la Licenza.
A chi è destinato
Sezione intitolata “A chi è destinato”- Chiunque voglia una ricerca privata — i risultati aggregati di decine di motori, con i motori che vedono il tuo server invece di te, e le miniature servite tramite proxy così il tuo browser non tocca mai i loro host.
- Costruttori di agenti che danno a Claude Code, Claude Desktop o qualsiasi client MCP ricerca web in tempo reale, lettura di URL e risposte con citazioni attraverso un unico endpoint
/mcp. - Sviluppatori e automatori che vogliono una forma JSON normalizzata e stabile (deduplicazione per URL, punteggi, domini, date ISO) invece di fare scraping delle risposte grezze dei motori.
- Self-hoster della suite che vogliono che la ricerca condivida il single sign-on di Lockatus e consegni agli agenti token Bearer con nome, revocabili individualmente.
Caratteristiche principali
Sezione intitolata “Caratteristiche principali”Metaricerca privata
Il container ufficiale di SearXNG gira interno e non esposto, aggregando decine di motori. Nessun tracciamento, nessun profilo: i motori vedono il tuo server, mai te.
Un'interfaccia web pulita
Risultati per categoria (Generale, Notizie, Immagini, Video, Scienza, IT), filtri per lingua/data/SafeSearch, risposte dirette e infobox, tema chiaro e scuro. Le miniature passano attraverso il proxy proprio di Searchgirl.
API REST normalizzata
GET /api/search più suggerimenti e un catalogo dei motori, che restituisce una forma stabile — deduplicazione per URL, punteggio, dominio, date ISO — indipendente dal JSON grezzo di SearXNG.
MCP per gli agenti
Strumenti search, url_read e answer su HTTP streamable in /mcp. Un solo comando lo aggiunge a Claude Code; lo stesso binario parla MCP anche via stdio.
Risposta IA con citazioni
Opzionale e disattivata per impostazione predefinita: cerca, legge le fonti migliori e scrive una risposta breve citando [1][2], con l’elenco delle fonti in fondo. Anthropic nativo o qualsiasi endpoint compatibile OpenAI (Ollama, OpenRouter, DeepSeek).
Da URL a Markdown
POST /api/read (e lo strumento MCP url_read) recupera qualsiasi URL pubblico e lo restituisce come Markdown, dietro una protezione SSRF.
Fail-safe per impostazione predefinita
Il compose pubblica la porta solo su 127.0.0.1; il binario da solo si rifiuta di servire senza autenticazione su un’interfaccia pubblica. La limitazione di frequenza per IP copre API, MCP e login.
Standalone o federato
Un login locale mono-utente (la schermata standard di Escriba) oppure single sign-on OIDC tramite Lockatus. I token Bearer con nome per gli agenti si combinano con entrambi — revocarne uno non ruota gli altri.