search-boost-mcp

Multi-engine web search MCP server for coding agents. One CLI install wires it into Cursor, Cursor CLI, Codex, Claude Code, Grok Build, and Antigravity.

search-boost 系列

プロジェクト	用途	リンク
search-boost (このリポジトリ)	Cursor · Codex · Claude · Grok · Antigravity via MCP	ここにあります
dsh-search-boost	DeepSeek Harness bundle プラグイン	GitHub · npm
pi-search-boost	pi 拡張	GitHub · npm

Search engines are vendored in lib/search/ (originally from dsh-search-boost): on the free layer, Bing, DuckDuckGo, Yahoo, and Exa-free run in parallel; the api layer adds Antigravity CLI (when available) and whichever keyed Tavily / Brave / Exa engines you configure (one key is enough; all three recommended for best fusion). Also included: X/Twitter fallback, Jina page fetch, and deep-research rounds.

中国語ドキュメント → README_zh.md

v0.1.4 の新機能

• 単一エンジンAPI層 — api 層は、設定または有効にした tavily/brave/exa のいずれかを使用します。3つのキーすべては必要ありません。

• エンジンごとのルーティング — ~/.search-boost-keys.json 内でオプションの enabledEngines またはエンジンごとの enabled: false を使用可能。

• 部分キーメッセージ — doctor、status、keys wizard、および fused_search は、有効なキー付きエンジンが3つ未満の場合に警告し、3つすべてを設定するよう推奨します。

v0.1.2 の新機能

• 自己完結型エンジンプール lib/search/ 内: Bing + DuckDuckGo + Yahoo + Exa-free による一般検索; 同じプールが x_search フォールバックを site: クエリで強化します。

• x_search フォールバック はマルチエンジンドメイン検索のために自動的に site:x.com を先頭に追加し、XAI 認証情報がなくてもキーワードモードが機能します。

• 外部 dsh リポジトリや npm 依存関係なし — エンジンロジックはこのリポジトリに同梱されています。

インストール（推奨）

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

インストール後に各エージェントを再起動して MCP をリロードしてください。

エージェントごとのワンライナー

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

書き込みなしでプレビュー: search-boost install --dry-run -y

インストールの確認

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)

終了コード: 0 正常 · 1 失敗（--strict の場合は警告も） · 2 警告のみ。

オプション: search-boost doctor --probe はライブ検索スモークを追加します（ネットワークが必要; フェーズ2）。

次にエージェントで確認してください：

ツールが表示されても呼び出しが失敗する場合は、ターミナルで search-boost serve を実行して起動エラーを確認してください。

インストールフラグ（クイックリファレンス）

完全オンボーディング（APIキー + レイヤー選択）の場合は、-y なしで search-boost setup または search-boost install を実行してください。

Related MCP server: gemini-search-mcp

得られるもの

また: リソース search-boost://policy · プロンプト search_routing

レイヤー

• free — Bing + DuckDuckGo + Yahoo + Exa-free; APIキー不要。

• api — フリーレイヤーのエンジンに加え、Antigravity CLI（利用可能な場合）および設定した Tavily / Brave / Exa の任意の組み合わせ（1つのキーでも動作しますが、最良のクロスエンジンフュージョンには3つすべてを推奨）

キー: search-boost config keys → ~/.search-boost-keys.json（レガシー ~/.dsh-search-boost-keys.json も読み込まれます; または環境変数 TAVILY_API_KEY, BRAVE_API_KEY, EXA_API_KEY）。オプションのルーティング: キーファイル内で enabledEngines: ["exa"] または "engines": { "brave": { "enabled": false } }。

キーを取得: Tavily · Brave Search API · Exa

X/Twitter認証（オプション）: 認証情報がある場合、公式の x_search が向上します。~/.search-boost-xauth.json（レガシー ~/.dsh-search-boost-xauth.json も読み込まれます）または XAI_API_KEY / Grok /x-login 経由で保存されます。ファイルパスのオーバーライド: SEARCH_BOOST_XAUTH_FILE。

設定ファイルのオーバーライド: SEARCH_BOOST_KEYS_FILE, SEARCH_BOOST_LAYER_FILE, SEARCH_BOOST_XAUTH_FILE（カスタムパスを指すオプションの環境変数）。

CLIチートシート

インストールフラグ: -t cursor,codex,…|auto|all · -y（非対話型; --auto-allow + --replace-native を暗示） · --dry-run · --auto-allow（MCPツールを事前承認 — 上の表を参照） · --replace-native / --keep-native · --scope user|project (Grok) · --workspace (Antigravity .agents/)

サポートされているエージェント

プロンプトはモデルの裁量を促す文言を使用します（あなたが選んだときに検索 — 毎ターン強制されるわけではありません）。エージェントごとのテンプレートは agents/ を参照。

ネイティブWeb検索: Codexの web_search とClaudeの WebSearch は --replace-native で無効にできます（非対話型ではデフォルト）。Cursor/Antigravityはスキル＋フックの設定のみに依存します。Grokのネイティブブラウズは有効のままです。

Antigravity + agy CLI: apiレイヤーでは、オプションのAntigravity CLIエンジン（agy on PATH）は、単純なルックアップではなく、中および複雑なfused_search階層にのみ参加します。ローカルサインインとプラットフォームの割り当てに依存し、タイムアウトは約45秒です。

Grok プラグイン

このプラグインはnpmパッケージ内に同梱されています（ポータブルなnpx経由のMCP、およびスキル）。

再インストールは冪等です: search-boost install -t grokは、新しい[permission]ブロックを書き込む前に、以前のsearch-boost [permission]ブロック（マークされたものまたはレガシー）を削除するため、重複した[permission]キーがgrokの起動を妨げることはありません。[ui] permission_mode = "always-approve"がすでに設定されている場合、--auto-allowは[permission]の注入をスキップします（always-approveはMCPツールをグローバルに承認します）。search-boost doctorは、重複または冗長なパーミッションブロックを警告します。

git cloneから（リポジトリルート）:

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

npm install -g search-boost-mcp後（clone不要）：

# 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

バンドルされている.mcp.jsonはnpx -y search-boost-mcp serveを使用するため、プラグインはNode ≥ 22.13を搭載した任意のマシンで動作します。

詳細 → grok-plugin/README.md

トラブルシューティング

開発

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

ローカルクローンインストールはnode /path/to/cli.mjs serve（npxではない）を書き込みます。サイドチェックアウトやSEARCH_BOOST_DSH_ROOTは不要です。

ライセンス

MIT

リンク: Issues · dsh-search-boost · pi-search-boost

フレンドリーリンク: LINUX DO コミュニティ