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`

news-hot-hub

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

概述

目录结构