overseas-trending-search

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