dsh-web-search-free

中文 | English — DSH プラグイン（dsh-plugin）· 無料ウェブ検索 provider + 設定スイッチ + MCP server（Claude Code / Codex 対応）

「DeepSeek 公式の従量課金検索」をワンクリックで OpenCode と同じ無料検索（匿名・key 不要）に切り替え、 さらに同じ無料検索バックエンドをそのまま MCP サーバーとして Claude Code、Codex など任意の MCP クライアントで利用できます。

• 🆓 無料バックエンド：Parallel（デフォルト）/ Exa（予備）——いずれも OpenCode 内蔵 websearch ツールと同じ無料 MCP エンドポイントで、匿名利用可、API key 不要、残高は一切消費されません。

• 🔄 DSH 設定スイッチ：公式 ↔ 無料をワンクリックで切り替え、profile パッチを自動維持します。

• 🔌 MCP server：依存関係ゼロ、二重トランスポート（stdio + HTTP/SSE 二重ポート）、 claude mcp add / codex mcp add ですぐに使えます。

背景：なぜデフォルトで DeepSeek 公式 key を使うのか

DSH の web_search ツールは ctx.web 能力シーム（seam）を経由します。デフォルトで組み込まれる provider は @deepseek-ai/dsh-web-search-deepseek（id = deepseek-official、dsh-base 依存により自動で導入されます）：毎回の検索で DeepSeek 公式 Anthropic 互換 API （https://api.deepseek.com/anthropic/v1/messages）のネイティブ web_search_20250305 サーバーツールを呼び出し、DEEPSEEK_API_KEY を再利用し、トークン従量課金です。

Related MCP server: Search MCP Server

機能

無料バックエンド（DSH 内）

2つの無料検索 provider を ctx.web に登録し、モデル側の web_search ツール呼び出し方法は変わりません：

設定スイッチ（DSH 設定 → プラグイン設定 → 設定可能 → 無料ウェブ検索）

• enabled スイッチ（デフォルト OFF = 公式検索）：ON → 無料；OFF → 公式。

• 無料バックエンド選択：Parallel（デフォルト）/ Exa（予備）、単一選択。

• 変更時、profile ユーザー層パッチ ~/.dsh/profiles/web/cordis.patch.yml の web 行 config.searchProvider を自動維持します（ON → 選択した provider id を書き込み；OFF → 上書きブロックを削除）。

  ~/.dsh/.env には書き込めません：dsh-app-boot は .env 内のあらゆる DSH_* 変数を拒否します。

• 変更後 DSH を再起動すると有効（WebRuntime 起動時に web 行設定を読み込みます）。

MCP server（Claude Code / Codex / 任意の MCP クライアント）

依存関係ゼロの独立 MCP server（lib/mcp-server.js、DSH 非依存）で、web_search ツールを公開します（引数：query 必須、provider はオプションで parallel/exa、numResults もオプション）。 二重トランスポートに対応：stdio（デフォルト）と HTTP/SSE（ポートをリッスン、Streamable HTTP POST / と旧式 GET /sse + POST /messages の両方に対応）。

トランスポート 1：stdio（デフォルト、ポート不要）

# 本地路径方式（clone 后）
claude mcp add dsh-web-search -- node /绝对路径/dsh-web-search-free/lib/mcp-server.js
codex mcp add dsh-web-search -- node /绝对路径/dsh-web-search-free/lib/mcp-server.js

# 或 npm 全局安装后（npx，需先发布到 npm registry）
claude mcp add dsh-web-search -- npx -y @dsh-external/dsh-web-search-free
codex mcp add dsh-web-search -- npx -y @dsh-external/dsh-web-search-free

トランスポート 2：HTTP/SSE（ポートをリッスン、二重ポートモード）

# 启动 MCP server（默认 http://127.0.0.1:3100；可用 --host/--port 调整）
node /绝对路径/dsh-web-search-free/lib/mcp-server.js --http --port 3100

• Claude Code（Streamable HTTP）：

  claude mcp add --transport http dsh-web-search http://127.0.0.1:3100

• Codex（OpenAI Codex CLI）：

  codex mcp add --transport http dsh-web-search http://127.0.0.1:3100

• 旧式 SSE クライアント（URL は SSE チャネルを指す）：

  # 客户端配置 http://127.0.0.1:3100/sse（GET /sse 建立通道，POST /messages 发请求）

• 検証：ブラウザで http://127.0.0.1:3100/ を開くと {"name":"dsh-web-search-free","version":"0.3.0","transport":"http/sse","port":3100} が返ります。

その他の MCP クライアント

stdio または HTTP/SSE トランスポートに対応する任意の MCP クライアントが接続できます（コマンド/URL は上記と同じ）。 オプションの環境変数：EXA_API_KEY（Exa の匿名上限を引き上げ）。

インストール（DSH プラグイン本体）

⚠️ なぜ他の人がインストールしても設定にカードが表示されないのか？ 設定カードを表示するには、以下のすべてを満たす必要があります：

1. パッケージが dsh.profile.bundles に宣言されていること（パッケージを node_modules に入れるだけでは不十分）；

2. インストール後に DSH を再起動すること（host アセンブリと client グラフはどちらも起動時に解決されます）；

3. 設定を開く前にブラウザのページを更新すること；

4. profile が web であること（tui/headless にはブラウザ UI がありません）；

5. ローカルパス/link:/tgz でインストールすること（npx @dsh-external/dsh-web-search-free は npm registry に公開してから使う必要があり、公開前は利用できません）。 インストール後は dev_plugin_status で client ✓ を確認するか、設定 → プラグイン設定 → 設定可能 で直接確認できます。

画面表示（設定 → プラグイン設定 → 設定可能 → 無料ウェブ検索）：

方法 1：ローカルでのホットアセンブリ（dsh-super-injector、再起動不要）

dev_install_package   # dir = 插件包目录（含 package.json 与 lib/）

方法 2：profile 宣言（再起動で有効）

~/.dsh/profiles/web/package.json に宣言します：

{
  "dsh": { "profile": { "bundles": [
    "@deepseek-ai/dsh-base",
    "@deepseek-ai/dsh-web-app",
    // ...其他 bundle...
    "@dsh-external/dsh-web-search-free"
  ]}},
  "dependencies": {
    "@dsh-external/dsh-web-search-free": "link:/绝对路径/dsh-web-search-free"
  }
}

方法 3：npm パッケージ（tgz）

npm run build && npm pack
# 把产物 tgz 加入 profile 依赖后重装（pnpm install），重启生效

検証

npm run verify   # 补丁联动 + Parallel/Exa 真实搜索 + 选择矩阵 + MCP 冒烟

公式に戻す

設定で enabled スイッチを OFF にします（上書きブロックは即座に削除されます）、DSH を再起動します。 （または ~/.dsh/profiles/web/cordis.patch.yml 内の # >>> web-search-free と # <<< web-search-free の間のブロックを手動で削除します。）

権限について（安全・透明）

• DSH プラグイン：無料を有効にすると、web_search リクエストは search.parallel.ai / mcp.exa.ai にのみ送信されます；~/.dsh/profiles/web/cordis.patch.yml を変更します（境界マーカー付きの web 行上書き、形式は上記参照）、他の設定には触れません。key なし、データ収集なし、待ち受けなし。

• MCP server：上記の無料エンドポイントのみを呼び出し、あなたのファイル/環境は一切読み取りません（オプションの EXA_API_KEY を除く）。stdio モードはポートを一切リッスンしません；HTTP/SSE モードは指定した --host:--port（デフォルト 127.0.0.1:3100）でのみ MCP エンドポイントを提供し、デフォルトでは本機のループバックアドレスのみにバインドします。

開発

bash scripts/build.sh   # tsc 编译 host + core + mcp-server，复制 client 到 lib/
npm run verify          # 端到端验证

構造：

src/core.ts           # 零依赖搜索核心：Parallel + Exa（host 与 MCP 共用）
src/index.ts          # host：双 provider 注册 + settings 开关 + profile 补丁联动
src/mcp-server.ts     # MCP server：stdio + HTTP/SSE 双传输（bin：dsh-web-search-mcp）
src/client/client.js  # client：设置面板「免费网页搜索」开关卡片（含后端选择）
scripts/build.sh      # 构建（自动探测 DSH_CHECKOUT）
scripts/verify.mjs    # 端到端验证脚本
cordis.patch.yml      # bundle 装配层（含 web 行 searchProvider 解除固定）

License

MIT © sheep-programmer