Search Toolkit

Herramientas web con prioridad oficial para agentes de IA, con rotación persistente de múltiples claves y tres puntos de entrada: MCP, CLI y Agent Skills.

简体中文

Diseño

Search Toolkit conserva las capacidades específicas de cada proveedor en lugar de aplanar todos los backends en un único endpoint de búsqueda genérico.

• Proxy MCP remoto oficial: Exa, Tavily y LinkUp.

• Proxy MCP STDIO oficial: Firecrawl.

• Adaptadores ligeros de API oficial: Querit, Serper, Brave, Jina Search, TinyFish Search, Doubao Search y xAI Responses Web/X Search.

• Grupos de claves persistentes por proveedor respaldados por SQLite.

• Los nombres y esquemas de herramientas upstream con prefijo de proveedor se descubren desde los servidores MCP oficiales al inicio y luego se filtran mediante una política de herramientas de proveedor opcional.

• Las claves sin procesar permanecen fuera del repositorio en un archivo JSON local.

Las referencias oficiales utilizadas por la implementación incluyen Codex MCP configuration guide, MCP TypeScript SDK, Exa MCP, Tavily MCP, LinkUp MCP y Firecrawl MCP.

Capacidades de los proveedores

Instalación

git clone https://github.com/TheWiseWolfHolo/search-toolkit E:/Script/Services/search-toolkit
cd E:/Script/Services/search-toolkit
npm install
npm run build

Se requiere Node.js 22 o superior. Se recomienda Node.js 24 porque el almacén de rotación persistente utiliza el módulo integrado node:sqlite.

Configuración

Copia config.example.json a una ruta privada fuera del repositorio y reemplaza las claves de marcador de posición:

$env:SEARCH_TOOLKIT_CONFIG = "$HOME/.config/search-toolkit/providers.json"

El importador local de una sola vez puede migrar las claves de búsqueda de Kelivo configuradas a la configuración de texto independiente:

npm run import:kelivo

El importador lee Kelivo una vez y escribe %USERPROFILE%/.config/search-toolkit/providers.json en Windows. Esto evita la virtualización de MSIX AppData/Local, de modo que Codex, Claude Code y los procesos CLI ordinarios leen el mismo archivo físico. Los procesos MCP y CLI en tiempo de ejecución nunca acceden a Kelivo.

CLI

node dist/src/cli.js tools
node dist/src/cli.js status
node dist/src/cli.js call querit_search '{"query":"latest AI agent news","limit":5}'
node dist/src/cli.js probe querit "Search Toolkit rotation probe"

MCP

Compila primero y luego añade el servidor STDIO local a Codex:

[mcp_servers.searchToolkit]
command = "C:/path/to/node.exe"
args = ["E:/Script/Services/search-toolkit/dist/src/mcp-server.js", "--config", "C:/Users/you/.config/search-toolkit/providers.json"]
startup_timeout_sec = 30
tool_timeout_sec = 120
enabled = true
default_tools_approval_mode = "writes"

El servidor MCP expone:

• Herramientas upstream oficiales con prefijo de proveedor seleccionadas por la política de herramientas del proveedor. Firecrawl usa por defecto siete herramientas centradas en recuperación/adquisición en lugar de todo su catálogo de gestión.

• Toda herramienta de adaptador REST configurada.

• search_auto para enrutamiento predeterminado consciente de capacidades con metadatos auditables {provider, tool, upstreamTool}.

• search_pool_status para diagnósticos de grupos de claves enmascarados.

• search_rotation_probe para una prueba de rotación en vivo que consume cuota.

Establece toolPolicy.allow en ["*"] para un proveedor solo cuando exponer su catálogo upstream completo sea intencional. Las herramientas de escritura y destructivas conservan anotaciones corregidas para que los clientes puedan solicitar aprobación.

Rotación de claves

Cada solicitud selecciona una clave del grupo de claves del proveedor correspondiente. El cursor persiste entre reinicios del proceso y se coordina entre procesos de agente concurrentes a través de SQLite.

• 200: avanzar normalmente.

• 429 o 402: enfriar la clave actual.

• 401 o 403: deshabilitar la clave actual.

• 5xx o fallo de red: reintentar una vez con la siguiente clave.

• 400, 404 o 422: preservar el error de la solicitud sin culpar a otra clave.

providers.json, las claves sin procesar y el estado de rotación son ignorados por Git. La salida de comandos y los metadatos MCP muestran solo ranuras de claves enmascaradas.

Habilidad

La habilidad reutilizable está en skills/search-toolkit/. Cópiala o enlázala en el directorio de habilidades de tu agente. Enruta la investigación normal directamente a Search Toolkit y reserva la orquestación de investigación profunda para trabajos genuinamente de múltiples etapas.

Desarrollo

npm test
npm run smoke:mcp
npm pack --dry-run

Licencia

MIT