TopHub Trends Analysis Skill
概述
这个 Skill 用于自动化获取 TopHub 热榜数据，并利用 Claude 分析当前最具传播潜力的热点话题，为内容创作者提供选题建议。
核心功能
- 实时热榜抓取：从 TopHub 获取全网最新热点
- AI 智能分析：使用 Claude 分析前 30 个热点的传播潜力
- 选题建议：识别高流量潜力话题并提供创作方向
- 数据存档：保存原始数据和分析报告
使用场景
- 每日选题灵感获取
- 热点追踪和分析
- 内容规划参考
- 趋势研究
工作流程
抓取热榜 → AI 分析 → 生成报告 → 保存文件详细步骤
- 抓取热榜：从 TopHub (https://tophub.today/hot) 获取实时数据
- 数据筛选：提取前 30 个热点话题
- AI 分析：使用 Claude 评估每个话题的传播潜力
- 生成报告：输出包含选题建议的 Markdown 报告
- 保存文件：同时保存原始 JSON 和分析报告
使用方法
运行脚本
在项目根目录下运行：
npx ts-node .claude/skills/tophub-trends/tophub.ts或者添加到 package.json 的 scripts 中：
{
"scripts": {
"skill:trends": "ts-node .claude/skills/tophub-trends/tophub.ts"
}
}然后运行：
npm run skill:trends输出结果
文件位置
脚本运行后，会在 defou-workflow-agent/outputs/trends/ 目录下生成两个文件：
outputs/trends/
├── tophub_hot_20260123_143022.json # 原始热榜数据
└── tophub_analysis_20260123_143022.md # AI 分析报告文件内容
1. 原始数据 (JSON)
{
"timestamp": "2026-01-23T14:30:22.000Z",
"total": 100,
"hotList": [
{
"rank": 1,
"title": "某某热点事件",
"url": "https://...",
"heat": "1234567",
"source": "微博"
},
...
]
}2. 分析报告 (Markdown)
# TopHub 热榜分析报告
**生成时间**：2026-01-23 14:30:22
## 📊 数据概览
- 总热点数：100
- 分析范围：Top 30
- 数据来源：TopHub
## 🔥 高潜力选题推荐
### 1. [热点标题]
- **热度**：⭐⭐⭐⭐⭐
- **传播潜力**：高
- **创作角度**：...
- **推荐理由**：...
### 2. [热点标题]
...
## 💡 创作建议
1. **热点借势**：...
2. **反直觉角度**：...
3. **深度分析**：...前置条件
- 已安装 Node.js 环境
- 已配置
.env文件：
- ANTHROPIC_API_KEY：Anthropic API Key - ANTHROPIC_BASE_URL：（可选）API Base URL - MOCK_MODE：（可选）设置为 true 使用模拟数据测试
- 网络连接正常（需要访问 TopHub）
配置选项
在 .env 文件中配置：
# 必需配置
ANTHROPIC_API_KEY=your_api_key
# 可选配置
ANTHROPIC_BASE_URL=https://api.anthropic.com
MOCK_MODE=false # 测试模式
TOPHUB_URL=https://tophub.today/hot # 自定义热榜 URL示例
运行输出
$ npm run skill:trends
🚀 TopHub Trends Analysis 启动...
📡 正在抓取 TopHub 热榜...
✅ 获取到 100 条热点
🧠 AI 正在分析前 30 个热点...
✅ 分析完成
💾 保存原始数据：outputs/trends/tophub_hot_20260123_143022.json
💾 保存分析报告：outputs/trends/tophub_analysis_20260123_143022.md
🎉 完成！分析报告示例
# TopHub 热榜分析报告
**生成时间**：2026-01-23 14:30:22
## 📊 数据概览
- 总热点数：100
- 分析范围：Top 30
- 数据来源：TopHub
## 🔥 高潜力选题推荐
### 1. AI 大模型价格战升级
- **热度**：⭐⭐⭐⭐⭐
- **传播潜力**：极高
- **创作角度**：
- 反直觉：价格战背后的真正赢家不是用户
- 深度分析：从价格战看 AI 行业的底层逻辑
- 人间清醒：免费的 AI 最贵
- **推荐理由**：科技热点 + 反共识角度 + 与普通人相关
### 2. 年轻人"反向消费"成趋势
- **热度**：⭐⭐⭐⭐
- **传播潜力**：高
- **创作角度**：
- 扎心算账：算一算"反向消费"能省多少钱
- 人性洞察：不是年轻人抠，是真的穷
- 结构分析：消费降级背后的阶层固化
- **推荐理由**：社会现象 + 年轻人痛点 + 易引发共鸣
## 💡 创作建议
1. **热点借势**：选择与目标受众相关的热点，避免纯娱乐八卦
2. **反直觉角度**：不要跟风，找到反共识的切入点
3. **深度分析**：从现象上升到本质，提供独特洞察
4. **时效性**：热点有时效性，建议 24 小时内完成创作注意事项
- 时效性：热榜数据实时变化，建议定期运行
- API 配额：每次运行会调用 Claude API，注意配额
- 网络要求：需要稳定的网络连接访问 TopHub
- 数据准确性：AI 分析仅供参考，最终选题需人工判断
故障排除
问题：抓取失败
可能原因：
- TopHub 网站访问受限
- 网络连接问题
- 网站结构变化
解决方案：
- 检查网络连接
- 使用
MOCK_MODE=true测试 - 更新爬虫代码适配新结构
问题：AI 分析质量不佳
可能原因：
- Prompt 需要优化
- 热点数据质量问题
解决方案：
- 调整分析 Prompt
- 增加数据筛选条件
- 使用更强大的模型
高级用法
定时任务
使用 cron 定时运行：
# 每天早上 8 点运行
0 8 * * * cd /path/to/project && npm run skill:trends自定义分析维度
修改脚本中的分析 Prompt，添加自定义维度：
const analysisPrompt = `
分析以下热点，评估维度：
1. 传播潜力
2. 与目标受众的相关性
3. 创作难度
4. 时效性
...
`;