Doubao Search MCP：1行のコマンドで中国製 Web 検索を Claude Code につなぐ

公開日 2026-07-28 · toolin小编

ByteDance の Doubao Search は Volcengine が外部提供する人民元建ての Agent 用 Web 検索 API。本チュートリアルは、オープンソースの MCP を使って1行のコマンドで Claude Code に接続し、中国製モデルに切り替えたあとの検索不能・ハルシネーション問題を解決します。

Doubao Search MCP：1行のコマンドで中国製 Web 検索を Claude Code につなぐ

Claude Code のモデル endpoint を中国製大規模モデル（Doubao、Kimi、GLM、DeepSeek）に差し替えるのは、多くの人がやっている節約術です。しかし、たいてい同じ落とし穴にぶつかります：サブ Agent が突然インターネットに接続できなくなり、もっともらしく捏造し始めるのです。

原因はシンプルです——Claude Code に内蔵の WebSearch ツールは Anthropic のモデルサービスにバインドされているから。切り替えた瞬間にこのツールは機能しなくなります。Agent は目を失い、パラメータに残った古い知識だけで捏造するしかなくなります。

本稿はこの問題を解決します。主役は Doubao Search（豆包搜索）：ByteDance の Volcengine が外部提供する、人民元建ての Agent 検索 API です。さらにコミュニティの作者が書いたオープンソース MCP を重ねれば、1分で Web 接続能力を Claude Code に取り戻せます。

最初に区別しておきます：これはこのバッチの SearchOS（中国人民大学 + Ant Group のオープンソース研究フレームワーク）とはまったく別物です。SearchOS は研究向けマルチエージェントフレームワーク。本稿で扱うのは ByteDance の商用検索 API + Claude Code につなぐオープンソース MCP です。ByteDance の TRAE Work ワークベンチと混同しないでください。

Doubao Search とは

一言でいえば、Doubao アプリ内の検索エンジンを切り出し、Agent から呼び出せるインターフェースにしたものです。Volcengine 上で「Search as a Service」として外部提供され、Tavily の人民元建て代替という位置づけで、Agent 向けに特化調整されており、人間が見るための検索エンジンではありません。

公式コンソール（サービス開通、API Key 取得の入口）：console.volcengine.com/search-infinity/web-search-exp
公式の接続形態：API / MCP / Skill の3種（Volcengine 公式アナウンス idx22 で確認）
出力フォーマット：Agent フレンドリーな Markdown + 構造化データ。自然言語のタスク意図を理解し、検索戦略を自動調整（ピンポイント検索 / 広範なセマンティック書き換え / マルチターン検索）。サイト+クリエイター単位の権威度ランキングを行い、Web 全体 + 業界ナレッジ + ByteDance 独自コンテンツを融合します

Agent 向けに設計された4つの差別化ポイント

普通の検索 API が渡してくるのは「青いリンク10本」で、Agent はその後、自分でページを取得し本文をクリーンアップしなければなりません。Doubao Search はこの数ステップを引き受けています：

クリーンアップ済みの本文：各結果はクリーニング済みの本文を直接返します。中国語のホットトピックで約1100字/件。Agent がもう一度クロールする必要はありません。
秒単位のタイムスタンプ：各結果に公開時刻のタイムスタンプ + ソースリンクが付きます。Agent は「これが去年の情報か今日の情報か」を判断できます——モデルバージョンの追跡やニュース系タスクの鍵です。
ContentTokenCount：各結果にトークン数が付きます。Agent はコンテキスト予算を組み、一気に爆発させるのを避けられます。
構造化された「如意カード」：株式、ゴールド、外国為替、フライト、列車、公演といった情報は、散文から掘り出させるのではなく、構造化フィールドで直接返されます。

2つのバージョン、1本の API Key

バージョン	位置づけ	本文の長さ	特徴
Global	開箱即用（すぐ使える）	約1100字/件	トークンカウント付き
Custom	エンタープライズ、ルール化	約3700字/件	より高速、4段階の権威度ランキング付き

両バージョンで月500回の無料枠を共有します（WeChat 記事 + Volcengine 公式投稿の双方で確認）。超過後は従量課金で、月額カードも提供されています（月額カードは Volcengine Agent Plan にバインド）。具体的な単価と月額カードの価格はコンソールの実時表示を基準にしてください——本稿では数字をでっち上げません。

始める前の準備

Node.js：npx が使えること（Node 18+ 推奨）
Claude Code：インストール済みで、ターミナルで claude コマンドが実行できること
Doubao Search の API Key：Volcengine コンソールで「搜索 Infinity」を開通し、DOUBAO_SEARCH_API_KEY を取得します
任意の ARK_API_KEY：Volcengine の Ark キー。設定すると AI エンハンス（結果の圧縮、クロスソース交差検証）が有効化されます
予算：月500回の無料枠でテストと小規模プロジェクトは十分回ります。ヘビーに使う前に、コンソールで超過後の単価を必ず確認すること

ステップ1：MCP を使った1行コマンドで Claude Code に接続

主役はコミュニティ作者 花叔（alchaincyf） のオープンソース MCP：github.com/alchaincyf/huashu-doubao-search（MIT ライセンス）。彼がこの MCP を作った動機は直球です：自身が書いた「女娲（Nuwa）」スキル（6つの子 Agent で人物の思考スタイルをリサーチするオープンソーススキル）が、ユーザーがモデルを中国製に切り替えた途端、子 Agent が Web 接続できなくなり、リサーチ内容を捏造し始めたのです。そこで Doubao Search を MCP にラップして自分のスキルに使うようにしました。

ターミナルで次の1行を実行します：

claude mcp add huashu-doubao-search \
  -e DOUBAO_SEARCH_API_KEY=你的key \
  -- npx -y github:alchaincyf/huashu-doubao-search

パラメータの説明：

-e DOUBAO_SEARCH_API_KEY=...：必須。Volcengine コンソールで開通後に取得します
任意で -e ARK_API_KEY=... を追加：AI エンハンス（結果の圧縮、クロスソース交差検証）を有効化します
npx -y github:alchaincyf/huashu-doubao-search：起動のたびに GitHub から最新版を取得します

この MCP がやることは1つだけです：Claude Code の検索リクエストを受け取り → Doubao Search API を呼び → Agent フレンドリーな形式（本文 + タイムスタンプ + トークンカウント）に整形して返します。

💡 ヒント：すでに他の MCP 設定があっても、このコマンドは追加で書き込むだけで競合しません。インストール後、Claude Code 内で「xxx を検索して」と言えば、自動でこの MCP が呼び出されます。

ステップ2：`cross_check` でマルチソース交差検証

花叔はさらに cross_check モードを追加しています：複数の角度から並行して検索をかけ、結果の合意/不一致を比較します（比較モデルには Doubao-Seed-Evolving を使用）。リサーチレポートの執筆やデューデリジェンスで、ある主張の信頼性を検証するのに向いています。

呼び出し方は、Claude Code に MCP 呼び出し時に cross_check パラメータを付けるよう指示する形です（具体的なパラメータ名はリポジトリの最新 README を基準にしてください）。「どのソースが合意したか / どのソースが食い違うか」のレポートを出力し、手動でタブを5枚開いて自分で比較する手間を省きます。

ステップ3（代替ルート）：API を直接使う、または公式 Skill を導入する

Claude Code を使わない場合や、コードから直接呼びたい場合は、代替ルートが2つあります。

A. API を直接呼ぶ：コンソールで開通してキーを取得し、公式ドキュメントどおりに HTTP リクエストを送るだけです。自前の Agent を書きたい、サードパーティの MCP に依存したくない開発者向けです。返却フィールドには前述の本文、タイムスタンプ、ContentTokenCount、構造化カードが含まれます。

B. 公式 Skill での接続（Volcengine 公式が提供）：

npx skills add https://skills.volces.com/skills/bytedance/agentkit-samples -s byted-web-search

すでに Volcengine の Agent エコシステムを使っており、「公式メンテナンス」の接続方式を望む場合に向きます。本稿の主役はコミュニティ MCP（より軽量、Claude Code 向けに設計）で、Skill は並列の選択肢です。

誰が使うべきか、Tavily との選び方

向いている人：

Claude Code / Cline / その他の Agent クライアントでモデルを中国製に替えており、Web 接続能力を取り戻したい人
中国国内で Agent を開発したいが、Tavily は不安定で海外のクレジットカードも要る、という開発者
深層リサーチ、デューデリジェンス、モデルバージョンの追跡など、情報の新旧と正確性に敏感なタスクを書く人（タイムスタンプと本文クリーンアップが最も効くタスクです）

Tavily との比較（花叔の実測、1件あたりの情報量）：

項目	Doubao Search（Global）	Tavily basic
本文の長さ	約1100字	約700字
公開タイムスタンプ	あり、秒単位	なし
トークンカウント	あり	なし
中国国内での可用性	安定	不安定
課金	人民元	海外クレジットカード
無料枠	月500回	あり（枠の詳細は公式サイトを確認）

結論はシンプルです：中国国内にいて、Agent に安定した Web 接続が要るなら Doubao。純粋な海外プロジェクトで Tavily がすでに手に馴染んでいるなら、替える必要はありません。

公式評価についての正直な注記

Volcengine / 量子位（QbitAI）が公表した評価の口径（Seed モデルを基盤、公式スコアラー）：SimpleQA はベースライン比 +70%、FreshQA / BrowseComp-ZH / Xbench-2505 で上位ランク。

これはベンダー/メディアが公表した評価で、独立した再検証ではありません。その性質を踏まえて参考にしてください。

Volcengine はさらに「中国国内の9割の TOP スマホメーカーのスマートアシスタントを支える情報エンジン」とも宣伝しています——これはベンダーの自己申告で、独立検証はありません。本稿の推薦根拠にはしません。

よくある質問

Q：MCP を入れたのに、Claude Code がまだ Web に繋がらない A：まず claude mcp list に huashu-doubao-search が見えるか確認します。次に環境変数 DOUBAO_SEARCH_API_KEY の記入ミスがないか確認します。最後に、コンソールで「搜索 Infinity」サービスが本当に開通しているか調べます。Volcengine アカウントがあるだけでは足りません。
Q：無料枠を使い切ると自動で課金される？ A：コンソールの実際の課金ポリシーを基準にしてください。開通時に、有料プランへのアップグレードが自発的な操作が必要かどうか必ず自分で確認し、デフォルトのままにしないこと。
Q：cross_check モードは無料枠を余分に消費する？ A：消費します。複数角度のクエリを並行で投げるため、その都度呼び出しとしてカウントされます。月500回の無料枠では、まず単発の検索で通してから交差検証を検討してください。
Q：Global と Custom はどちらを選ぶ？ A：個人開発やプロトタイプ検証なら Global で十分です。長文本文、ルール化された検索、エンタープライズ級の SLA が必要になって初めて Custom を検討します。

リソースリンク

オープンソース MCP リポジトリ：github.com/alchaincyf/huashu-doubao-search（MIT、約56 star、HTTP 200 を確認済み）
Doubao Search コンソール：console.volcengine.com/search-infinity/web-search-exp
公式 Skill の入口：npx skills add https://skills.volces.com/skills/bytedance/agentkit-samples -s byted-web-search
作者花叔の女娲（Nuwa）スキル（背景参考）：彼の GitHub プロフィールページで見つけられます