Search Toolkit

AIエージェント向けの公式ファーストのWebツール。永続的なマルチキーローテーションと、MCP、CLI、Agent Skillsの3つのエントリポイントを備えています。

简体中文

設計

Search Toolkitは、すべてのバックエンドを1つの汎用検索エンドポイントに平坦化するのではなく、プロバイダー固有の機能を保持します。

• 公式リモートMCPプロキシ: Exa、Tavily、LinkUp。

• 公式STDIO MCPプロキシ: Firecrawl。

• 軽量な公式APIアダプター: Querit、Serper、Brave、Jina Search、TinyFish Search、Doubao Search、xAI Responses Web/X Search。

• SQLiteをバックエンドとするプロバイダーごとの永続キープール。

• プロバイダープレフィックス付きのアップストリームツール名とスキーマは、起動時に公式MCPサーバーから検出され、オプションのプロバイダーツールポリシーでフィルタリングされます。

• 生のキーはリポジトリ外のローカルJSONファイルに保持されます。

実装で使用される公式リファレンスには、Codex MCP設定ガイド、MCP TypeScript SDK、Exa MCP、Tavily MCP、LinkUp MCP、Firecrawl MCPが含まれます。

Related MCP server: qsearch

プロバイダー機能

インストール

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以降が必要です。永続ローテーションストアは組み込みのnode:sqliteモジュールを使用するため、Node.js 24を推奨します。

設定

config.example.jsonをリポジトリ外のプライベートなパスにコピーし、プレースホルダーキーを置き換えます:

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

ローカルのワンタイムインポーターは、設定済みのKelivo検索キーをスタンドアロンのテキスト設定に移行できます:

npm run import:kelivo

インポーターはKelivoを一度だけ読み取り、Windowsでは%USERPROFILE%/.config/search-toolkit/providers.jsonに書き込みます。これによりMSIXのAppData/Local仮想化を回避し、Codex、Claude Code、通常のCLIプロセスが同じ物理ファイルを読み取ります。ランタイムのMCPおよびCLIプロセスは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

まずビルドし、ローカルSTDIOサーバーを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"

MCPサーバーは以下を公開します:

• プロバイダーのツールポリシーで選択された、プロバイダープレフィックス付きの公式アップストリームツール。Firecrawlは管理カタログ全体ではなく、7つの焦点を絞った取得/収集ツールをデフォルトとします。

• 設定済みのすべてのRESTアダプターツール。

• 監査可能な{provider, tool, upstreamTool}メタデータを備えた機能認識型デフォルトルーティングのためのsearch_auto。

• マスクされたキープール診断のためのsearch_pool_status。

• ライブでクォータを消費するローテーション証明のためのsearch_rotation_probe。

完全なアップストリームカタログを意図的に公開する場合にのみ、プロバイダーのtoolPolicy.allowを["*"]に設定します。書き込みおよび破壊的ツールは修正済みの注釈を保持し、クライアントが承認を要求できるようにします。

キーローテーション

各リクエストは関連するプロバイダープールから1つのキーを選択します。カーソルはプロセス再起動をまたいで永続化され、SQLiteを通じて並行エージェントプロセス間で調整されます。

• 200: 通常どおり進めます。

• 429または402: 現在のキーをクールダウンします。

• 401または403: 現在のキーを無効化します。

• 5xxまたはネットワーク障害: 次のキーで1回再試行します。

• 400、404、または422: 他のキーのせいにせず、リクエストエラーを保持します。

providers.json、生のキー、ローテーション状態はGitで無視されます。コマンド出力とMCPメタデータには、マスクされたキースロットのみが表示されます。

スキル

再利用可能なスキルはskills/search-toolkit/にあります。エージェントのスキルディレクトリにコピーまたはリンクします。通常のリサーチはSearch Toolkitに直接ルーティングし、真に多段階の作業にはディープリサーチのオーケストレーションを残します。

開発

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

ライセンス

MIT