redfox-data 海外跨平台热文搜索
输入任意关键词（中文/英文），一键搜索 X / TikTok / YouTube 三平台热门内容，每平台按点赞/播放/评论/发布时间取 Top N（默认 5），输出统一字段列表：平台、标题、作者、播放数、点赞数、评论数、发布时间、链接。
API 请求均携带
ChinaTrendingDigest-RedSkill标识。需先配置 API Key，通过环境变量 REDFOX_API_KEY 或 --api-key 参数传入。 架构为平台适配器模式：新平台（如 YouTube）只需新增适配器文件，主流程零改动。
使用场景
| 场景 | 示例 |
|---|---|
| 每日热点追踪 | 每天跑一次 "AI"，掌握三平台当日最热内容 |
| 跨平台对比 | 同一关键词对比 X / TikTok / YouTube 的热度与内容形态差异 |
| 话题事件追踪 | 搜 "新能源,EV" 追踪特定话题跨平台传播 |
| 竞品/舆情监控 | 搜品牌或产品名，看海外用户的真实讨论与爆款反馈 |
| 素材灵感采集 | 导出 CSV 做选题库与数据分析 |
| 账号内容挖掘 | TikTok 侧支持按作者作品列表下钻（userAwemeList） |
使用方法
# 基础用法：单关键词（默认最近 24 小时，按播放数降序）
python3 "$SKILL_PATH/scripts/digest.py" "AI"
# 中文关键词 / 多关键词（英文逗号分隔）
python3 "$SKILL_PATH/scripts/digest.py" "人工智能,AI agent"
# 放宽时间窗口到最近 3 天（TikTok 热门多为历史内容，建议放宽）
python3 "$SKILL_PATH/scripts/digest.py" "AI" --days 3
# 只跑指定平台
python3 "$SKILL_PATH/scripts/digest.py" "AI" --platforms tiktok
# 按发布时间排序
python3 "$SKILL_PATH/scripts/digest.py" "AI" --sort time
# 按点赞数排序 / 调整每平台返回条数（默认 5）
python3 "$SKILL_PATH/scripts/digest.py" "AI" --sort likes --top 10
# 仅导出 CSV / 不自动打开浏览器
python3 "$SKILL_PATH/scripts/digest.py" "AI" --csv-only --no-open
CSV / HTML 默认保存在 ~/Downloads/QoderOverseasTrending/。
返回结果展示规范
向用户展示结果时，必须包含以下字段：
| 字段 | 说明 |
|---|---|
| 平台 | X / TikTok / YouTube（带平台标识色） |
| 标题 | 推文/视频文案摘要，仅展示前 20 字（HTML 表格悬停看全文） |
| 作者 | 作者昵称 |
| 播放数 | 千/万简写（如 47.3w），展示在作者之后 |
| 点赞数 | 千/万简写（如 62.9w） |
| 评论数 | 同上 |
| 发布时间 | YYYY-MM-DD HH:mm |
| 链接 | 可点击跳转原文 |
平台状态需在结果前明示：某平台上游故障时优雅降级并在报告中标注，不影响其他平台结果。
- 条数约束：每个平台最多返回
--topN 条（默认 5），按--sort指标在平台组内降序；终端与 HTML 均按平台分组展示。 - 语言优先分层：中文关键词时各平台组内优先展示中文内容、英文关键词优先英文内容，组内中/英文内容不足时以其他语言兜底；层内仍按排序指标降序。
- HTML 报告支持「卡片 / 表格」双视图切换，表格视图含点赞/评论/播放/分享全字段。
- YouTube 点赞/评论数由 videoDetail 详情接口逐条补全（默认全量覆盖搜索结果 20 条，本地化计数串已解析为整数）。
参数说明
| 参数 | 说明 | 默认值 |
|---|---|---|
keywords |
关键词，中英文均可，多词英文逗号分隔（位置参数） | — |
--days |
时间窗口：最近 N 天（0=不限） | 1 |
--platforms |
平台列表：x,tiktok,youtube 任意组合 |
x,tiktok,youtube |
--sort |
排序：views / likes / comments / time |
views |
--top |
每平台最多返回条数（0=不限） | 5 |
--output-dir |
输出目录 | ~/Downloads/QoderOverseasTrending |
--api-key |
指定 RedFox API Key | — |
--csv-only |
仅生成 CSV，不生成 HTML | — |
--no-open |
不自动打开浏览器 | — |
API Key 配置
任选一种方式配置个人 Key：
| 方式 | 命令 |
|---|---|
| 环境变量（推荐） | export REDFOX_API_KEY=ak_你的密钥 |
| 命令行参数 | --api-key ak_你的密钥 |
| 配置文件 | echo '{"api_key":"ak_你的密钥"}' > ~/.qoder/apis/redfox.json |
注册地址：redfox.hk
架构说明
scripts/
├── digest.py # 主编排器：关键词×平台采集 → 时间过滤 → 排序 → 输出
├── config.py # RedFox 网关地址、密钥加载（三级优先级）
└── sources/ # 平台适配器（新增平台只需加一个文件并在 __init__ 登记）
├── base.py # BaseSource：统一 schema + 递增延迟重试
├── x_source.py # X：search/tweetDetail/tweetComments
├── tiktok_source.py # TikTok：searchVideo（一条请求自带点赞/评论数）
└── youtube_source.py# YouTube：searchVideo 列表 + videoDetail 补点赞/评论
统一记录 schema：platform / title / url / author / likes / comments / views / publish_ts / publish_time / keyword / shares。
平台接口状态（2026-07 实测）
| 平台 | 接口 | 状态 |
|---|---|---|
| X | search / tweetDetail / tweetComments | ✅ 全部可用；search 必填 searchType（Top/Latest），缺失会误报 3203 |
| TikTok | searchVideo / awemeDetail / userAwemeList | ✅ 全部可用，searchVideo 自带全量互动数据 |
| YouTube | searchVideo / videoDetail / videoComments | ✅ 全部可用；searchVideo 返回播放数与相对发布时间，点赞/评论由 videoDetail 补全（Top 10） |
依赖
pip3 install requests
常见问题
Q：X 搜索返回 3203 报错？
A：X search 接口的 searchType 为必填参数（Top 热门 / Latest 最新），缺失时 RedFox 会返回误导性的 3203「X能力调用失败」。本技能已内置该参数；另外过期/无效的 tweetId 调 tweetDetail 也会报 3203。
Q：TikTok 搜索需要调详情接口补数据吗？ A：不需要。searchVideo 一次请求即返回点赞/评论/播放/分享数和发布时间，日常概要足够。
Q：YouTube 的点赞/评论数据从哪里来的？
A：searchVideo 列表接口只返回播放数，点赞/评论需调 videoDetail 逐条补全。技能默认对搜索结果 20 条全量补详情（youtube_source.py 中 detail_top 可调小以省积分），因此所有视频都有真实点赞/评论数；仍为 0 代表该视频确实无点赞/评论。YouTube 平台本身不公开分享数，故分享列恒为 0。
Q：每平台返回多少条？
A：默认每平台按排序指标（点赞/播放/评论/发布时间）取 Top 5，--top N 可调（0=不限）。各平台独立分组、组内降序，互不影响。
Q：为什么默认参数下看不到 TikTok 内容？
A：TikTok searchVideo 返回的是热门视频，发布时间多为数天乃至数月前，默认 --days 1（最近 24 小时）会将其整体过滤。想看 TikTok 热门请加 --days 0 或 --days 7；过滤时终端会按平台提示被排除的条数。
Q：搜中文关键词，为什么 X 上的日文内容被排到后面了？ A：技能内置语言优先分层：关键词为中文时，各平台组内优先展示中文内容、其次英文，日文等其他语言兜底（解决「南海」命中日文「南海電鉄」这类歧义问题）；英文关键词同理优先英文内容。语言识别基于标题字符集（汉字/假名/谚文/拉丁字母），无第三方依赖。
Q：想做每日定时运行？
A：可以让 AI 注册定时任务，每天自动执行 digest.py 并生成报告。