CN HotRank

cn-hotrank · 中国語圏ソーシャルメディアのリアルタイムランキング MCP Server

超緊急・画期的なAI収益化計画 · Aラインのフラッグシップ製品第1号 位置づけ：世界中のAIエージェントに中国語圏のホットトピックデータを提供する（「データ税関」の最初の窓口）

概要

4つの中国語プラットフォームで公開されているリアルタイムランキングを構造化データに集約する、MCP（Model Context Protocol）serverです。MCPに対応したAIエージェント（Claude、Cursorなど）なら、インストールしてすぐに呼び出せます。

プラットフォーム	エンドポイント	データ	コンプライアンス上の位置づけ
Toutiao	toutiao.com/hot-event/hot-board/	50件（タイトル＋注目度）	robotsで明示的に許可
Douyin	douyin.com/aweme/v1/web/hot/search/list/	50件（キーワード＋注目度）	robotsに* UAの制約なし
Weibo	weibo.com/ajax/side/hotSearch	51件（キーワード＋注目度＋タグ）	Content-Signal: ai-input=yes（学習・再販売は禁止）
Baiduホット検索	top.baidu.com/board?tab=realtime	20件以上（タイトル＋注目度スコア）	robotsファイルなし
Zhihu	api.zhihu.com/topstory/hot-list	—	robotsで全面禁止、当面見送り
Bilibili	api.bilibili.com/x/web-interface/ranking	—	robotsで全面禁止、当面見送り

完全な検証レポート：../../热榜数据源可抓取性验证报告_20261014.md

ツール（Tools）

get_hot_rank

中国語圏プラットフォームのリアルタイムランキングを取得します。

パラメーター：

• platform: toutiao | douyin | weibo | baidu | all（デフォルトはall）
• count: プラットフォームごとの件数 1-50（デフォルトは20）
• force: キャッシュをスキップして強制更新（デフォルトはfalse。頻度制限を守るため、使用には注意してください）

戻り値：プラットフォームごとの { platform, label, ok, stale, fetchedAt, items[{rank, title, heat, tag, url}] }

list_platforms

対応プラットフォーム、データの定義、コンプライアンス状況（見送り中のプラットフォームの理由を含む）を一覧表示します。

取得ルール（コードに固定）

1. プラットフォームごとのTTLキャッシュは10分以上。プラットフォーム間は順番に取得し、間隔を3秒以上空ける（WeiboのCrawl-delay: 1を満たします）
2. 公開データのみを使用し、ログイン壁の向こう側にあるデータにはアクセスせず、大量の悪意あるスクレイピングは行いません
3. Weiboデータの用途制限：ai-input（エージェントへのデータ提供）✅ / ai-train（学習）❌ / 生データの再販売 ❌
4. フォールバック順序：メインソースの失敗 → 予備エンドポイント（Douyinにはiesdouyinの予備あり）→ キャッシュ済みの古いデータを返し、stale=trueを設定
5. stdioモードでは、ログはすべてstderrに出力し、stdoutのプロトコルチャネルを絶対に汚染しません

開発

npm install
npm run build     # tsc → dist/
npm start         # stdio 模式本地跑
npm run inspect   # MCP Inspector 调试

ロードマップ

• v0.1（2026-10-14 完了）：stdioローカル版。4プラットフォームの集約＋キャッシュ＋フォールバックを実装し、スモークテストに合格
• v0.2（2026-10-14 デプロイ済み）：Cloudflare Workersにデプロイ（SSE MCP）——ローカルで全経路の検証に合格（4プラットフォームの実データをWorkers経由で取得）。公開URL https://cn-hotrank.7388603.workers.dev
• v0.3：MCP Marketplace有料版＋x402による従量課金
• v1.0：5～8プラットフォーム（Zhihu／Bilibiliは公式チャネルで利用制限解除後）＋トレンド比較ツール＋カスタムドメイン（中国国内からアクセス可能にし、Bラインの国内顧客に対応）

デプロイと検証（v0.2）

• デプロイ：npm run deploy（wrangler、Cloudflareアカウントは認証済み）
• エンドポイント（v0.2.1以降は2つのプロトコルに対応）：
  • GET/SSE https://cn-hotrank.7388603.workers.dev/mcp（SSEモード、標準MCPクライアント向け）
  • POST https://cn-hotrank.7388603.workers.dev/http（Streamable HTTP、単一POST、Accept: application/json, text/event-stream）——トンネル／curl／x402の従量課金に便利
• 検証スクリプト：
  • scripts/verify_sse.py <base_url> —— SSEモードのMCP全プロトコル検証（initialize→tools/call→tools/list）
  • scripts/verify_remote.py —— GitHubリモートの2経路検証（API + ls-remote、再試行あり）
  • scripts/dns_probe.py —— workers.devのDNS汚染診断（TCP DNS + DoH + --resolve）
• 検証結果【実測、2026-10-14】：
  • ローカルdev環境で全経路の検証に合格（SSE + Streamable HTTPの2プロトコル）
  • 中国国内の公開ネットワークでの検証に合格：trycloudflareトンネルのドメインでinitialize + tools/callがすべて成功（Weiboのtop1をリアルタイムで返却）——SSEの長時間接続はQuick Tunnelでバッファリングされますが、Streamable HTTPの単一POSTでは問題ありません
  • 本番のworkers.devアドレスは中国国内からアクセスできません（DNS汚染とSNI遮断の二重障害。下記参照）。海外のエージェントユーザーには影響しません
• ネットワークの実態【実測、2026-10-14】：workers.devはGFWによって全面的にブロックされています。DNSの全経路（UDP/TCP/DoH）でFacebook／Twitterの偽IPが注入され、実際のCF IP（104.x/2606:4700::）ではTLS SNI=workers.devが即時RSTされます（同じIPでdash.cloudflare.comは正常）。github.comは断続的にアクセス可能で、api.github.com/codeload/Cloudflare APIのドメインは安定しています。国内で利用するにはカスタムドメインが必要です（v1.0を参照）。中国国内での一時的な検証にはwrangler dev --tunnelを使用できます

依存関係について（v0.2のつまずき記録）

• [email protected] + @modelcontextprotocol/[email protected] + @modelcontextprotocol/[email protected]（後者2つはagentsのdevDepsです。明示的にインストールしないと、wranglerのバンドル時に"Could not resolve"エラーが発生します）
• インストールには--legacy-peer-depsが必要です（agentsはzod4のpeer依存を要求し、MCP SDKはzod3を使用しますが、実行時の互換性があります）
• agents 0.0.xのMcpAgentにはconnectの重複実行バグがありましたが、0.28.1で修正済みです。マウントにはrouteAgentRequestではなく、McpAgent.mount()を使用してください

ディレクトリ

src/
  index.ts          # MCP server 入口（stdio）
  types.ts          # HotItem / PlatformResult
  cache.ts          # TTL 缓存
  sources/
    index.ts        # 聚合调度（缓存+顺序+降级）
    toutiao.ts      # 头条（JSON 主源）
    douyin.ts       # 抖音（主源+iesdouyin 备用）
    weibo.ts        # 微博（JSON 主源）
    baidu.ts        # 百度热搜（HTML 解析）
    suspended.ts    # 知乎/B站 stub（合规暂缓，记录解禁路径）

---

About / 概要

Zhiwei Studio (知微工作室) がメンテナンスしています。AIを中心に据えたエンジニアリングスタジオです。

本サービスは知微工作室がメンテナンスしています。AIを活用しながら成果物を提供するエンジニアリングチームとして、AIエンジニアリングの受託開発を行っています： コネクター／データインターフェース、ナレッジグラフとRAG検索、RBACとテナント分離、Traceと評価ダッシュボード、 SFT/DPOデータパイプライン、段階的リリースと運用引き継ぎなど。

• 能力概要 / Capability card: https://ai-eng-capability.app.workbuddy.host/
• ビジネス提携：[email protected]