CN HotRank

io.github.Aiearn-labPublished by GitHub account Aiearn-labv0.2.2Updated Oct 24, 2026

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

The publisher's own server: Rank Fast

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingData & Analytics

Overview

AI-generated overview

Remote MCP server that gives an assistant structured real-time trending lists from Chinese platforms: Toutiao, Douyin, Weibo and Baidu hot search.

What you can do
  • Fetch ranked trending items per platform, with rank, title, heat value, tag and link, for one platform or all at once
  • Limit how many entries come back per platform and optionally bypass the 10-minute cache to force a refresh
  • List the supported platforms together with their data scope and compliance status, including platforms held back for robots restrictions
When to use it
Useful when an assistant needs current Chinese-language social and search trends for content, market or news context, and you want a hosted endpoint rather than a local install.
Requirements
A remote MCP endpoint over Streamable HTTP or SSE; no account, API key or environment variable is declared. The published workers.dev host is reported in the README as unreachable from mainland China, so users there need an alternative route.
Before you install
The service scrapes public platform pages, and the README restricts Weibo data to AI input only, forbidding model training or reselling raw data. A paid per-call tier is on the roadmap. Cached or stale results may be returned when upstream sources fail.

Installation

In SourceWeft

  1. Open CN HotRank in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Aiearn-lab%2Fcn-hotrank/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "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/hotSearch51 条（词+热度+标签）Content-Signal: ai-input=yes（不训练不转售）
百度热搜top.baidu.com/board?tab=realtime20+ 条（标题+热度分）无 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

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

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

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

开发

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

About / 关于

Maintained by Zhiwei Studio (知微工作室) — an AI-first engineering studio.

本服务由 知微工作室 维护。我们是一支 AI 参与交付的工程小队，承接 AI 工程外包： 连接器/数据接口、知识图谱与 RAG 检索、RBAC 与租户隔离、Trace 与评测看板、 SFT/DPO 数据管线、灰度发布与运维移交等。

Source: README.md at commit 7b31548

Tools

2

get_hot_rank

获取中文平台实时热榜（今日头条/抖音/微博/百度热搜），返回结构化热点：排名、标题、热度值、标签、链接。数据为各平台公开热榜，10 分钟缓存；仅用于 AI 输入（ai-input），禁止用于模型训练或转售原始数据。

Parameterscountforceplatform

list_platforms

列出 cn-hotrank 支持的热榜平台、数据口径与合规状态（含 robots 全禁而暂缓的平台及解禁路径）

Takes no parameters.

Version history

1
  1. v0.2.2LatestOct 14, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Rank integrations

Rank Fast

fast.rankOfficial publisher

Remote Rank Fast MCP server that lets an assistant check Google indexing with diagnosis, pull autocomplete keyword ideas, and review AI visibility and guest…

Streamable HTTPWeb executableAuth
Web Search & ScrapingCredential requiredOct 27, 2026

dep-rank

Published by GitHub account j7an

Ranks the GitHub repositories that depend on a given project by stars or a trust heuristic, and searches code across those dependents.

STDIODesktop only
Web Search & ScrapingNot validated yetNov 3, 2026

AIWiseRank

Published by GitHub account VLCODE87

A remote MCP server that lets an assistant search, rank and compare AI tools by real web traffic, with pricing, free plans, alternatives and LLM API benchmarks.

Streamable HTTPWeb executable
Data & Analytics7 toolsOct 24, 2026

Mcp Local Rank Map Pack Tracker

com.mambabuilt

Local MCP server that checks Google organic, map pack and local finder rankings for keywords in specified locations via an Apify actor.

STDIODesktop only
Web Search & Scraping1 toolNov 7, 2026

CreceRank

com.crecerank

Remote MCP server that reports how a brand appears in AI assistants such as ChatGPT, Gemini, Perplexity and AI Overviews, with mentions, sources and GEO tips.

Streamable HTTPWeb executableAuth
Business & CommerceCredential requiredOct 26, 2026