search-boost-mcp

Servidor MCP de búsqueda web multi-motor para agentes de codificación. Una instalación CLI lo conecta a Cursor, Cursor CLI, Codex, Claude Code, Grok Build y Antigravity.

Familia search-boost

Proyecto	Para	Enlace
search-boost (este repo)	Cursor · Codex · Claude · Grok · Antigravity vía MCP	estás aquí
dsh-search-boost	Plugin de paquete DeepSeek Harness	GitHub · npm
pi-search-boost	Extensión de pi	GitHub · npm

Los motores de búsqueda están incluidos en lib/search/ (originalmente de dsh-search-boost): en la capa gratuita, Bing, DuckDuckGo, Yahoo y Exa-free se ejecutan en paralelo; la capa api añade Antigravity CLI (cuando está disponible) y cualquier motor Tavily / Brave / Exa con clave que configures (una clave es suficiente; se recomiendan las tres para una mejor fusión). También incluye: respaldo X/Twitter, obtención de páginas Jina y rondas de investigación profunda.

Documentación en chino → README_zh.md

Novedades en v0.1.4

• Capa api de un solo motor — el nivel api usa cualquiera de tavily/brave/exa que configures o habilites; no necesitas las tres claves.

• Enrutamiento por motor — enabledEngines opcional o enabled: false por motor en ~/.search-boost-keys.json.

• Mensajes de clave parcial — doctor, status, asistente de claves y fused_search advierten cuando menos de tres motores con clave están activos y recomiendan configurar los tres.

Novedades en v0.1.2

• Grupo de motores autocontenido en lib/search/: Bing + DuckDuckGo + Yahoo + Exa-free para búsqueda general; el mismo grupo impulsa el respaldo de x_search con consultas site:.

• Respaldo x_search antepone automáticamente site:x.com para búsqueda de dominio multi-motor, de modo que el modo de palabras clave funcione sin credenciales XAI.

• Sin dependencia externa de repositorio dsh o npm — la lógica del motor está incluida en este repositorio.

Instalación (recomendada)

Requiere Node ≥ 22.13.

npm install -g search-boost-mcp
search-boost setup          # interactive: keys → layer → agents
# or non-interactive:
search-boost install -y     # all detected agents

Reinicia cada agente después de la instalación para que MCP se recargue.

Comandos de una línea por agente

search-boost install -t cursor -y
search-boost install -t codex,claude -y --auto-allow
search-boost install -t grok -y --auto-allow
search-boost install -t antigravity --workspace --auto-allow -y

Vista previa sin escribir: search-boost install --dry-run -y

Verificar instalación

search-boost doctor          # health checks (offline, pass/warn/fail)
search-boost doctor --json   # machine-readable report for CI/scripts
search-boost status          # install dashboard (keys, layer, agents)

Códigos de salida: 0 correcto · 1 fallo (o advertencias con --strict) · 2 solo advertencias.

Opcional: search-boost doctor --probe añade prueba de búsqueda en vivo (necesita red; Fase 2).

Luego confirma en tu agente:

Si las herramientas aparecen pero las llamadas fallan, ejecuta search-boost serve en una terminal para ver errores de inicio.

Banderas de instalación (referencia rápida)

Para una incorporación completa (claves API + elección de capa), ejecuta search-boost setup o search-boost install sin -y.

Related MCP server: gemini-search-mcp

Lo que obtienes

También: recurso search-boost://policy · prompt search_routing

Capas

• free — Bing + DuckDuckGo + Yahoo + Exa-free; sin claves API.

• api — motores de la capa gratuita más Antigravity CLI (cuando está disponible) y cualquier Tavily / Brave / Exa que configures (una clave funciona; se recomiendan las tres para la mejor fusión entre motores)

Claves: search-boost config keys → ~/.search-boost-keys.json (el legado ~/.dsh-search-boost-keys.json aún se lee; o las variables de entorno TAVILY_API_KEY, BRAVE_API_KEY, EXA_API_KEY). Enrutamiento opcional: enabledEngines: ["exa"] o "engines": { "brave": { "enabled": false } } en el archivo de claves.

Obtén claves: Tavily · Brave Search API · Exa

Autenticación X/Twitter (opcional): mejora el x_search oficial cuando hay credenciales presentes. Se almacena en ~/.search-boost-xauth.json (el legado ~/.dsh-search-boost-xauth.json aún se lee) o mediante XAI_API_KEY / Grok /x-login. Sobrescribe la ruta del archivo: SEARCH_BOOST_XAUTH_FILE.

Sobrescrituras de archivos de configuración: SEARCH_BOOST_KEYS_FILE, SEARCH_BOOST_LAYER_FILE, SEARCH_BOOST_XAUTH_FILE (variables de entorno opcionales que apuntan a rutas personalizadas).

Hoja de referencia CLI

Banderas de instalación: -t cursor,codex,…|auto|all · -y (no interactivo; implica --auto-allow + --replace-native) · --dry-run · --auto-allow (pre-aprueba herramientas MCP — ver tabla arriba) · --replace-native / --keep-native · --scope user|project (Grok) · --workspace (Antigravity .agents/)

Agentes compatibles

Los prompts usan redacción a discreción del modelo (busca cuando elijas, no forzado en cada turno). Consulta agents/ para plantillas por agente.

Búsqueda web nativa: Codex web_search y Claude WebSearch se pueden deshabilitar con --replace-native (predeterminado cuando no es interactivo). Cursor / Antigravity dependen solo de la preferencia de skill y hook. La navegación nativa de Grok se deja activada.

Antigravedad + agy CLI: En la capa api, el motor CLI opcional de Antigravedad (agy en PATH) se une solo a los niveles de búsqueda medio y complejo fused_search, no a búsquedas simples. Depende del inicio de sesión local y de la cuota de la plataforma; los tiempos de espera son de ~45s.

Plugin Grok

El plugin se envía dentro del paquete npm (MCP mediante npx portátil, más habilidad).

La reinstalación es idempotente: search-boost install -t grok elimina cualquier bloque [permission] anterior de search-boost (marcado o heredado) antes de escribir uno nuevo, por lo que las claves duplicadas [permission] no pueden romper el inicio de grok. Si [ui] permission_mode = "always-approve" ya está configurado, --auto-allow omite la inyección de [permission] (always-approve aprueba las herramientas MCP globalmente). search-boost doctor advierte sobre bloques de permisos duplicados o redundantes.

Desde un clon de git (raíz del repositorio):

grok plugin install ./grok-plugin --trust
search-boost install -t grok -y --auto-allow

Después de npm install -g search-boost-mcp (sin necesidad de clonar):

# bash / macOS / Linux
grok plugin install "$(npm root -g)/search-boost-mcp/grok-plugin" --trust

# Windows PowerShell
grok plugin install "$(npm root -g)\search-boost-mcp\grok-plugin" --trust

search-boost install -t grok -y --auto-allow

El .mcp.json empaquetado usa npx -y search-boost-mcp serve para que el plugin funcione en cualquier máquina con Node ≥ 22.13.

Detalles → grok-plugin/README.md

Solución de problemas

Desarrollo

git clone https://github.com/Mr-remon219/search-boost.git
cd search-boost && npm install
npm run check && npm run test:install && npm run smoke
node cli.mjs install --dry-run -y

Las instalaciones desde un clon local escriben node /path/to/cli.mjs serve (no npx). No se requiere un checkout hermano ni SEARCH_BOOST_DSH_ROOT.

Licencia

MIT

Enlaces: Issues · dsh-search-boost · pi-search-boost

Enlace amigable: LINUX DO 社区