Search Toolkit

Webtools für KI-Agenten, die offizielle APIs bevorzugen, mit persistenter Multi-Key-Rotation und drei Einstiegspunkten: MCP, CLI und Agent Skills.

简体中文

Design

Search Toolkit bewahrt anbieterspezifische Fähigkeiten, anstatt jedes Backend auf einen generischen Such-Endpunkt zu reduzieren.

• Offizieller Remote-MCP-Proxy: Exa, Tavily und LinkUp.

• Offizieller STDIO-MCP-Proxy: Firecrawl.

• Schlanke Adapter für offizielle APIs: Querit, Serper, Brave, Jina Search, TinyFish Search, Doubao Search und xAI Responses Web/X Search.

• Persistente anbieterspezifische Schlüsselpools auf Basis von SQLite.

• Anbieterpräfixierte Upstream-Toolnamen und -Schemata werden beim Start von offiziellen MCP-Servern ermittelt und dann durch eine optionale Anbieter-Tool-Richtlinie gefiltert.

• Rohe Schlüssel bleiben außerhalb des Repositorys in einer lokalen JSON-Datei.

Offizielle Referenzen, die in der Implementierung verwendet werden, sind der Codex MCP-Konfigurationsleitfaden, das MCP TypeScript SDK, Exa MCP, Tavily MCP, LinkUp MCP und Firecrawl MCP.

Anbieterfunktionen

Installation

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

Node.js 22 oder neuer ist erforderlich. Node.js 24 wird empfohlen, da der persistente Rotationsspeicher das integrierte Modul node:sqlite verwendet.

Konfiguration

Kopieren Sie config.example.json in einen privaten Pfad außerhalb des Repositorys und ersetzen Sie die Platzhalter-Schlüssel:

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

Der lokale Einmal-Importeur kann konfigurierte Kelivo-Suchschlüssel in die eigenständige Textkonfiguration übernehmen:

npm run import:kelivo

Der Importeur liest Kelivo einmalig und schreibt unter Windows %USERPROFILE%/.config/search-toolkit/providers.json. Dadurch wird die MSIX-AppData/Local-Virtualisierung vermieden, sodass Codex, Claude Code und normale CLI-Prozesse dieselbe physische Datei lesen. Laufzeit-MCP- und CLI-Prozesse greifen nie auf Kelivo zu.

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

Zuerst bauen, dann den lokalen STDIO-Server zu Codex hinzufügen:

[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"

Der MCP-Server stellt Folgendes bereit:

• Anbieterpräfixierte offizielle Upstream-Tools, die durch die Tool-Richtlinie des Anbieters ausgewählt werden. Firecrawl verwendet standardmäßig sieben fokussierte Abruf-/Erfassungstools anstelle seines gesamten Verwaltungskatalogs.

• Jedes konfigurierte REST-Adapter-Tool.

• search_auto für ein fähigkeitsbewusstes Standard-Routing mit prüfbaren {provider, tool, upstreamTool}-Metadaten.

• search_pool_status für maskierte Schlüsselpool-Diagnosen.

• search_rotation_probe für einen Live-Rotationsnachweis, der Kontingent verbraucht.

Setzen Sie toolPolicy.allow für einen Anbieter nur dann auf ["*"], wenn die Offenlegung seines vollständigen Upstream-Katalogs beabsichtigt ist. Schreib- und destruktive Tools behalten korrigierte Annotationen, sodass Clients eine Genehmigung anfordern können.

Schlüsselrotation

Jede Anfrage wählt einen Schlüssel aus dem relevanten Anbieterpool aus. Der Cursor bleibt über Prozessneustarts hinweg erhalten und wird über SQLite zwischen gleichzeitigen Agentenprozessen koordiniert.

• 200: normal weiter.

• 429 oder 402: aktuellen Schlüssel abkühlen lassen.

• 401 oder 403: aktuellen Schlüssel deaktivieren.

• 5xx oder Netzwerkfehler: einmal mit dem nächsten Schlüssel erneut versuchen.

• 400, 404 oder 422: den Anfragefehler beibehalten, ohne einem anderen Schlüssel die Schuld zu geben.

providers.json, rohe Schlüssel und Rotationsstatus werden von Git ignoriert. Befehlsausgabe und MCP-Metadaten zeigen nur maskierte Schlüsselslots.

Skill

Die wiederverwendbare Skill befindet sich unter skills/search-toolkit/. Kopieren oder verlinken Sie sie in das Skill-Verzeichnis Ihres Agents. Sie leitet normale Recherchen direkt an Search Toolkit weiter und behält die Deep-Research-Orchestrierung für wirklich mehrstufige Arbeiten bei.

Entwicklung

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

Lizenz

MIT