当社独自のアクセス統計は常に有効です。Google Analyticsは、公開ページ(ログイン後のワークスペースは対象外)の利用状況を把握するためのもので、許可をいただいた場合のみ有効になります。詳しくは プライバシーポリシーをご覧ください。

Yuanbao Search APIでは中国プラットフォームのどのデータが取れないのか

テンセントは10月20日、Yuanbao Search APIとMCPを公開しました。月2,000回まで無料で呼び出せますが、いいね数やコメントは返りません。4つのアプリを対象に実際に10回呼び出したところ、費用は$0.0286でした。

明るいグレーの床の上に描かれたイラスト。左側には台座に載った透明なワイヤーフレームの地球儀があり、その周りに白紙のウェブページのカードがいくつか置かれています。これはオープンウェブを表しています。右側にはガラス扉の付いた背の高いキャビネットが4つ並んでいます。棚にはハート、吹き出し、ブックマーク、再生のアイコンがあり、各アプリ内のいいね、コメント、保存、再生回数を表しています。中央では、小さなロボットが演台の後ろに立っています。灰色のケーブルがロボットから地球儀の台座へ伸び、ティール色のケーブルが1つのキャビネットの引き出しにつながっています。この絵は、1つのエージェントがウェブ検索とアプリ内データを同時に使う様子を表しています。

2026年10月20日、テンセントはTencent Cloudを通じてYuanbao Searchを外部の開発者に公開しました。API、MCPサーバー、スキルとして提供され、毎月2,000回まで無料で呼び出せます(MyDriversの10月20日の報道)。SearchProの結果には、タイトル、日付、リンク、要約、サイト名、関連度スコアが含まれます。

いいね数、コメント数、保存数、再生数、フォロワー数は含まれません。Tencent CloudのFAQでは、WeChat公式アカウントの記事も対象外とされています(SearchPro APIリファレンス、Yuanbao Search FAQ)。

2026年11月6日のシンガポール時間00:17〜00:20に、EveryInfraを通じてXiaohongshu、Douyin、Bilibili、WeChatで同じ製品クエリを1つ実行しました。課金対象となった6回の呼び出しの費用は$0.028557でした。Xiaohongshu、Douyin、Bilibiliでは、全件にいいね数、コメント数、投稿日時が含まれていました。WeChatの記事は、2回目の呼び出しで閲覧数を取得できます。SearchProはこれらの数値を一切返さないため、Yuanbaoを使うエージェントにはアプリ内のデータAPIも必要です。EveryInfraはTencentと提携しておらず、両者は別々のサービスです。

この記事は、中国国外でAIエージェントを開発し、中国の消費者データを必要とするチームを対象としています。典型的なリクエストは「この冬、中国の購入者はダウンジャケットのどんな点に不満を持っているか」といったものです。欧米の検索APIは、この種の質問には力不足です。

中国の主要アプリのうち2つは、海外のクローラーの大半をブロックしています。残る2つでは、Web検索で返る動画はアプリ内で上位に表示される動画とは別のもので、数値も付いていません。Tencentの新しい検索APIは、中国の公開WebとTencent自身のニュースコンテンツを調べるには優れたツールです。しかし、アプリの中で起きていることは返しません。以下では両面をデータで示し、両方を1つのエージェントにまとめる設定を紹介します。

Yuanbao Searchに関する事実はすべて、cloud.tencent.comの中国語ドキュメントと、10月20日〜22日付の報道に基づいています。それぞれを確認した日付も記載しています。Tencent Cloudのアカウントは開設していないため、以下のYuanbaoのリクエストと設定はすべて、実際には実行していない設定例です。EveryInfraの数値はすべて、11月6日のライブレスポンスから得たものです。以前の記事「DeepSeek Search APIとプラットフォーム内データ」では、別の検索APIと別のアプリ群を扱っています。両記事の違いは後のセクションにまとめています。

イラスト。左側では、灰色のベルトコンベアが白紙のWebページを漏斗へ運んでいます。漏斗はWeb検索インデックスを表しています。右側の破線の向こうには封をされた箱が3つあり、側面にはティール色のハート、吹き出し、時計が描かれています。手前の箱は開いており、ティール色の虫眼鏡で、中のカードに描かれたハートと吹き出しが見えます。
Web検索インデックスが集めるのはページです。いいね数、コメント数、投稿日時はその反対側、各アプリの中にあります。

なぜ欧米の検索APIでは中国アプリのデータを取得しにくいのか

中国の消費者の会話の大半は、4つのアプリの中で行われています。Xiaohongshu(RedNote)は、商品の活用術やレビューを投稿するノートアプリです。Douyinは中国版TikTokです。Bilibiliは、長尺のレビューや動画上に流れるコメントが特徴の動画サイトです。WeChat公式アカウントは、WeChat内で長文記事を配信します。各アプリはどのクローラーにページの閲覧を許可するかを自ら決めており、その方針をrobots.txtファイルに記載しています。

アプリ概要適した用途EveryInfraの検索機能と呼び出し単価
Xiaohongshu(RedNote)写真またはショート動画付きのノート商品の活用術、実体験レビューxiaohongshu/search、$0.005556
Douyinショート動画(中国版TikTok)話題の商品動画、リーチdouyin/search、$0.008333
Bilibili画面上にコメントが流れる長尺動画比較レビュー、コメントスレッドbilibili/search、$0.000556
WeChat公式アカウントWeChat内の長文記事詳細なレビュー、閲覧数wechat_oa/article_search、$0.008

11月6日のシンガポール時間00:23に、4つのrobots.txtファイルを確認しました。Xiaohongshuのrobots.txtはGooglebotにDisallow: /を指定しており、ワイルドカードグループもDisallow: /です。一方で、SogouのWeb用とモバイル用のクローラーには、/exploreとノートのサイトマップへのアクセスを許可しています。SogouはTencent傘下です。WeChat公式アカウントのrobots.txtは、すべてのクローラーに対して限られたパスのみ閲覧を許可しており、記事のパスはそこに含まれていません。Douyinのrobots.txtとBilibiliのrobots.txtがブロックしているのは一部のパスだけなので、動画ページは検索エンジンに公開されています。

サイトrobots.txtの主なルール(2026-11-06確認)Web検索への影響
www.xiaohongshu.comGooglebotはDisallow: /。SogouのWeb用・モバイル用クローラーは/explore、トップページ、ノートのサイトマップを閲覧可能。ワイルドカードグループはDisallow: /カバー範囲は検索エンジン次第
www.douyin.com名指しされた検索エンジンとAIクローラーは一部のパスのみブロック。ワイルドカードグループなし動画ページは公開。今週の動画は表示されるが、アプリが返す動画群とは異なる
www.bilibili.comワイルドカードグループは一部の一覧ページと各言語のトップページをブロック動画ページは公開。今週の動画は表示されるが、アプリが返す動画群とは異なる
mp.weixin.qq.comワイルドカードグループはトップページ、Q&Aページ、ミニプログラムのランディングページを許可し、それ以外をブロック記事ページはすべてのクローラーに非公開

robots.txtのルールが開放されていても、Web検索がどの動画を返すかはわかりません。それを測定するため、小さなプローブを作りました。YuanbaoのAPIキーがなかったため、プローブではYuanbaoではなく公開Web検索エンジン(地域を中国、言語を中国語に設定したGoogle)を使っています。ライブ呼び出しで得た各件について、タイトルの先頭18文字を引用符で囲み、そのアプリのsite:を付けて検索しました。上位10件のリンクに同じノートIDまたは動画IDが含まれていれば、ヒットとみなします。

最初に手法を検証しました。インデックス済みとわかっているDouyinとBilibiliのページを6件選んだところ、プローブは6件すべてを見つけました。当初の手法はIDだけで検索するもので、既知の6ページのうち見つかったのは0件でした。この当初の手法は破棄し、その結果は使っていません。

横棒グラフ。アプリごとに、ライブ呼び出しで得た結果のうち、公開Web検索エンジンがタイトルとサイトの指定で見つけた件数を示しています。Xiaohongshuは19件中0件。Douyinは10件中0件。Bilibiliは20件中4件。WeChat公式アカウントは36件中0件。対照群は6件中6件で、灰色で表示されています。タイトルは「タイトルで検索すると、呼び出しで得たアプリ内データの大半はWebエンジンの上位10件に入らない」。サブタイトルには、同じエンジンでも期間を過去1週間に絞ると今週のDouyinとBilibiliの動画は返されるが、それはエンゲージメント数のない別の動画群だと書かれています。プローブで使ったのはYuanbaoではなく公開Web検索エンジンです。

プローブが見つけたのは、Xiaohongshuのノート19件中0件、Douyinの動画10件中0件、Bilibiliの動画20件中4件、WeChatの記事36件中0件でした。対照群は6件中6件です。XiaohongshuとWeChatが0件なのはrobots.txtによるものです。このファイルはクローラーへの要請であり、アクセス制御ではありません。形式はRFC 9309で定められています。同時に、同じエンジンでトピックそのものをsite:付きで検索しました。XiaohongshuとWeChatでは、1週間の期間指定の有無にかかわらず結果は0件でした。

DouyinとBilibiliが0件だったのは、新しい動画のインデックス登録が遅いからではありません。私たち自身の対照データがその可能性を否定しています。どちらのサイトも、検索エンジンに動画ページの閲覧を許可しています。期間を過去1週間に絞ると、同じエンジンはこのトピックでBilibiliの動画を10件返し、すべてダウンジャケットのレビューで、表示は「12時間前」から「6日前」まででした。Douyinの動画は9件返り、表示は「1日前」から「6日前」まででしたが、タイトルがダウンジャケットに関するものは1件だけでした。対照群にも新しい動画が含まれていました。「1日前」と表示されたDouyinの動画1本と、「6日前」と表示されたBilibiliの動画1本で、プローブはどちらもタイトルで見つけました。

つまり、データが示しているのは1点だけです。アプリが「いいね数順」またはデフォルト順で返した結果は、Webエンジンの上位10件に入っていませんでした。Bilibiliでヒットした4件は、投稿から16.1日、1,070.6日、1,386.1日、2,113.4日が経過したものでした。過去7日間の動画13件は1件も見つかりませんでした。これはインデックス登録の遅れではなく、ランキングの違いを示しています。

エージェントにとっては2つのことが言えます。Web検索がどの動画を返すかは制御できず、その結果はアプリ自身の「いいね数順」や「新着順」とは一致しません。また、返される動画にはいいね数、コメント数、保存数が含まれません。

同じエンジンでの`site:`付きトピック検索(シンガポール時間00:22)期間指定なし過去1週間過去1週間で最新の結果
Xiaohongshu00なし
Douyin109件(ダウンジャケット関連のタイトルは1件)1日前
Bilibili1010件(すべてダウンジャケットのレビュー)12時間前
WeChat公式アカウント00なし

この結果をYuanbaoのテストとして読まないでください。Yuanbaoは別のインデックスを使っており、Tencentによれば更新は数分以内です(Yuanbao Search製品概要)。Yuanbaoが保持するアプリのページやそのランキング順は、Googleと異なる可能性があります。XiaohongshuはSogouのクローラーを受け入れているため、YuanbaoはXiaohongshuのノートページを一部保持しているかもしれません。

その数は測定できませんでした。確かなことは2つあります。まず、インデックスされているページであっても、いいね数やコメント数は返されません。次に、Tencent自身がWeChat公式アカウントの記事を対象外としています。

Yuanbao Search APIとは何か(11月6日に確認したドキュメントから)

Yuanbao Searchは製品名で、Tencent Cloud APIでのコードはwsaです。製品アップデートページによると、2025-07-01に「Web検索API」という名称で提供が始まりました。2026-01-21にLite版、2026-05-29にFlagship版が追加され、2026-10-09にYuanbao Searchへ名称が変更されました。10月20日のローンチは、既存の社内サービスを外部ユーザーに開放したものです。

Phoenix Techの10月20日の報道によると、インデックスには数千億ページが含まれています。サービスは1日あたり数億回の呼び出しを処理し、50を超えるTencent製品で使われています。その中にはWorkBuddy、ima、Tencent Financial Technology、Tencent Videoが含まれます。同じ報道によれば、金融、健康、法律、旅行など13分野の157の信頼できる情報源と接続しています。下の表は、私たちが確認した事実の一覧です。各ページはシンガポール時間11月6日00:13〜00:41に確認しました。

事実出典の記載内容(要約)出典とページ更新日
エディションLite、Standard、Flagship。Flagshipは法人アカウント限定製品概要、2026-10-26更新
1回の呼び出しあたりの結果数デフォルトは5〜10件。StandardとFlagshipは最大50件まで返せる同じページ
コンテンツソース公開Webに加え、Tencent News、Sogou Baike、PenguinアカウントなどのTencentのコンテンツ同じページ
WeChatの記事「コンテンツの著作権のため」非対応FAQ、2026-10-09更新
レイテンシとレート平均600〜800ms、P99は約1,200ms。LiteとStandardは20QPS、Flagshipは5QPS同じページ
従量課金1,000回の呼び出しあたり14元、20元、26元、日次課金課金概要、2026-10-09更新
プリペイドパックStandardのみ:50,000回の呼び出しで950元、100万回で18,500元、1,000万回で175,000元、有効期間1年同じページ
失敗した呼び出し「失敗したサービス呼び出しは課金されない」同じページ
返金パックの未使用分は1年の有効期間内であれば返金可能。従量課金の料金は返金不可返金ルール、2026-10-09更新
APIアクションSearchPro、バージョン2025-05-08、ホストwsa.tencentcloudapi.comSearchPro APIリファレンス、2026-10-27更新
APIキーモードBearerヘッダーを付けてapi.wsa.cloud.tencent.com/SearchProへPOSTAPIキーガイド、2026-10-09更新
MCPエンドポイント/Mcp、Streamable HTTP上のJSON-RPC 2.0、プロトコル2025-06-18、ツールはSearchProの1つのみYuanbao MCPページ
無料枠スキル、MCP、APIの合計で月2,000回。10月と11月は招待コードで月最大6,000回MyDrivers、Eastmoney(10月22日)

ドキュメントに記載のない点もあり、それらを推測で補うことはしません。課金ページには失敗した呼び出しは無料とありますが、結果が0件の呼び出しを成功とみなすかどうかは書かれていません。課金ページと返金ページには、無料枠についての記載が一切ありません。

MCPページでは、最新のルールについてコンソールの「キャンペーン」ページを参照するよう案内されています。2,000回と6,000回という数値は報道によるものです。製品概要ではTencentの3つのコンテンツソースが挙げられていますが、Xiaohongshu、Douyin、Bilibiliには触れていません。最後に、課金ページの単位は「1,000回の呼び出しあたり」の1つだけで、結果50件の場合に10件より料金が高くなるかどうかは書かれていません。

中国版Tencent CloudサイトにおけるYuanbao Searchの課金概要のスクリーンショットです。最初のティール色の枠は課金モード表の備考列を示しています。この列はプリペイドパックの行と従量課金の行にまたがる単一のセルで、失敗したサービス呼び出しには課金されないと記載されています。次のティール色の枠はStandardパックの表を示しており、50,000回の呼び出しで950元、100万回で18,500元、1,000万回で175,000元で、いずれも有効期間は1年です。最後のティール色の枠は従量課金の表を示しており、1,000回の呼び出しあたりLiteが14元、Standardが20元、Flagshipが26元で、日次で精算されます。
中国語版のTencent Cloud課金概要です。引用している箇所をティール色の枠で囲んでいます。2026年11月6日00:33(SGT)に撮影したスクリーンショットです。 Tencent Cloud課金概要のスクリーンショット

Yuanbao Search APIの登録方法とドル換算の料金

APIキーガイドには4つの手順が記載されています。まず、Tencent Cloudアカウントを登録し、個人または法人の実名認証を通過します。次に、Yuanbao Searchのコンソールでサービスを有効化します。続いて、APIキーを作成します。最後に、SearchProエンドポイントへリクエストを送信します。参照したドキュメントはすべて中国語版サイトのもので、中国本土以外からの新規登録は検証していません。

同じページには2つの制限も記載されています。1つのアカウントまたはサブアカウントが同時に保持できるAPIキーは最大3個です。平文のキーは作成時に一度だけ表示されるため、その場で保存する必要があります。サブアカウントがキーを作成するには、メインアカウントからサービスの読み書き権限を付与されている必要があります。FAQには、料金滞納中のアカウントはサービスを有効化できないとも書かれています。

無料枠には注意が必要です。MyDriversが10月20日15:55に報じたところでは、毎月2,000回の無料呼び出しが含まれます。同日18:15のMyDriversの2本目の記事はこれを期間限定の特典としており、終了日は示されていません。

10月22日のEastmoneyの投稿によると、招待コードを使うと10月と11月は無料枠が月6,000回に増えます。3つのアクセス方法で1つの枠を共有するかどうかは、Tencentのドキュメントに記載がありません。Zhihuのコラムは共有すると述べています。無料枠はテスト用の余裕と考え、長期的な予算には含めないでください。

ドル建てで料金を比較するため、国家外貨管理局が公表した2026-11-05の基準レートを使いました。レートは1ドルあたり6.7156元です。Yuanbaoのドル表記はすべて概算です。

Yuanbao Search定価1,000回あたりの概算(USD)1回あたりの概算(USD)
Lite、従量課金1,000回あたり14元$2.085$0.002085
Standard、従量課金1,000回あたり20元$2.978$0.002978
Flagship、従量課金、法人のみ1,000回あたり26元$3.872$0.003872
Standardパック、呼び出し50,000回950元$2.829$0.002829
スタンダードパック、呼び出し1M回18,500元$2.755$0.002755
スタンダードパック、呼び出し10M回175,000元$2.606$0.002606

返金ルールは簡潔です。パックの未使用分は1年間の有効期間内であれば返金でき、クーポン分の金額は差し引かれます。従量課金の料金は返金されません。エージェントのプロジェクトでは、無料枠と従量課金で始めて月間の呼び出し量を計測し、量が安定してからパックを購入してください。100万回パックは、従量課金より1回あたり約7.5%安くなります。

Yuanbao Search APIが返すデータ:Webページのフィールドのみで、エンゲージメント数は含まれない

SearchProは結果をPages配列に格納します。各要素はJSON文字列なので、クライアント側でもう一度パースする必要があります(SearchPro APIリファレンス)。エディションによって返されるフィールドが異なります。画像のフィールドは、APIリファレンスではpics、APIキーガイドの例ではimagesです。両方の名前が見つかったため、フィールドをマッピングする前に実際のレスポンスを確認してください。

フィールドドキュメント上の意味LiteStandardFlagship
title結果のタイトル可能可能可能
dateページの公開日時可能可能可能
url元ページのURL可能可能可能
passage標準の要約可能可能可能
content動的な要約不要可能可能
siteサイト名(空の場合あり)可能可能可能
score0〜1の関連度不要可能可能
authority_level0〜5の権威度不要不要可能
pics1件の結果につき最大10枚の画像不要可能可能
faviconサイトアイコンのリンク可能可能可能
deeplinks最大10個のサブリンク(Deeplinksが必要)不要不要可能

リクエスト側は柔軟です。表にはAPIリファレンスに記載された各パラメータをまとめています。LiteはMode、Cnt、Industryに対応していません。

パラメータドキュメント上の値
Query必須、最大1,500バイト(UTF-8)
Mode0:Webページ、1:天気や株価など特定分野の信頼できるカード、2:両方
Site1つのドメイン、またはexclude:で最大5ドメインを除外
Cnt10、20、30、40、50のいずれか
Industrygov、news、acad、financeのいずれか
Freshness直近N日(1〜30)、Nか月(1〜12)、N年(1〜5)、特定の日付、または日付範囲

これらのオプションは背景調査に向いています。エージェントは直近7日間のニュースを取得したり、特定ブランドのサイト内で公式声明を検索したりできます。ただし「このレビューに何人がいいねしたか」という問いには役立ちません。下のチャートでは、Yuanbaoのフィールド一覧と当社が実際に取得した結果を並べています。Yuanbaoの列にあるのは投稿日時だけで、一覧のほかの項目はありません。Xiaohongshu、Douyin、Bilibiliの列では、すべての件にいいね数、コメント数、保存数、投稿日時があります。

7行5列のヒートマップです。行はいいね数、コメント数、保存数、シェア数、再生数、投稿日時、投稿者のフォロワー数です。列はドキュメントに基づくYuanbao、Xiaohongshu(19件)、Douyin(10件)、Bilibili(20件)、WeChat(36件)です。Yuanbaoの列でドキュメントに記載があるのは投稿日時のみで、残りの6セルは「ドキュメントに記載なし」です。Xiaohongshuはいいね数、コメント数、保存数、投稿日時が100%、シェア数が0%で、再生数とフォロワー数のフィールドはありません。Douyinはいいね数、コメント数、保存数、シェア数、投稿日時、フォロワー数が100%、再生数が0%です。Bilibiliはいいね数、コメント数、保存数、再生数、投稿日時が100%、シェア数が0%で、フォロワー数のフィールドはありません。WeChatは投稿日時が100%で、エンゲージメント数の取得には別の呼び出しが必要です。タイトル:Webの検索結果にはエンゲージメント数がなく、アプリ内の結果にはある。

EveryInfra側のフィールド名は、各カタログのresponse_fields一覧から取っています。Xiaohongshuのカタログにはlike_count、collect_count、comment_count、share_count、posted_atと、タイアップノート用のis_cooperation_noteがあります。Douyinのカタログにはさらにauthor_follower_count、view_count、is_adがあります。Bilibiliのカタログにはview_count、弾幕(画面上のコメント)用のdanmaku_count、favorite_count、coin_countがあります。

チャートの2つのセルには補足が必要です。今回、Xiaohongshuのshare_countは19件すべてで空で、Bilibiliのシェア数も空でした。そのため、シェア数を3アプリ共通の指標として扱わないでください。

Douyinのview_countは10件すべてで空だったため、Douyinの再生数は別の呼び出しで取得してください。Xiaohongshuのタイアップフラグと2つの認証フラグはすべての件でfalseで、Douyinの広告フラグは空でした。実行したクエリは1つだけなので、これらが実際の値かデフォルト値かは判断できません。当社ではこれらのフラグを広告の除外には使っていません。

テスト1:中国の4つのアプリで同じクエリを実行

すべての呼び出しは、シンガポール時間11月6日00:17〜00:20にPOST /api/v1/socialへ送信しました。クエリは中国語で「ダウンジャケット レビュー」を意味するフレーズです。2回の呼び出しがこのテスト用キーのレート制限(1分あたり10回)に達して429が返りましたが、課金はされませんでした。直近30日間でいいね数順に並べたXiaohongshuの呼び出しは0件を返し、システムが仮押さえ分を返金しました。Douyinの呼び出しのうち1回は意図的に誤ったソート値を使い、422が返りました。課金された6回の呼び出しの合計は$0.028557でした。

シンガポール時間機能パラメータHTTP件数charged_usd
00:17:30xiaohongshu/searchmost_liked、last_30_days20000件、空の結果のため返金
00:17:52xiaohongshu/searchnewest42900
00:17:59douyin/searchmost_liked、one_week42900
00:19:06xiaohongshu/searchnewest、last_30_days200190.005556
00:19:14douyin/searchmost_liked、one_week200100.008333
00:19:27bilibili/searchデフォルトの並び順200200.000556
00:19:37wechat_oa/article_search同じクエリ200360.008
00:19:57douyin/searchsort=hot42200
00:20:16wechat_oa/article_metrics2025-11-19のレビュー1本20010.005556
00:20:26bilibili/comments再生数が最も多い動画20030.000556

Xiaohongshuは、2026-11-02から2026-11-05に投稿された動画ノート19件を返しました。いいね数の中央値は9でした。トップのノートはいいね334、コメント14、保存101で、19件中6件にはまだコメントがありませんでした。「新着順」のソートでは投稿から数時間のものが返るため、数値は低くなります。この結果は「今週どのブランドが試されているか」を知るのに向いており、「どのレビューが最も人気か」には答えられません。最初にいいね数順で実行した呼び出しは0件を返し、レスポンスには理由としてempty_result_refundedが示されました。

Douyinは「いいね数順、直近1週間」で動画10件を返しました。いいね数は1,507〜17,048で中央値は4,896.5、10件のコメント数は合計4,501でした。トップの動画はいいね17,048、コメント853、保存6,699、シェア3,674でした。2番目の動画はBosidengブランドを扱ったもので、いいね15,377、シェア15,860でした。投稿者のフォロワー数は137〜464,930です。フォロワー137人のアカウントでもいいね8,217、コメント1,433を獲得しており、フォロワー数で絞り込むとバズった動画を取りこぼします。

Bilibiliはデフォルト順で動画20件を返し、再生数は0〜1,695,719、中央値は1,047.5でした。20件の動画の弾幕数は合計3,447で、4件は投稿から1年以上経っていました。トップの動画はレビュー系クリエイターによる比較テストで、2023-12-01に投稿され、再生数1,695,719、いいね数44,806、コメント数3,678でした。次にbilibili/commentsでこの動画の上位コメントを取得しました。上位3件のコメントのいいね数は3,999、1,843、1,831で、1件目は視聴者がテスト結果を短くまとめたものでした。Web検索で動画ページは見つかりますが、その下のコメントを順位付けすることはできません。

明るいコードカードに表示された、実際のEveryInfraレスポンスのスクリーンショットです。ヘッダーにはPOST https://api.everyinfra.com/api/v1/social、シンガポール時間00:19:14、HTTP 200、4.67秒が表示されています。リクエストボディは、platformがdouyin、actionがsearch、キーワードが「ダウンジャケット レビュー」を意味する中国語、sortがmost_liked、publish_timeがone_weekです。レスポンスの抜粋にはcount 10と最初の1件が表示されており、Bosidengのダウンジャケットに関する動画で、中国語のキャプションには括弧内に訳が付いています。青緑色の枠でlike_count 15377、comment_count 1053、collect_count 2295、share_count 15860が囲まれています。投稿者名は伏せられており、author_follower_countは258414、posted_atは2026-11-01T10:16:49+00:00です。残り9件は省略されています。もう1つの青緑色の枠で、billingの下にあるcharged_usd 0.008333が囲まれています。
Douyin検索の実際のレスポンス(抜粋。投稿者名は非表示、中国語のキャプションは括弧内に翻訳)。スクリーンショットはシンガポール時間2026年11月6日に撮影しました。 EveryInfraの実際のレスポンス(2026-11-06 00:19 SGT)

テスト2:アプリ内の結果はどれだけ新しいか

商品に関する問いは時期に左右されます。昨冬のレビューより、今週の不満の声のほうが多くを教えてくれます。各件の経過時間は、呼び出し時刻の2026-11-05T16:19:30Zを基準に計測しました。区分は1日未満、1〜7日、7〜30日、30日超の4つです。Xiaohongshuのノート19件はすべて7日未満で、そのうち12件は1日未満、経過時間の中央値は0.47日でした。Douyinの動画10件もすべて7日未満でしたが、これはpublish_time=one_weekを指定したためで、中央値は2.56日でした。

残りの2アプリは新旧が混在しています。Bilibiliのデフォルト順では7日未満の動画が13件、30日超が6件で、最も古いものは2021-01-22でした。WeChatは直近30日間の記事が24件、それより古い記事が12件で、最も古いものは2024-12-18でした。エージェントは、これらの結果をモデルに渡す前にposted_atで絞り込む必要があります。そうしないと、モデルが2021年のレビューを今年の評価として提示するおそれがあります。

各アプリの結果を投稿からの経過時間別に示した横向きの積み上げ棒グラフです。Xiaohongshu(19件):1日未満が12件、1〜7日が7件で、それより古いものはありません。Douyin(10件):1日未満が1件、1〜7日が9件で、それより古いものはありません。Bilibili(20件):1日未満が7件、1〜7日が6件、7〜30日が1件、30日超が6件です。WeChat公式アカウント(36件):1日未満が2件、1〜7日が8件、7〜30日が14件、30日超が12件です。タイトル:XiaohongshuとDouyinの結果はすべて直近1週間のもの。BilibiliとWeChatの結果は先に日付で絞り込む。

Yuanbaoには独自の時間フィルターFreshnessがあり、Webの結果を直近N日に限定できます。このフィルターとアプリ内のdate_rangeやpublish_timeオプションは、似た役割を果たします。違いが1つあります。YuanbaoのdateはWebページの公開日時で、アプリ内のposted_atはノートや動画そのものが投稿された日時です。転載やまとめページではこの2つの時刻が異なることがあるため、各時刻にその取得元を明記してください。

Yuanbaoが対象外とする唯一の情報源、WeChat

Yuanbao FAQには「WeChat公式アカウントのコンテンツは含まれるか」という直接の質問があります。回答は、「コンテンツの著作権のため」含まれないというものです(Yuanbao Search FAQ)。ドキュメントが名指しで除外しているコンテンツソースはこれだけです。商品リサーチでは、WeChatに長文レビューが数多く掲載されています。今回のクエリでは25アカウントから36件の記事が返り、最も古いものは2024-12-18でした。

EveryInfraの2つの機能で、Yuanbaoが対象外とするWeChatコンテンツを補えます。wechat_oa/article_searchはキーワードで記事を検索し、タイトル、要約、リンク、アカウント名、投稿日時を返します。1回の呼び出しで36件の記事が返り、料金は$0.008でした。wechat_oa/article_metricsは記事のリンクを1つ受け取り、閲覧数、いいね数、「Wow」の数、シェア数、保存数、コメント数を返します。料金は1記事あたり$0.005556です。プラットフォームの概要はWeChat公式アカウントAPIのページにあります。

消費者向け製品テストのアカウントLaoba Pingceが2025-11-19に投稿したレビューで検証しました。このレビューでは14着のダウンジャケットをテストしています。呼び出しの結果はread_count 100001、like_count 2763、watching_count 1455、share_count 7763、collect_count 932、comment_count 94でした。WeChatでは人気記事に「100,000+」と表示されるため、100001はこの表示を表している可能性が高く、下限値と考えられます。ただし、そう明記したドキュメントは見つかりませんでした。回答では「100,000回以上閲覧」と記述してください。

この記事はシェア数7,763に対し、いいね数は2,763にとどまりました。DouyinのBosidengの動画も同じく、シェア数がいいね数を上回っていました。レビューコンテンツは、いいねよりも転送によって広がります。いいね数だけでレビューを順位付けするエージェントは、この種の投稿を過小評価します。シェア数と保存数も使えば、実際の読者の行動に近い順位になります。

1つのエージェントでYuanbao MCPサーバーとEveryInfra MCPサーバーを併用する(設定例)

どちらのサービスもリモートMCPサーバーです。どちらもStreamable HTTPを使い、AuthorizationヘッダーからBearerトークンを読み取ります。Yuanbaoのサーバーが提供するツールはSearchProの1つだけです(Yuanbao MCPページ)。EveryInfraのサーバーは、シンガポール時間11月6日00:24の時点でtools/listに12個のツールを返しました。主なツールは、アプリと機能の一覧を無料で取得するeveryinfra_list_capabilities、機能を実行するeveryinfra_call_api、非同期の結果を読み取るeveryinfra_get_jobの3つです。

トランスポートはMCP 2025-06-18仕様のTransportsセクションで定義されています。Lifecycleセクションにあるとおり、クライアントはまずinitializeを送信してプロトコルバージョンを取り決めます。その後、Toolsセクションの説明どおりtools/listとtools/callを使います。HTTP経由の場合、クライアントはinitialize以降の各リクエストにMCP-Protocol-Versionヘッダーを付ける必要があります。ほとんどのクライアントはこのヘッダーを自動で付けます。

8秒でループするフローアニメーションです。左側には、ダウンジャケットについて購入者がどんな不満を持っているかというユーザーの質問があります。この質問は中央のエージェント(Claude CodeやCursorなどのMCPクライアント)につながっています。灰色の点がエージェントから右上のボックスへ移動します。このボックスはYuanbao MCPサーバーで、ツールはSearchPro、対象は公開WebとTencentのコンテンツです。ラベルは「ステップ1:背景、ニュース、ブランドの声明」です。青緑色の点は右下のボックスへ移動します。このボックスはEveryInfra MCPで、ツールはeveryinfra_call_api、対象はXiaohongshu、Douyin、Bilibili、WeChatです。ラベルは「ステップ2:アプリ内のノート、動画、記事」です。2つのブロックが破線に沿ってエージェントに戻り、青緑色の点が右端のボックスへ移動します。このボックスは出典付きの回答で、Webのリンクに加えて、いいね数、コメント数、投稿日時を表示します。タイトル:1つのエージェント、2つのMCPサーバー:Webの情報源とプラットフォーム内の声。

以下は、Claude Codeプロジェクトのルートに置く.mcp.jsonファイルです。2つのサーバーを並べて記述し、どちらのキーも環境変数から読み込みます。Tencentのサンプルでは"type": "streamableHttp"を使っています。2026-11-02に更新されたClaude CodeのMCPドキュメントによると、typeにはhttpを指定でき、streamable-httpもエイリアスとして使えます。キャメルケースの形式はこの一覧にないため、Claude Codeではhttpを使ってください。Cursorなどほかのクライアントでは、各クライアントのドキュメントに従ってください。

json
{
  "mcpServers": {
    "yuanbao-websearch-mcp": {
      "type": "http",
      "url": "https://api.wsa.cloud.tencent.com/Mcp",
      "headers": {
        "Authorization": "Bearer ${WSA_API_KEY}"
      }
    },
    "everyinfra": {
      "type": "http",
      "url": "https://api.everyinfra.com/mcp",
      "headers": {
        "Authorization": "Bearer ${EVERYINFRA_API_KEY}"
      }
    }
  }
}

接続したら、tools/listを1回実行してSearchProの入力スキーマを確認してください。TencentのMCPページは記述が一貫していません。パラメータ表にはQuery、Site、Mode、Freshness、Cnt、Industryが並んでいます。一方、同じページに埋め込まれたツール定義では、Freshnessの代わりにUnixタイムスタンプのFromTimeとToTimeを使い、Modeを文字列型としています。確実な答えは、手元で実行したtools/listの結果だけです。MCP Inspectorを使えば、コードを書かずに両サーバーのツール一覧を確認できます。

どちらのサーバーも、MCP仕様のOAuthフローではなく固定のBearerキーを使います。Bearerヘッダーの形式はRFC 6750で定められています。自作のスクリプトからMCPエンドポイントを呼び出す場合は、初期化後のすべてのリクエストにMCP-Protocol-Versionヘッダーを付けてください。このルールは2025-06-18リリースで追加されました(2025-06-18の変更履歴)。Tencentのページではバージョンを「2025-6-18」と表記していますが、同じリリースです。Claude CodeやCursorなどのクライアントは、このヘッダーを自動で送信します。

Yuanbao Searchは、SkillHubのYuanbao Searchページでスキルとしても提供されています。スキルは実行のたびに、環境変数TENCENTCLOUD_WSA_APIKEYがあるかを確認します。続いて、--queryの値と任意の--siteの値を指定してscripts/websearch.pyを実行します。スキルとMCPサーバーは、同じAPIキーを使って同じSearchPro APIを呼び出します。スキルを読み込めるエージェントツールではスキルを、MCPサーバーを読み込めるクライアントではMCPサーバーを使ってください。

サーバーを2つ用意したら、エージェントのシステムプロンプトにルーティングルールを記述する必要があります。アプリ名ではなく、質問に必要な情報に基づいてルーティングします。推奨ルールを下の表に示します。Yuanbaoは「それは何か、出典はどこか」に答えます。アプリ内機能への呼び出しは「何人がそう言っているか、何と言っているか、いつからか」に答えます。

質問に必要な情報最初の呼び出し先必要に応じた次の呼び出し先
ニュース、告知、政策文書、ブランドの公式声明Industry=news、またはブランドサイトをSite=に指定したYuanbao SearchProなし
購入者の声(不満、使い方のコツ、レビューの評価)xiaohongshu/searchとdouyin/search上位の結果に付いたコメント
比較動画とコメントスレッドbilibili/searchbilibili/comments
長文レビューとそのリーチwechat_oa/article_searchwechat_oa/article_metrics
天気、金価格、株価などのライブカードMode=1を指定したYuanbao SearchProなし

Web検索のステップはYuanbaoでなくてもかまいません。EveryInfraにもWeb検索の機能web/searchがあります。カタログでの価格は1呼び出しあたり$0.001389、1,000呼び出しあたり$1.389です(2026年11月6日時点)。Tencentの料金ページでは、Yuanbao Standardは1,000呼び出しあたり20元です。2026-11-05の中間レート(1ドル=6.7156元)で換算すると、約$2.978です。Liteは14元で、約$2.085です。

両者は向いている用途が異なります。Yuanbaoは公開Webに加えて、Tencent News、Sogou Baike、Penguinアカウントも検索対象にします。Industryフィルター、Mode=1のライブカード、Standardでの1呼び出しあたり最大50件の結果、期間限定の無料枠があります。中国語のニュース、参考情報、政策に関する質問に使ってください。

web/searchは1呼び出しあたり最大10件を返し、各件にはタイトル、リンク、スニペット、順位、公開日が含まれます。countryとlanguageは任意で指定できます。アプリ内機能と同じAPIキーおよびMCPサーバーを使い、請求も共通です。Tencent Cloudのアカウントを作りたくないチームに向いています。今回のテストではweb/searchを呼び出していないため、フィールドと価格はカタログの記載に基づいています。

項目Yuanbao StandardEveryInfra `web/search`
1,000呼び出しあたりの価格(2026-11-06時点)20元(1ドル=6.7156元で約$2.978)$1.389
1回の呼び出しあたりの件数最大50件最大10件
フィルターFreshness、Site、Industry、Modecountry、language
コンテンツ公開Webに加え、Tencent News、Sogou Baike、Penguinアカウント。WeChat記事は対象外順位と公開日付きの公開Web検索結果
アカウントとAPIキー本人確認が必要なTencent Cloudアカウントアプリ内機能と共通のAPIキーおよび請求

HTTPで直接呼び出す:curlリクエスト2本

MCPを使わず、両サービスをHTTPで直接呼び出すこともできます。YuanbaoのAPIキーモードではBearerヘッダーだけが必要で、Tencent Cloud API 3.0の署名は不要です(APIキーガイド)。署名モードを使う場合は、wsaパッケージを含むTencent Cloud SDKを使ってください。まずはPythonクライアントとそのmodels.pyを確認するとよいでしょう。他の言語向けのコードは、対応するTencentCloud SDKリポジトリのwsa/v20250508パスにあります。たとえばGoやNode.jsです。

以下の1つ目のリクエストは、実行していないYuanbaoの設定例です。2つ目は、シンガポール時間00:19:14に実際に送信したリクエストです。中国語のクエリはJSONのエスケープシーケンスで書いてあるため、どのシェルにも貼り付けられます。サーバーはエスケープを通常の中国語テキストとしてデコードします。

bash
# Configuration example, not run: Yuanbao Standard, last 7 days, 20 results
curl -s https://api.wsa.cloud.tencent.com/SearchPro \
  -H "Authorization: Bearer $WSA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"Query":"羽绒服 测评","Freshness":"d7","Cnt":20}'
# Each item in Pages is a JSON string: parse it again

# Real request: EveryInfra Douyin search, most liked, last week
curl -s https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"douyin","action":"search","params":{"keyword":"羽绒服 测评","sort":"most_liked","publish_time":"one_week"}}'
# Returns count, results[] (like_count, comment_count, collect_count, share_count, posted_at) and billing.charged_usd

EveryInfraのレスポンスはシンプルなJSONオブジェクトです。resultsは配列で、各件にはカタログのresponse_fieldsに記載されたフィールドが含まれます。billing.charged_usdは、この呼び出しで課金された金額です。pagination.has_moreは次のページがあるかどうかを示します。次のページを取得するには、next_page_tokenをpage_tokenとして渡します。

時間のかかる呼び出しでは、リクエストボディに"mode":"async"を追加します。すぐにHTTP 202とjob_idが返るので、/api/v1/jobs/{job_id}をポーリングします。同期呼び出しの制限時間は85秒です。カタログは無料で参照できます。

両サービスのエラーと課金

エージェントはリトライするため、接続する前に課金ルールを把握しておきましょう。Yuanbaoの料金ページには、失敗した呼び出しは無料と書かれています。APIリファレンスには6つのエラーコードが記載されています。InternalErrorとInvalidParameterは汎用のエラーです。

RequestLimitExceededはリクエストが多すぎることを意味します。ResourceNotFoundはサービスが開通していないことを示し、MCPページによると開通には数分かかります。ResourceUnavailableは通常、アカウントが料金を滞納していることを意味します。UnauthorizedOperationはAPIキーが誤っているか、削除されていることを示します。EveryInfraは失敗した呼び出しや結果が空の呼び出しには課金せず、パラメータに誤りがある呼び出しは課金前に停止します。

ケースYuanbao Search(ドキュメントによる)EveryInfra(実際のレスポンスとカタログの注記による)
不正なパラメータInvalidParameter。課金の記載はなし。失敗した呼び出しは無料did_you_meanとallowedを含むHTTP 422 invalid_valueと、「Nothing was charged」という文言
レート制限RequestLimitExceeded。LiteとStandardは20 QPS、Flagshipは5 QPSHTTP 429 rate_limited、課金なし
結果なし記載なしHTTP 200、0件、empty_result_refunded、保留額を返金
APIキーの誤り、またはサービス未開通UnauthorizedOperation、ResourceNotFoundHTTP 401(ドキュメントによる。今回は未検証)
アカウントの料金滞納ResourceUnavailable。滞納中のアカウントはサービスを開通できない残高不足の場合、呼び出しは開始されない(ドキュメントによる。今回は未検証)

シンガポール時間00:19:57のテスト呼び出しでは、あえてsort=hotを送りました。エラーメッセージは、sortにはmost_liked、newest、relevanceのいずれかを指定する必要があると伝え、did_you_meanはmost_likedを提案しました。next_stepsの1行目には、sortだけを変更して再送信すること、そして何も課金されていないことが書かれていました。

モデルはこのメッセージを読み、自力で呼び出しを修正できます。HTTP 429はRFC 6585で定義されています。すぐにリトライせず、待つのが正しい対応です。

2回の429レスポンスは、XiaohongshuとDouyinの呼び出しで返りました。retry_afterの値はそれぞれ8秒と1秒で、理由はkey_limitでした。これは今回のテスト用APIキー自体の制限を意味します。リトライ処理では、retry_afterの秒数だけ待ってから再送信してください。約74秒後に両方の呼び出しを再送信したところ、どちらも結果が返りました。ステータスコード全般のルールはRFC 9110にあります。

質問1,000件あたりのコスト

1,000呼び出しあたりでは、Yuanbao Standardが約$2.978、EveryInfraのweb/searchが$1.389です。bilibili/searchは$0.556で、Yuanbaoより安価です。xiaohongshu/searchは$5.556で、Yuanbao Standardの約1.9倍です。wechat_oa/article_searchは$8.0、douyin/searchは$8.333で、約2.8倍です。

1,000件あたりで比べると、順位が変わります。Xiaohongshuは1呼び出しあたり19件を返し、1,000件あたり約$0.2924でした。Douyinは10件で約$0.8333、Bilibiliは20件で約$0.0278、WeChatは36件で約$0.2222です。

各価格は料金ページにも掲載しています。各機能のページにも表示されています。たとえばXiaohongshu検索、Douyin検索、Bilibili検索です。

1,000回の呼び出しあたりの米ドル価格を示す横棒グラフ。灰色の棒4本はYuanbaoで、Liteが約$2.085、Standardが約$2.978、Flagshipが約$3.872、10M(1,000万回)パックが約$2.606です。人民元から2026-11-05の中間レート6.7156で換算しています。ティール色の棒5本はEveryInfraで、ウェブ検索(web/search)が$1.389、bilibili/searchが$0.556、xiaohongshu/searchが$5.556、wechat_oa/article_searchが$8.0、douyin/searchが$8.333です。タイトル:「1,000回の呼び出しあたりの価格:Yuanbao Search対EveryInfraのウェブ検索・アプリ内検索」

続いて、組み合わせを見ます。質問1,000件あたりで3つのプランの費用を試算しました。プランAは質問ごとにYuanbao Standardを1回呼び出し、$2.978です。

プランBは、すべての質問でYuanbaoと4つのアプリをすべて呼び出し、$25.423です。プランCは、すべての質問でYuanbaoとBilibiliを、40%の質問でXiaohongshuを、それぞれ20%の質問でDouyinとWeChatを呼び出し、$9.023です。40%と20%という割合は想定値で、実測値ではありません。実際の割合は、「みんなは何と言っているか」を尋ねる質問がどれだけあるかで決まります。

質問1,000件あたりのデータコストを示す横棒グラフ。プランA(Yuanbao Standardのみ):$2.978。プランC(YuanbaoとBilibiliを毎回、Xiaohongshuを40%、Douyinを20%、WeChatを20%):$9.023、ティール色。プランB(Yuanbaoと4つのアプリすべてを毎回):$25.423。タイトル:質問の種類でルーティングすると、コストは$25.423から$9.023に下がる。
方式YuanbaoBilibiliXiaohongshuDouyinWeChat1,000問あたり
A(Web検索のみ)$2.9780000$2.978
C(必要に応じてアプリを呼び出す)$2.978$0.556$2.222$1.667$1.600$9.023
B(毎回すべてのアプリを呼び出す)$2.978$0.556$5.556$8.333$8.000$25.423
C2(必要に応じてアプリを呼び出し、Webステップはweb/search)$1.389(web/search)$0.556$2.222$1.667$1.600$7.434

プランCで月3,000件の質問を処理する場合、Yuanbaoの呼び出しのうち2,000回は無料枠に収まります。残りの1,000回は約$2.978です。アプリ内の呼び出しは$6.045の3倍で、$18.135です。

合計は約$21.113です。無料枠は期間限定の提供なので、無料枠がない場合の月額も試算しておきましょう。その場合、Yuanbaoの3,000回の呼び出しは約$8.934で、合計は約$27.069です。Webステップにweb/searchを使うと、3,000回の呼び出しは$4.167で、合計は約$22.302です。

無料枠がある間は、コストのほぼすべてがアプリ側で発生します。最も効果的な節約策は、最も高価な2つの機能であるDouyin検索とWeChat検索を、質問に必要なときだけ呼び出すことです。Bilibili検索は、毎回呼び出しても問題ないほど安価です。

回答で出典をどう示すか

Web検索の結果とアプリのデータを1つの回答にまとめる場合、どの行がニュース由来で、どの行がユーザー由来なのかを読み手がわかるようにする必要があります。実際に取得したデータをもとに、フォーマットのサンプルを作りました。Yuanbaoの部分は実行していないため、プレースホルダーを入れています。第1段落では、ダウンジャケットの規格や価格の変化などの背景を述べます。各行にサイト名とdateを添えて、YuanbaoのWeb検索結果を出典として示します。

第2段落ではユーザーの声を紹介します。直近1週間で最も「いいね」を集めたDouyin動画上位10本のうち、Bosidengの品質を扱った動画は15,377件のいいねと15,860件のシェアを獲得していました。最も再生されたBilibiliのテスト動画は1,695,719回再生で、トップコメントには3,999件のいいねが付いていました。各行には、アプリ名、投稿日、データを取得した時刻を明記しています。第3段落では長文レビューを取り上げます。たとえばLaoba Pingceによる2025-11-19の記事は、閲覧数100,000回以上、「wow」クリック1,455回でした。最終行には「00:20 SGT、2026-11-06時点のアプリデータ」と記載しています。次の呼び出しで数値が変わるためです。

このフォーマットには2つの利点があります。すべての数値が1回の呼び出しにさかのぼれるため、読み手やレビュー担当者がリンクを開いて確認できます。さらに、モデルに渡すのは、各件のタイトル、リンク、いくつかの数値、投稿時刻だけで済みます。

ページ全体は不要なので、入力は短く抑えられます。Yuanbaoのpassageとcontentの要約は背景の段落に、アプリのデータは根拠を示す段落に収まります。枠組みを固定すれば、モデルは安定した構成で回答を書きます。

DeepSeek Searchの記事との違い

11月3日に公開したDeepSeek Search APIの記事も、Web検索APIはエンゲージメント数を返さないという同じ出発点から始まっています。2つの記事の違いは3点あります。第1に、検索APIです。前回の記事では、10月17日に提供が始まり、成功した1,000リクエストあたり5元のDeepSeek Search and Fetchを扱いました。今回の記事では、TencentのYuanbao Searchを扱います。Yuanbao SearchはTencent News、Sogou Baike、Penguinアカウントを検索対象に加える一方、WeChatは対象外のため、本記事ではWeChatに独自のセクションを設けています。

第2に、統合の方法です。前回の記事では、OpenAI形式のチャットAPI向けに4つの関数定義とtool_callsのループを書きました。今回の記事では、2つのリモートMCPサーバーを並べて設定するだけで、ディスパッチ用のコードは書きません。

第3に、対象アプリです。前回の記事ではXiaohongshu、Zhihu、Weiboを扱い、主にテキストとQ&Aが中心でした。今回はXiaohongshu、Douyin、Bilibili、WeChatを扱います。DouyinとBilibiliは動画アプリなので、本記事では再生数、弾幕コメント、シェア数、フォロワー数も扱います。

中国向けに開発するなら、両方の記事を読んでください。エージェントがDeepSeekモデルで動いていて、各ステップを完全に制御したい場合は、DeepSeekの記事の関数パターンを使ってください。Claude Code、CursorなどのMCPクライアントを使う場合は、本記事のように2つのサーバーを並べて設定してください。両方の検索APIを接続し、価格とコンテンツのソースに応じてルーティングすることもできます。

制限事項と注意点

今回はYuanbao Searchを呼び出していません。Yuanbaoに関する記述はすべてドキュメントと報道に基づくもので、本記事のYuanbaoのリクエストと設定はすべて設定例です。ドキュメントには細かな矛盾があります。

MCPページの表と、埋め込まれたツールスキーマでは、時間フィルターの仕様が異なります。画像フィールドは、ある例ではimages、リファレンスではpicsです。報道されている再現率も2種類あり、MyDriversでは94%、Eastmoneyでは93%です。無料枠は料金ページには記載がなく、報道で伝えられている期間限定の提供なので、12月以降に改めて確認してください。

EveryInfra側で実行したクエリは1つだけです。フィールドの網羅率と鮮度の数値は1回のスナップショットで、すべてのトピックに当てはまるものではありません。スポンサー付きフラグと認証済みフラグはすべてfalseで、Douyinの広告フラグは空だったため、実際の広告の割合はわかりません。WeChatの閲覧数100001は、下限値である可能性が高いと考えられます。Douyin検索は再生数を返しませんでした。アプリ内の数値は呼び出しごとに変わるため、すべての回答にデータの取得時刻を明記する必要があります。

コンプライアンスについては、事業を行う地域とユーザーがいる地域のルールに従ってください。中国本土では、「Network Data Security Management Regulations」が2025年1月1日に施行されました。中国本土で一般向けに提供する生成AIサービスは、「Interim Measures for Generative AI Services」にも従う必要があります。2025年9月1日に施行された「Measures for Labeling AI-Generated Content」も適用されます。回答でユーザーのコメントを引用する場合は、個人のニックネームを伏せ、ブランドと機関のアカウント名だけを残してください。

各アプリも独自のオープンプラットフォームを運営していますが、用途は異なります。Xiaohongshuオープンプラットフォームは、ショップやEC向けツールを対象としています。Douyinオープンプラットフォームは、Douyinアカウントと連携するアプリやサイトを対象としています。

Bilibiliオープンプラットフォームは、クリエイターとサービスプロバイダー向けです。WeChat開発者ドキュメントが扱うのは、自分が運営する公式アカウントです。いずれも、公開されているすべてのノートや動画をキーワードで検索する機能は提供していません。公式プラットフォームとサードパーティAPIの違いについては、Xiaohongshu API比較をご覧ください。

最近の変更点

2026年10月9日、「ウェブ検索API」はYuanbao Searchに名称変更されました(製品アップデート)。開発者への影響:古いガイドやSDKパッケージでは、同じサービスに今もwsaという名前が使われています。

2026年10月17日、DeepSeekはSearch APIとFetch APIを、成功した1,000リクエストあたり5元で公開しました(DeepSeekニュース、DeepSeek検索ガイド)。開発者への影響:従量課金の中国語ウェブ検索APIが2つになりました。Yuanbao Standardは1回の呼び出しあたりの料金が4倍ですが、毎月の無料枠があり、Tencentのコンテンツも検索対象です。

2026年10月20日、Tencentは外部の開発者向けにYuanbao Searchを公開し、月2,000回分の無料呼び出しを提供しました(MyDrivers)。開発者への影響:エージェントで中国語のウェブ検索を使うのに必要なキーは1つだけになりました。無料枠は最初のテストには十分です。

2026年10月27日、TencentはFreshnessの構文を含むSearchPro APIリファレンスを更新しました(SearchPro APIリファレンス)。開発者への影響:時間フィルターの仕様はまだ変わり続けているため、手元のtools/listの出力を基準にしてください。

2026年11月2日、Claude Code MCPドキュメントが更新され、streamable-httpはhttpのエイリアスであると明記されました。開発者への影響:ベンダーの設定をコピーするときは、typeの値の表記を確認してください。

2026年11月4日、TencentはAIツール連携ページを更新しました。このページには、MCP、スキル、ソースからビルドするセルフホスト型MCPサーバーが掲載されています。開発者への影響:リモートのMCPエンドポイントにトラフィックを送りたくないチームは、自前のサーバーを運用できます。

他のベンダーも同じ方向に動いています。KimiとZhipuは開発者プラットフォームでウェブ検索ツールのドキュメントを公開しており、Anthropicのウェブ検索ツールは1,000回の検索あたり$10です。ウェブ検索はモデルプラットフォームの標準機能になりつつあります。一方、アプリ内のデータには今も個別の接続が必要です。

FAQ

Yuanbao Search APIは無料ですか?何回まで呼び出せますか?

無料枠は限られています。10月20日の報道によると、無料枠は月2,000回で、スキル、MCP、APIで共有されます。招待コードがあれば、10月と11月は月最大6,000回まで利用できます。

Tencentの課金ページには無料枠の記載がありません。無料枠を超えると、従量課金で1,000回の呼び出しあたり14元、20元または26元です。(質問の出典:「yuanbao search free」と「tencent yuanbao api」の検索候補。根拠:MyDrivers、Eastmoney、課金概要。)

Claude CodeやCursorにYuanbao MCPサーバーを追加するには?

エンドポイントはHTTPS経由のapi.wsa.cloud.tencent.com/Mcpで、Authorization: BearerヘッダーにYuanbaoのAPIキーを指定します。CursorなどのクライアントではTencentのサンプル設定を使えます。Claude Codeではtypeをhttpに設定してください。サンプルにあるキャメルケースの値は、Claude Codeが受け付ける値の一覧に含まれていません。接続したらtools/listを実行してください。(質問の出典:検索候補「tencent yuanbao mcp」。根拠:Yuanbao MCPページ、Claude Code MCPドキュメント。)

Yuanbao Search APIは中国国外から使えますか?

私たちが確認したドキュメントは中国語版のTencent Cloudサイトにしかなく、新規登録には個人または法人の実名認証が必要です。中国本土以外からの新規登録はテストしていないため、利用できるかどうかは確認できていません。API自体はBearerキーを使う通常のHTTPSです。(質問の出典:検索候補「tencent yuanbao api」。根拠:APIキーガイド。)

1回のAPI呼び出しで取得できるXiaohongshuのノートは何件ですか?

xiaohongshu/searchは1ページ20件で結果を返し、次のページはpage_tokenで取得します。1回の呼び出しは$0.005556です。「新着順、過去30日」で実行した呼び出しでは19件のノートが返り、それぞれにいいね数、コメント数、保存数、投稿日時が含まれていました。(質問の出典:Xiaohongshu APIのノート件数に関する検索候補。根拠:Xiaohongshuカタログ。)

無料で使える中国の検索エンジンAPIはありますか?

Yuanbao Searchには月2,000回の限定的な無料枠があります。DeepSeek Searchは成功した1,000リクエストあたり5元で、ドキュメントには検索専用の無料枠は見当たりませんでした。EveryInfraのカタログとMCPのtools/listは無料で参照できます。呼び出しごとに課金され、失敗した呼び出しや結果が空の呼び出しは課金されません。(質問の出典:検索候補「free search engine api」。根拠:MyDrivers、DeepSeek検索ガイド、Bilibiliカタログ。)

始め方

第1に、EveryInfraクイックスタートでAPIキーを作成します。カタログを無料で読み、xiaohongshu/search、douyin/search、bilibili/search、bilibili/commentsのパラメータと料金を確認します。各アプリの概要はXiaohongshu API、Douyin API、Bilibili APIの各ページにあります。MCPの設定方法はMCPサーバーのページにあります。

第2に、Tencent CloudでYuanbao Searchを有効にし、APIキーを作成します。両方のキーを環境変数に設定し、上記の.mcp.jsonをプロジェクトのルートにコピーします。第3に、システムプロンプトにルーティング表を追加し、質問を1つ投げてテストします。そのうえで、質問数から月額コストを見積もります。別のエージェントツールでの同様の構成は、Xiaohongshu、Douyin、JD向けのWorkBuddyコネクタをご覧ください。

参考文献

  1. 「Yuanbao Search product overview」(中国語)、Tencent Cloudドキュメント、2026-10-26更新、2026-11-06閲覧、https://cloud.tencent.com/document/product/1806/121794
  2. 「Yuanbao Search billing overview」(中国語)、Tencent Cloudドキュメント、2026-10-09更新、2026-11-06閲覧、https://cloud.tencent.com/document/product/1806/121798
  3. 「Yuanbao Search refund rules」(中国語)、Tencent Cloudドキュメント、2026-10-09更新、2026-11-06閲覧、https://cloud.tencent.com/document/product/1806/121801
  4. 「Yuanbao Search product updates」(中国語)、Tencent Cloudドキュメント、2026-10-09更新、2026-11-06閲覧、https://cloud.tencent.com/document/product/1806/121792
  5. 「Yuanbao Search FAQ」(中国語)、Tencent Cloudドキュメント、2026-10-09更新、2026-11-06閲覧、https://cloud.tencent.com/document/product/1806/121804
  6. 「SearchPro API reference」(中国語)、Tencent Cloud APIドキュメント、2026-10-27更新、2026-11-06閲覧、https://cloud.tencent.com/document/api/1806/121811
  7. 「Yuanbao Search API key guide」(中国語)、Tencent Cloudドキュメント、2026-10-09更新、2026-11-06閲覧、https://cloud.tencent.com/document/product/1806/130615
  8. 「Yuanbao Search AI tool access」(中国語)、Tencent Cloudドキュメント、2026-11-04更新、2026-11-06閲覧、https://cloud.tencent.com/document/product/1806/140541
  9. 「Yuanbao MCP server page」(中国語)、Tencent Cloud開発者向けMCPディレクトリ、2026-11-06閲覧、https://cloud.tencent.com/developer/mcp/server/11764
  10. 「Yuanbao Search Skill」(中国語)、SkillHub、2026-11-06閲覧、https://skillhub.cn/skills/tencent-yuanbao-standard-search
  11. 「tencentcloud-sdk-python wsa_client.py」、GitHub上のTencentCloud、2026-11-06閲覧、https://github.com/TencentCloud/tencentcloud-sdk-python/blob/master/tencentcloud/wsa/v20250508/wsa_client.py
  12. 「tencentcloud-sdk-python wsa models.py」、GitHub上のTencentCloud、2026-11-06閲覧、https://github.com/TencentCloud/tencentcloud-sdk-python/blob/master/tencentcloud/wsa/v20250508/models.py
  13. 「tencentcloud-sdk-go wsa client.go」、GitHub上のTencentCloud、2026-11-06閲覧、https://github.com/TencentCloud/tencentcloud-sdk-go/blob/master/tencentcloud/wsa/v20250508/client.go
  14. 「tencentcloud-sdk-nodejs wsa_client.ts」、GitHub上のTencentCloud、2026-11-06閲覧、https://github.com/TencentCloud/tencentcloud-sdk-nodejs/blob/master/src/services/wsa/v20250508/wsa_client.ts
  15. 「Tencent opens Yuanbao Search to outside users, with 2,000 free calls a month」(中国語)、MyDrivers、2026-10-20、https://news.mydrivers.com/1/1158/1158971.htm
  16. 「Tencent upgrades Yuanbao Search and opens it through Tencent Cloud」(中国語)、MyDrivers、2026-10-20、https://news.mydrivers.com/1/1159/1159052.htm
  17. 「Tencent Yuanbao Search opens to outside users」(中国語)、Phoenix Tech、2026-10-20、https://tech.ifeng.com/c/8xNUpH50e2g
  18. 「Tencent Cloud fully opens the Yuanbao Search API」(中国語)、Eastmoney Caifuhao、2026-10-22、https://caifuhao.eastmoney.com/news/20261022114426222792250
  19. 「Tencent Cloud announces Yuanbao Search for outside users」(中国語)、Zhihuコラム、2026-11-06閲覧、https://zhuanlan.zhihu.com/p/2096309245318787504
  20. 「DeepSeek news, 2026-10-17 release」(中国語)、DeepSeek APIドキュメント、2026-11-06閲覧、https://api-docs.deepseek.com/zh-cn/news/news261017
  21. 「Web search and fetch guide」(中国語)、DeepSeek APIドキュメント、2026-11-06閲覧、https://api-docs.deepseek.com/zh-cn/guides/search
  22. robots.txt、Xiaohongshu、2026-11-06 00:23 SGT閲覧、https://www.xiaohongshu.com/robots.txt
  23. robots.txt、Douyin、2026-11-06 00:23 SGT閲覧、https://www.douyin.com/robots.txt
  24. robots.txt、Bilibili、2026-11-06 00:23 SGT閲覧、https://www.bilibili.com/robots.txt
  25. robots.txt、WeChat公式アカウントプラットフォーム、2026-11-06 00:23 SGT閲覧、https://mp.weixin.qq.com/robots.txt
  26. 「RMB central parity rates」(中国語)、国家外貨管理局、2026-11-05のデータ、https://www.safe.gov.cn/safe/rmbhlzjj/index.html
  27. 「Network Data Security Management Regulations」(中国語)、中国政府ポータル、2024-09-30公開、https://www.gov.cn/zhengce/content/202409/content_6977766.htm
  28. 「Interim Measures for the Management of Generative AI Services」(中国語)、国家インターネット情報弁公室、2023-07-13、https://www.cac.gov.cn/2023-07/13/c_1690898327029107.htm
  29. 「Measures for Labeling AI-Generated Synthetic Content」(中国語)、国家インターネット情報弁公室、2025-03-14、https://www.cac.gov.cn/2025-03/14/c_1743654684782215.htm
  30. 「RFC 9309: Robots Exclusion Protocol」、RFC Editor、2022-09、https://www.rfc-editor.org/rfc/rfc9309.html
  31. 「Transports (2025-06-18)」、Model Context Protocol仕様、2026-11-06閲覧、https://modelcontextprotocol.io/specification/2025-06-18/basic/transports
  32. 「Lifecycle (2025-06-18)」、Model Context Protocol仕様、2026-11-06閲覧、https://modelcontextprotocol.io/specification/2025-06-18/basic/lifecycle
  33. 「Tools (2025-06-18)」、Model Context Protocol仕様、2026-11-06閲覧、https://modelcontextprotocol.io/specification/2025-06-18/server/tools
  34. 「Authorization (2025-06-18)」、Model Context Protocol仕様、2026-11-06閲覧、https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization
  35. 「Key Changes (2025-06-18)」、Model Context Protocol仕様、2026-11-06閲覧、https://modelcontextprotocol.io/specification/2025-06-18/changelog
  36. 「MCP Inspector」、GitHub上のmodelcontextprotocol、2026-11-06閲覧、https://github.com/modelcontextprotocol/inspector
  37. 「Connect Claude Code to tools via MCP」、Claude Codeドキュメント、2026-11-02更新、https://code.claude.com/docs/en/mcp
  38. 「Web search tool」、Claudeドキュメント、2026-11-06閲覧、https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool
  39. 「Use web search」(中国語)、Kimi開発者プラットフォームドキュメント、2026-11-06閲覧、https://platform.moonshot.cn/docs/guide/use-web-search
  40. 「Web search tool」(中国語)、Zhipu開発者プラットフォームドキュメント、2026-11-06閲覧、https://docs.bigmodel.cn/cn/guide/tools/web-search
  41. 「Xiaohongshu open platform」(中国語)、Xiaohongshu、2026-11-06閲覧、https://open.xiaohongshu.com/
  42. 「Bilibili open platform」(中国語)、Bilibili、2026-11-06閲覧、https://open.bilibili.com/
  43. 「Douyin open platform overview」(中国語)、Douyinオープンプラットフォーム、2026-11-06閲覧、https://developer.open-douyin.com/docs/resource/zh-CN/dop/overview/introduction
  44. 「WeChat developer docs」(中国語)、WeChat、2026-11-06閲覧、https://developers.weixin.qq.com/doc/
  45. 「RFC 6585: Additional HTTP Status Codes」、RFC Editor、2012-04、https://www.rfc-editor.org/rfc/rfc6585.html
  46. 「RFC 6750: OAuth 2.0 Bearer Token Usage」、RFC Editor、2012-10、https://www.rfc-editor.org/rfc/rfc6750.html
  47. 「RFC 9110: HTTP Semantics」、RFC Editor、2022-06、https://www.rfc-editor.org/rfc/rfc9110.html
  48. Xiaohongshu機能カタログ、EveryInfra API、2026-11-06閲覧、https://api.everyinfra.com/api/v1/social/catalog?platform=xiaohongshu
  49. Douyin機能カタログ、EveryInfra API、2026-11-06閲覧、https://api.everyinfra.com/api/v1/social/catalog?platform=douyin
  50. Bilibili機能カタログ、EveryInfra API、2026-11-06閲覧、https://api.everyinfra.com/api/v1/social/catalog?platform=bilibili
  51. WeChat公式アカウント機能カタログ、EveryInfra API、2026-11-06閲覧、https://api.everyinfra.com/api/v1/social/catalog?platform=wechat_oa
  52. ウェブ検索機能カタログ、EveryInfra API、2026-11-06閲覧、https://api.everyinfra.com/api/v1/social/catalog?platform=web

参考資料 BL-96