mcp-searxng MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Dos herramientas: searchxng_web_search y web_url_read
Filtros de búsqueda: paginación, rango de tiempo, idioma, búsqueda segura
web_url_read devuelve Markdown limpio con filtrado de encabezados/párrafos
Funciona con instancias SearXNG públicas o autohospedadas a través de SEARXNG_URL
Transporte HTTP a través de MCP_HTTP_PORT, más STDIO predeterminado

Demo en vivo

Cómo se ve en la práctica

searxng.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "searxng": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "searxng",
      "command": "npx",
      "args": [
        "-y",
        "mcp-searxng"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "searxng": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-searxng"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add searxng -- npx -y mcp-searxng

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: mcp-searxng

Ofrezca su búsqueda web privada de IA a través de SearXNG autohospedado

👤 Desarrolladores preocupados por la privacidad y autohospedadores ⏱ ~10 min intermediate

Cuándo usarlo: No desea que Tavily/Brave/Google vea todas las consultas de IA.

Requisitos previos

Una instancia de SearXNG — docker run -p 8080:8080 searchxng/searxng (consulte los documentos para la configuración)
SEARXNG_URL var de entorno — Establezca en http://localhost:8080 o su instancia remota

Flujo

Buscar

Buscar: 'especificación del protocolo mcp 2026'. Rango de tiempo últimos 3 meses.✓ Copiado

→ Lista de resultados
Leer el resultado superior

web_url_read en el resultado superior: dame los títulos y los primeros 5 párrafos.✓ Copiado

→ Extracto de rebajas
Hacer un seguimiento

Según esa página, ¿cuál es el cambio más importante en la especificación?✓ Copiado

→ respuesta fundamentada

Resultado: Ciclo de investigación completo sin exposición de claves de terceros.

Errores comunes

La tasa de instancia de SearXNG limita o falla debido a que el motor ascendente la bloquea — Gire los motores en la configuración de SearXNG; considere ejecutar varias instancias
SearXNG autohospedado necesita actualizaciones periódicas a medida que cambian los motores — Fijar etiqueta de imagen y actualizar mensualmente

Combinar con: filesystem

Verifique los hechos de un reclamo con múltiples fuentes

👤 Escritores, analistas ⏱ ~10 min beginner

Cuándo usarlo: Necesita confirmar algo a través de algunas fuentes independientes.

Flujo

Buscar

Busque la frase de reclamo exacta. Devuelve el top 10 de diferentes dominios.✓ Copiado

→ Lista de resultados diversa
lectura cruzada

web_url_read sobre los 3 más autorizados: cite las secciones que abordan el reclamo.✓ Copiado

→ Extractos citados
Veredicto

Afirmación: ¿apoyada, impugnada o falsa? Cite específicamente.✓ Copiado

→ Veredicto con citaciones

Resultado: Una verificación de hechos citada.

Cree un asistente de investigación sin clave API para su equipo

👤 Equipos que no quieren o no pueden comprar claves API de búsqueda ⏱ ~40 min intermediate

Cuándo usarlo: Todo el mundo quiere una búsqueda con IA, pero nadie quiere gestionar las claves de Tavily por persona.

Flujo

Run SearXNG behind your intranet

Set up SearXNG container on the team server, point mcp-searxng at it.✓ Copiado

→ All team AI clients search via shared instance
Test from multiple clients

Run the same query from Claude Desktop and Cursor — both should hit the same SearXNG.✓ Copiado

→ Consistent results

Resultado: Team-wide AI search with one instance, no per-user billing.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

searxng + filesystem

Research and save notes

Search 'SBOM best practices', web_url_read the top 3, save a distilled memo to ./notes/sbom.md.✓ Copiado

searxng + kindly-web-search

Stack both — kindly for platform-aware full fetches, searxng for private general search

Use searxng for the initial search; if any result is SO/GitHub, fall back to kindly for richer content.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
searxng_web_search	query: str, pageno?: int, time_range?: day\|week\|month\|year, language?: str, safesearch?: 0\|1\|2	Any web search	free (your SearXNG)
web_url_read	url: str, start_heading?: int, end_heading?: int, start_paragraph?: int, end_paragraph?: int	Clean extraction of an article	free

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Unlimited (your SearXNG instance)
Tokens por llamada: Search: 500-1500 tokens. Read: 1-10k depending on page.
Monetario: Free
Consejo: Narrow queries with time_range and language — cuts both tokens and SearXNG load.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: No keys needed; just SEARXNG_URL

Salida de datos: Your SearXNG instance (which in turn queries upstream engines)

Public SearXNG instances can be monitored by their operators — host your own for real privacy.
Extracted content reflects the live page — verify for critical decisions.

Resolución de problemas

Errores comunes y soluciones

Connection refused

SearXNG not running or SEARXNG_URL wrong. curl the URL directly first.

Verificar: curl $SEARXNG_URL

Empty results for any query

SearXNG blocked by upstream engines or misconfigured. Check /search directly in browser.

Verificar: Open $SEARXNG_URL/search?q=test

web_url_read returns mostly nav junk

Some sites are JS-heavy; narrow with heading/paragraph ranges, or use a different extractor.

Alternativas

mcp-searxng vs otros

Alternativa	Cuándo usarla	Contrapartida
omnisearch	You want multi-provider + AI search	Requires provider API keys
kindly-web-search	You want platform-aware full content	Still needs Serper/Tavily key unless paired with SearXNG
brave-search	You're OK with one commercial provider	Paid above the free tier

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills