Ir al contenido

Searchgirl

El buscador de la suite. By SearXNG.

Searchgirl es la búsqueda privada de la familia Escriba: metabúsqueda con cuatro caras en un solo binario — una interfaz web, una API REST, un servidor MCP para agentes y LLMs, y un modo opcional de Respuesta IA que sintetiza respuestas con citas. Sin rastreo, sin perfiles: los motores ven tu servidor, nunca a ti.

Searchgirl es una capa de valor encima de SearXNG, el metabuscador open source que agrega resultados de decenas de motores. SearXNG se ejecuta como su contenedor oficial sin modificar, interno y nunca expuesto; Searchgirl lo consume por HTTP y le suma la API normalizada, el servidor MCP, la interfaz de la familia Escriba y la síntesis con LLM. No es un fork — mira la Licencia.

  • Cualquiera que quiera búsqueda privada — los resultados agregados de decenas de motores, con los motores viendo tu servidor en lugar de a ti, y miniaturas proxificadas para que tu navegador nunca toque sus hosts.
  • Constructores de agentes que le dan a Claude Code, Claude Desktop o cualquier cliente MCP búsqueda web en vivo, lectura de URLs y respuestas con citas a través de un único endpoint /mcp.
  • Desarrolladores y automatizadores que quieren una forma JSON normalizada y estable (deduplicación por URL, puntajes, dominios, fechas ISO) en lugar de raspar las respuestas crudas de los motores.
  • Self-hosters de la suite que quieren que la búsqueda comparta el inicio de sesión único de Lockatus y entregue a los agentes tokens Bearer con nombre, revocables individualmente.

Cuatro caras, un binario

Interfaz web, API REST, servidor MCP y respuestas IA opcionales — todo servido por un único binario Go, en el puerto 8089 en el compose estándar.

Metabúsqueda privada

El contenedor oficial de SearXNG se ejecuta interno y sin exponer, agregando decenas de motores. Sin rastreo, sin perfiles: los motores ven tu servidor, nunca a ti.

Una interfaz web limpia

Resultados por categoría (General, Noticias, Imágenes, Videos, Ciencia, IT), filtros de idioma/fecha/SafeSearch, respuestas directas e infoboxes, tema claro y oscuro. Las miniaturas pasan por el proxy propio de Searchgirl.

API REST normalizada

GET /api/search más sugerencias y un catálogo de motores, devolviendo una forma estable — deduplicación por URL, puntaje, dominio, fechas ISO — independiente del JSON crudo de SearXNG.

MCP para agentes

Herramientas search, url_read y answer por HTTP streamable en /mcp. Un comando lo agrega a Claude Code; el mismo binario también habla MCP por stdio.

Respuesta IA con citas

Opcional y apagada por defecto: busca, lee las mejores fuentes y escribe una respuesta corta citando [1][2], con la lista de fuentes al pie. Anthropic nativo o cualquier endpoint compatible con OpenAI (Ollama, OpenRouter, DeepSeek).

URL a Markdown

POST /api/read (y la herramienta MCP url_read) descarga cualquier URL pública y la devuelve como Markdown, detrás de una protección SSRF.

Fail-safe por defecto

El compose publica el puerto solo en 127.0.0.1; el binario suelto se niega a servir sin autenticación en una interfaz pública. El límite de tasa por IP cubre API, MCP y login.

Standalone o federada

Un login local de un usuario (la pantalla estándar de Escriba) o inicio de sesión único OIDC a través de Lockatus. Los tokens Bearer con nombre para agentes se combinan con cualquiera de los dos — revocar uno no rota el resto.

Instalar Searchgirl Ver en GitHub