菜单
海外跨平台热文搜索 — 输入任意关键词（中文/英文），一次搜索 X / TikTok / YouTube 三平台热门内容，每平台 Top N（默认5）统一列表（平台/标题/作者/播放/点赞/评论/发布时间/链接），终端分组表格 + CSV 导出 + 交互式 HTML 报告（卡片/表格双视图）。按关键词语言智能优先同语言内容（中文词→中文优先，英文词→英文优先，其余语言兜底）。当用户需要搜索海外平台热点、跨平台内容对比、话题/竞品舆情监控、选题素材采集时使用。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/redfox-data/redfox-community --skill overseas-trending-search命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | overseas-trending-search |
| display_name | 海外跨平台热文搜索 |
| display_name_en | Overseas Trending Search |
| description | 海外跨平台热文搜索 — 输入任意关键词（中文/英文），一次搜索 X / TikTok / YouTube 三平台热门内容，每平台 Top N（默认5）统一列表（平台/标题/作者/播放/点赞/评论/发布时间/链接），终端分组表格 + CSV 导出 + 交互式 HTML 报告（卡片/表格双视图）。按关键词语言智能优先同语言内容（中文词→中文优先，英文词→英文优先，其余语言兜底）。当用户需要搜索海外平台热点、跨平台内容对比、话题/竞品舆情监控、选题素材采集时使用。 |
| description_zh | 输入关键词（中英文均可），一次搜索 X / TikTok / YouTube 三平台热门内容，每平台 Top N 统一字段列表（平台/标题/作者/播放/点赞/评论/发布时间），中文关键词优先中文内容、英文关键词优先英文内容，终端分组表格 + CSV + 交互式 HTML 报告（卡片/表格双视图），适合热点追踪、跨平台对比与素材采集。 |
| description_en | Search any keyword (Chinese or English) across X / TikTok / YouTube and get each platform's Top N trending posts in one unified list (platform/title/author/views/likes/comments/date). Language-aware ranking: a Chinese keyword surfaces Chinese content first, an English keyword surfaces English content first, other languages as fallback. Grouped terminal table + CSV export + interactive HTML report (card/table views) — ideal for trend tracking, cross-platform comparison and content research. |
| category | data-analysis |
| version | 1.3.0 |
| author | 红狐数据 |
| permissions | ["network","filesystem-write"] |
输入任意关键词（中文/英文），一键搜索 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 --csv-only --no-open
CSV / HTML 默认保存在 ~/Downloads/QoderOverseasTrending/。
向用户展示结果时，必须包含以下字段：
| 字段 | 说明 |
|---|---|
| 平台 | X / TikTok / YouTube（带平台标识色） |
| 标题 | 推文/视频文案摘要，仅展示前 20 字（HTML 表格悬停看全文） |
| 作者 | 作者昵称 |
| 播放数 | 千/万简写（如 47.3w），展示在作者之后 |
| 点赞数 | 千/万简写（如 62.9w） |
| 评论数 | 同上 |
| 发布时间 | YYYY-MM-DD HH:mm |
| 链接 | 可点击跳转原文 |
平台状态需在结果前明示：某平台上游故障时优雅降级并在报告中标注，不影响其他平台结果。
--top N 条（默认 5），按 --sort 指标在平台组内降序；终端与 HTML 均按平台分组展示。| 参数 | 说明 | 默认值 |
|---|---|---|
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 | 不自动打开浏览器 | — |
任选一种方式配置个人 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。
| 平台 | 接口 | 状态 |
|---|---|---|
| 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 并生成报告。