mcpField

china-hot-ranks

github.com/lucianaib0318Productivity75 installs
Repository

About china-hot-ranks

china-hot-ranks aggregates trending lists from seven Chinese platforms for creators, marketers, developers, and researchers. It can fetch all sources or a selected platform and returns links and popularity details.

Key features

  1. 01Aggregate trending lists from seven platforms
  2. 02Fetch all sources in one run
  3. 03Select platforms to query
  4. 04Include links and popularity details
  5. 05Export Markdown and schedule retrieval

Use cases

  1. 01Track topics for content planning
  2. 02Monitor brand mentions and public sentiment
  3. 03Follow technology trends and open-source projects
  4. 04Analyze social media trends

MCP support

The skill can be invoked with mcporter and relies on weibo MCP for Weibo trends and GitHub MCP API for GitHub Trending. It supplies aggregated trending data to MCP clients.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/lucianaib0318/china-hot-ranks --skill china-hot-ranks

After installing, type/china-hot-ranksin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
LICENSE
README.md
hot_ranks.py
install.sh
requirements.txt
setup-service.sh
docs/
api_reference.md
examples/
output_sample.md

Details

From the project README

中国热榜聚合器 📊

一键获取全网热点，掌握流量密码

支持 7 大主流平台的热门内容获取：微博、B 站、百度、CSDN、GitHub、知乎、抖音。

✨ 特性

  • 🎯 7 大平台覆盖 - 社交媒体、视频、搜索、技术社区全覆盖
  • 🚀 一键获取 - 单命令获取所有平台热榜
  • 📝 格式化输出 - 带链接、热度指数、播放量等详细信息
  • 🔧 灵活选择 - 支持获取全部或指定平台
  • 📦 开箱即用 - 无需 API Key，基于现有工具链

🚀 快速开始

方式一：直接运行脚本
# 获取所有热榜
python3 hot_ranks.py

# 获取指定平台
python3 hot_ranks.py weibo      # 微博热搜
python3 hot_ranks.py bilibili   # B 站热门
python3 hot_ranks.py github     # GitHub Trending
方式二：使用 Skill 命令
# 通过 mcporter 调用
mcporter call 'hot_ranks.get_all()'

# 获取单个平台
mcporter call 'hot_ranks.get_weibo()'
mcporter call 'hot_ranks.get_bilibili()'

📊 支持平台

平台获取方式数据内容更新频率
微博热搜mcporter (weibo MCP)热搜话题 + 热度指数实时
B 站热门Jina Reader视频标题 + 播放量实时
百度热搜Jina Reader热搜话题 + 热度标记实时
CSDN 热榜Jina Reader技术文章 + 浏览量小时级
GitHub TrendingGitHub MCP API开源项目 + Star 数日级
知乎热榜Tavily 搜索热门问题小时级
抖音热榜Tavily 搜索热门视频实时

📝 输出示例

微博热搜
1. 习近平总书记的 2026 全国两会日历
   https://m.weibo.cn/search?...

2. 微信 朋友圈编辑 🔥113 万
   https://m.weibo.cn/search?...

3. 国产手机涨价 2000 元 🔥84 万
   https://m.weibo.cn/search?...
B 站热门
1. 当面一套，背后一套 - 小潮院长 175.5 万播放
   http://www.bilibili.com/video/BV1BbwFznEpm

2. 开拓者去欢愉打工然后丧失仅存的一丝梦想 - 觅 2 166 万播放
   http://www.bilibili.com/video/BV1M5NFzrEKK
GitHub Trending
1. freeCodeCamp/freeCodeCamp ⭐380,000
   freeCodeCamp.org's open-source codebase and curriculum
   https://github.com/freeCodeCamp/freeCodeCamp

2. EbookFoundation/free-programming-books ⭐350,000
   Freely available programming books
   https://github.com/EbookFoundation/free-programming-books

🔧 依赖要求

必需
  • Python 3.6+
  • curl
  • mcporter
可选（增强功能）
  • Tavily API Key（用于知乎/抖音热榜）
  • GitHub Token（用于 GitHub Trending）

📁 项目结构

china-hot-ranks/
├── hot_ranks.py              # 主程序
├── SKILL.md                  # Skill 文档
├── README.md                 # 项目说明
├── requirements.txt          # Python 依赖
├── examples/
│   └── output_sample.md      # 输出示例
├── docs/
│   └── api_reference.md      # API 参考
└── LICENSE                   # MIT 许可证

🛠️ 高级用法

1. 导出为 Markdown
python3 hot_ranks.py > hot_ranks_$(date +%Y%m%d).md
2. 定时获取（Cron Job）
# 每天早上 9 点获取热榜
0 9 * * * cd /path/to/china-hot-ranks && python3 hot_ranks.py >> hot_ranks.log
3. 集成到工作流
from hot_ranks import HotRanksAggregator

aggregator = HotRanksAggregator()

# 获取微博热搜
weibo_data = aggregator.get_weibo()

# 获取所有热榜
all_data = aggregator.get_all()

🎯 使用场景

内容创作者
  • 追踪热点话题，创作爆款内容
  • 了解平台趋势，优化选题方向
市场营销
  • 监控品牌提及和舆情
  • 发现热门话题，借势营销
开发者
  • 关注技术趋势和开源项目
  • 学习热门技术栈
研究人员
  • 分析社交媒体趋势
  • 研究用户行为和兴趣

⚠️ 注意事项

  1. API 限制

    • 微博热搜：依赖 weibo MCP 服务
    • GitHub：需要有效 Token
    • 知乎/抖音：通过 Tavily 搜索，有调用限制

  2. 数据时效性

    • 微博/B 站/抖音：实时更新
    • CSDN/知乎：小时级更新
    • GitHub：日级更新

  3. 网络要求

    • 需要访问国内平台（微博、B 站等）
    • GitHub 可能需要代理

🤝 贡献

欢迎提交 Issue 和 Pull Request！

  1. Fork 本项目
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 开启 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

🙏 致谢

Made with ❤️ by lucianaib0318

Comments

Markdown supported