hotboard 0.0.1

多平台热榜数据获取 CLI 工具

Hotboard

Hotboard 是一个多平台热榜数据获取 CLI 工具，支持 46+ 个平台的热榜数据抓取。

✨ 特性

• 🎯 统一接口：所有平台使用相同的 CLI 命令格式
• � 多种输出格式：支持 JSON 和 Markdown 格式
• 🚀 异步高效：基于 aiohttp 的异步请求
• 🛠️ 类型安全：完整的类型注解支持
• 🔌 OpenClaw 集成：可作为 OpenClaw skill 使用（https://github.com/hotboard/hotboard-skill）

📋 支持的平台

综合资讯

百度热搜、微博热搜、知乎热榜、腾讯新闻、新浪、新浪新闻、澎湃新闻、网易新闻

视频娱乐

B 站、抖音、快手、AcFun

科技媒体

36kr、虎嗅、极客公园、爱范儿、少数派、IT 之家、数字尾巴

开发者社区

GitHub Trending、Hacker News、掘金、CSDN、V2EX、Linux.do、NodeSeek、HelloGitHub、51CTO、HostLoc

游戏社区

NGA、LOL、米游社、游研社

体育社区

虎扑

社交阅读

豆瓣、贴吧、简书、果壳、水木社区、微信读书

国际平台

New York Times

实用工具

地震速报、天气预警、历史上的今天

其他

吾爱破解

🚀 快速开始

安装

从 PyPI 安装（推荐）：

pip install hotboard

从源码安装（开发者）：

# 克隆仓库
git clone https://github.com/hotboard/hotboard.git
cd hotboard

# 安装
pip install -e .

使用

获取热榜数据（Markdown 格式）：

hotboard github
hotboard baidu
hotboard zhihu

获取 JSON 格式：

hotboard github --format json

查看帮助：

hotboard github --help

🤖 OpenClaw 集成

Hotboard 支持作为 OpenClaw skill 使用，实现自然语言交互。

Skill 位于独立仓库：hotboard/hotboard-skill

安装方式

从 ClawHub 安装（推荐）：

clawhub install hotboard

从 GitHub 安装：

cd ~/.openclaw/skills/
git clone https://github.com/hotboard/hotboard-skill

使用示例

• "帮我看看 GitHub 上有什么热门项目"
• "查看知乎热榜"
• "推荐一些适合程序员的热榜平台"

📦 项目结构

hotboard/
├── src/hotboard/
│   ├── cli.py              # CLI 入口
│   ├── logger.py           # 日志
│   ├── types.py            # 数据类型
│   ├── utils.py            # 工具函数
│   └── platforms/          # 平台实现
│       ├── github.py
│       ├── baidu.py
│       └── ...
├── tests/                  # 测试
├── DEVELOPMENT.md          # 开发规范
├── CONTRIBUTING.md         # 贡献指南
└── README.md               # 本文件

🔧 开发

查看 DEVELOPMENT.md 了解开发规范。

安装开发依赖：

bash scripts/dev.sh

运行测试：

pytest tests/

代码检查：

black .
ruff check .
pyright src

🤝 贡献

欢迎贡献！请查看 CONTRIBUTING.md 了解如何参与项目。

添加新平台

1. 在 src/hotboard/platforms/ 下创建新平台文件
2. 遵循 DEVELOPMENT.md 中的规范
3. 添加测试用例
4. 提交 Pull Request

📄 许可证

本项目采用 Apache-2.0 许可证。

⚠️ 免责声明

• 本项目仅供学习交流使用
• 使用时请遵守各平台的服务条款和 robots.txt
• 请合理控制请求频率，避免对目标平台造成压力
• 数据来源于各平台公开接口，不保证实时性和完整性

🔗 相关链接

• PyPI 主页
• Skill 仓库
• 问题反馈
• 更新日志
• 安全政策
• 发布指南