CN HotRank

io.github.Aiearn-lab由 GitHub 账号 Aiearn-lab 发布v0.2.2更新于 Oct 24, 2026

Real-time trending from major Chinese platforms (Weibo, Douyin, Baidu, Zhihu).

发布方自己的服务：Rank Fast

已验证Streamable HTTP可网页运行网页搜索与抓取数据与分析

服务详情

标识符: io.github.Aiearn-lab/cn-hotrank
传输: Streamable HTTP
运行时: Web executable
信任: Verified
发布于: Oct 14, 2026

安全提示

MCP 服务会接收对话中的工具调用请求，并可能执行外部操作。启用前请先了解该服务能做什么，并只授予它所需的权限。

注册中心已验证此条目所属的 GitHub 账号 Aiearn-lab。这并不表明该账号就是产品方。

SourceWeft 的检查只涵盖条目是否完整、端点是否响应；不审查服务器的代码，也不审查其工具的行为。

在 README 中添加徽章

向读者展示该 MCP 服务已收录于 SourceWeft，徽章链接到本页。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.Aiearn-lab%2Fcn-hotrank.svg)](https://sourceweft.com/mcp/io.github.Aiearn-lab%2Fcn-hotrank?utm_source=readme&utm_medium=badge)

概览

AI 生成的概览

远程 MCP 服务器，为助手提供今日头条、抖音、微博、百度热搜等中文平台的实时热榜结构化数据。

可以做什么: 按平台获取带排名的热榜条目，含排名、标题、热度值、标签与链接，可指定单个平台或全部平台
控制每个平台返回的条数，并可跳过 10 分钟缓存强制刷新
列出支持的平台及其数据口径与合规状态，包括因 robots 限制而暂缓的平台
适用场景: 适合需要了解中文社交媒体与搜索热点的场景，例如内容选题、市场观察或新闻背景；也适合希望直接使用托管端点、不想本地安装的情况。
运行要求: 需要一个远程 MCP 端点（Streamable HTTP 或 SSE），未声明账号、API 密钥或环境变量。README 说明 workers.dev 地址在中国大陆不可达，当地用户需另寻访问途径。

安装前请注意

服务抓取各平台公开页面，README 限定微博数据仅用于 AI 输入，禁止用于模型训练或转售原始数据。路线图中包含按次计费的付费版本。上游失败时可能返回缓存或过期数据。

安装

在 SourceWeft 中

打开控制台中的 CN HotRank，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.Aiearn-lab%2Fcn-hotrank/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "cn-hotrank": {
      "type": "http",
      "url": "https://cn-hotrank.7388603.workers.dev/http"
    }
  }
}

README

cn-hotrank · 中文社媒实时热榜 MCP Server

超紧急划时代AI赚钱计划 · A 线旗舰产品 1 号定位：给全球 AI agent 喂中文世界的热点数据（「数据海关」第一个口岸）

是什么

一个 MCP（Model Context Protocol）server，把 4 个中文平台的公开实时热榜聚合成结构化数据，任何支持 MCP 的 AI agent（Claude、Cursor 等）装上一键调用。

平台	端点	数据	合规定性
今日头条	toutiao.com/hot-event/hot-board/	50 条（标题+热度值）	robots 明确允许
抖音	douyin.com/aweme/v1/web/hot/search/list/	50 条（词+热度值）	robots 无 * UA 约束
微博	weibo.com/ajax/side/hotSearch	51 条（词+热度+标签）	Content-Signal: ai-input=yes（不训练不转售）
百度热搜	top.baidu.com/board?tab=realtime	20+ 条（标题+热度分）	无 robots 文件
知乎	api.zhihu.com/topstory/hot-list	—	robots 全禁，暂缓
B站	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`

列出支持的平台、数据口径与合规状态（含暂缓平台原因）。

抓取纪律（写死在代码里）

单平台 TTL 缓存 ≥10 分钟；平台间顺序抓取、间隔 ≥3 秒（满足微博 Crawl-delay: 1）
只用公开数据，不碰登录墙后数据，不批量恶意抓取
微博数据用途边界：ai-input（给 agent 供数）✅ / ai-train（训练）❌ / 转售原始数据 ❌
降级链：主源失败 → 备用端点（抖音有 iesdouyin 备用）→ 返回缓存旧数据并标 stale=true
stdio 模式下日志一律走 stderr，绝不污染 stdout 协议通道

开发

bash

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

npm installnpm 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）——本地全链路验证通过（四平台真实数据从 Workers 出口拉到）；公网地址 https://cn-hotrank.7388603.workers.dev
v0.3：MCP Marketplace 付费版 + x402 按次计费
v1.0：5-8 平台（知乎/B站走官方渠道解禁后）+ 趋势对比工具 + 自定义域名（墙内可达，B 线国内客户需要）

部署与验证（v0.2）

部署：npm run deploy（wrangler，Cloudflare 账号已授权）
端点（v0.2.1 起双协议）：
- 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 远端双通道验证（API + ls-remote，带重试）
- scripts/dns_probe.py —— workers.dev DNS 污染诊断（TCP DNS + DoH + --resolve）
验证结论【实，2026-10-14】：
- 本地 dev 全链路通过（SSE + Streamable HTTP 双协议）
- 墙内公网验证通过：trycloudflare 隧道域名下 initialize + tools/call 全通（微博 top1 实时返回）——SSE 长连接会被 Quick Tunnel 缓冲，Streamable HTTP 单 POST 无此问题
- 生产 workers.dev 地址墙内不可达（DNS 污染+SNI 阻断双层，见下），海外 agent 用户无感
网络真相【实，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]（后两者是 agents 的 devDeps，需显式安装，否则 wrangler 打包报 "Could not resolve"）
安装需 --legacy-peer-deps（agents 要 zod4 peer，MCP SDK 用 zod3，运行时兼容）
agents 0.0.x 的 McpAgent 有重复 connect bug，0.28.1 已修；挂载必须用 McpAgent.mount() 而非 routeAgentRequest

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（合规暂缓，记录解禁路径）

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（合规暂缓，记录解禁路径）