news Hot Hub — 中文热点数据聚合器

概述

整合知乎、今日头条、AIBase三大中文平台的热搜/热门数据。采用「调度器 + 独立脚本」插件式架构，每个平台一个独立 Python 脚本，由统一的 hub.py 调度。

目录结构

news-hot-hub/
├── SKILL.md                 # 本文件 — AI Agent 技能指令
├── requirements.txt         # Python 依赖
├── scripts/                 # 可执行脚本
│   ├── hub.py               # 统一调度入口 ★
│   ├── zhihu.py             # 知乎（已实现）
│   ├── toutiao.py           # 今日头条（已实现）
│   └── aibase.py            # AIBase（已实现）
└── references/              # 参考文档
    ├── architecture.md      # 架构设计
    ├── data-schema.md       # 数据格式规范
    └── platform-guide.md    # 平台接入指南

安装

pip install -r ${SKILL_DIR}/requirements.txt

核心依赖：requests, beautifulsoup4, lxml

CLI 使用

统一入口：${SKILL_DIR}/scripts/hub.py

python ${SKILL_DIR}/scripts/hub.py <command> [options]

平台标识

| 全称 | 缩写 | 中文 | |---|---|---| | zhihu | zh | 知乎 | | toutiao | tt | 今日头条 | | aibase | ab | AIBase |

命令一览

| 命令 | 说明 | 选项 | |---|---|---| | fetch <platform> | 获取指定平台热榜 | --limit N | | all | 并行获取全部平台 | --limit N | | compare | 跨平台热点词频对比 | --limit N | | status | 检查各平台脚本可用性 | — |

使用示例

# 单平台获取
python ${SKILL_DIR}/scripts/hub.py fetch zhihu
python ${SKILL_DIR}/scripts/hub.py fetch toutiao --limit 20
python ${SKILL_DIR}/scripts/hub.py fetch aibase
python ${SKILL_DIR}/scripts/hub.py fetch aibase daily

# 多平台
python ${SKILL_DIR}/scripts/hub.py fetch zhihu,toutiao

# 全部平台
python ${SKILL_DIR}/scripts/hub.py all

# 跨平台对比
python ${SKILL_DIR}/scripts/hub.py compare

# 检查可用性
python ${SKILL_DIR}/scripts/hub.py status

触发逻辑

Agent 加载本 skill 后，根据用户意图判断调用方式：

只提单一平台 → fetch <platform>
提到多个平台 → fetch <p1>,<p2> 逗号分隔
“全部”/“所有”/“一键”/“全平台” → all
“对比”/“比较”/“交叉分析” → compare
不明确 → 询问用户需要哪个/哪些平台

AIBase子命令映射

| 用户意图 | 子命令 | |---|---| | AI新闻 | fetch aibase（默认 hot-search → news）| | AI日报 | fetch aibase daily | | AI新闻+日报 | fetch aibase all |

输出格式

fetch / all

JSON Lines（每行一个平台结果）：

{"platform": "知乎", "success": true, "data": {"type": "hot_search", "count": 25, "data": [...]}}

compare

跨平台词频分析 JSON，包含 top_keywords 和 per_platform 字段。

详细数据格式见 references/data-schema.md

环境变量

| 变量 | 说明 | |---|---| | HOT_HUB_LIMIT | 全局默认 limit，CLI --limit 可覆盖 |

参考文档

需要深入了解时，按需读取 references/ 目录下的文档：

架构设计 → references/architecture.md：系统架构、数据流、扩展机制
数据格式 → references/data-schema.md：各平台 JSON 输出字段详细定义
接入指南 → references/platform-guide.md：新平台接入步骤、脚本模板、认证说明

快速参考

| 需求 | 命令 | |---|---| | 知乎热搜 | fetch zhihu | | 头条热榜 | fetch toutiao | | AIBase新闻 | fetch aibase | | AI日报 | fetch aibase daily | | 全部平台 | all | | 词频对比 | compare | | 可用性检查 | status |