这个工具解决什么问题？

场景一（自媒体 / 内容创作者）

每天手动打开微博、知乎、抖音、百度看热搜，翻 5 个 App 才能找到今天能写的话题。
→ 装好后直接问 Claude：「今天适合写什么热点？结合我的账号方向分析一下」

场景二（AI Agent 开发者）

构建中文 AI Agent，需要接入实时舆情数据，但现有 MCP 工具要么依赖 Node.js、要么单一数据源随时挂掉。
→ pip install 即用，Python 原生，双数据源保障，内置缓存

场景三（Claude / Cursor / Windsurf 用户）

AI 不知道今天发生了什么，回答与现实脱节，每次手动复制热搜给它。
→ 配置一次，之后 AI 自己去拉实时数据

对比同类工具

| | mcp-hotnews-server | china-hot-mcp | |---|---|---| | 语言 | Node.js / TypeScript | ✅ Python 原生 | | 安装 | npx（需 Node 环境） | ✅ pip install | | 工具调用 | get_hot_news([1,3,7]) 数字 ID | ✅ weibo_trending() 语义命名 | | 数据来源 | 单一 vvhan.com | ✅ 直连平台 API + 备用源双保险 | | 缓存机制 | 无 | ✅ 5 分钟 TTL，防限流 | | 文档 | 英文 | ✅ 中文优先 |

快速开始（5 分钟）

安装

pip install china-hot-mcp

配置 Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "china-hot": {
      "command": "china-hot-mcp"
    }
  }
}

配置 Cursor / Windsurf

{
  "mcpServers": {
    "china-hot": {
      "command": "python",
      "args": ["-m", "china_hot_mcp.server"]
    }
  }
}

重启客户端后即可使用。

可用工具（MCP Tools）

| 工具 | 平台 | 返回内容 | |------|------|---------| | weibo_trending(limit) | 微博 | 实时热搜榜 + 热度值 | | zhihu_trending(limit) | 知乎 | 热榜问题列表 | | bilibili_trending(limit) | B站 | 热门视频 + 播放量 | | baidu_trending(limit) | 百度 | 百度热搜榜 | | douyin_trending(limit) | 抖音 | 热点话题榜 | | toutiao_trending(limit) | 今日头条 | 热文榜单 | | kr36_trending(limit) | 36氪 | 科技创业热文 | | all_trending(limit) | 全平台 | 5 大平台一次汇总 |

实际使用示例

内容创作选题：

用户：帮我分析今天全平台热搜，找出 3 个适合写成科技类内容的话题

Claude 调用 all_trending(limit=10)，返回实时数据后分析：

1. 知乎热榜第3「如何看待XXX技术突破」→ 适合，专业解读角度
2. 微博热搜第7「XXX发布会」→ 适合，产品评测角度  
3. 头条热榜第2「AI+行业动态」→ 适合，趋势分析角度

AI Agent 舆情监控：

# 在你的 Agent 中，Claude 会自动在需要时调用工具
result = agent.run("监控今天科技行业相关热搜，有重大事件立刻提醒")

架构说明

请求 → 缓存检查(5min TTL)
         ↓ 未命中
      直连平台 API（微博/知乎/B站优先）
         ↓ 失败
      备用聚合源（vvhan.com）
         ↓ 失败
      友好错误提示

• MCP 框架：Anthropic 官方 mcp[cli] Python SDK
• HTTP 客户端：httpx 异步请求
• 并发：asyncio.gather 多平台并行拉取

本地开发 & 调试

git clone https://github.com/EA-Studio-SHARK/china-hot-mcp
cd china-hot-mcp
pip install -e .

# MCP Inspector 可视化调试
npx @modelcontextprotocol/inspector python -m china_hot_mcp.server

适合谁用

• �️ 自媒体 / 内容创作者 — AI 选题助手，告别每天手翻 5 个 App
• 🤖 AI Agent 开发者 — 为 Agent 接入中国实时舆情感知能力
• 📊 运营 / 品牌监控 — 实时追踪行业热点词变化
• 🛠️ Claude / Cursor / Windsurf 用户 — 让 AI 知道今天发生了什么

相关项目

• awesome-mcp-zh — MCP 中国开发者实战工具包（精选 + 亲测 + 踩坑记录）
• local-ai-china — 本地 AI 一键部署指南（解决中国网络 + API 成本问题）

联系

• 📬 Telegram：@ExploreAllStudio
• 💼 Agent 定制开发 / MCP 集成合作欢迎联系