Skip to content
cccskills
FreePublished on GitHub

overseas-trending-search

海外跨平台热文搜索 — 输入任意关键词(中文/英文),一次搜索 X / TikTok / YouTube 三平台热门内容,每平台 Top N(默认5)统一列表(平台/标题/作者/播放/点赞/评论/发布时间/链接),终端分组表格 + CSV 导出 + 交互式 HTML 报告(卡片/表格双视图)。

按关键词语言智能优先同语言内容(中文词→中文优先,英文词→英文优先,其余语言兜底)。当用户需要搜索海外平台热点、跨平台内容对比、话题/竞品舆情监控、选题素材采集时使用。

The English summary is being prepared. Showing the original description.

Works withYouTubeTikTok
See how to install

Files included (11)

  • SKILL.md9.4 KB
  • assets/report_template.html9.7 KB
  • README.en.md4.0 KB
  • README.md3.7 KB
  • scripts/config.py3.2 KB
  • scripts/digest.py18.7 KB
  • scripts/sources/__init__.py304 B
  • scripts/sources/base.py5.0 KB
  • scripts/sources/tiktok_source.py2.3 KB
  • scripts/sources/x_source.py2.7 KB
  • scripts/sources/youtube_source.py6.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

海外跨平台热文搜索

输入任意关键词(中文/英文),一键搜索 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
链接可点击跳转原文

平台状态需在结果前明示:某平台上游故障时优雅降级并在报告中标注,不影响其他平台结果。

  • 条数约束:每个平台最多返回 --top N 条(默认 5),按 --sort 指标在平台组内降序;终端与 HTML 均按平台分组展示。
  • 语言优先分层:中文关键词时各平台组内优先展示中文内容、英文关键词优先英文内容,组内中/英文内容不足时以其他语言兜底;层内仍按排序指标降序。
  • HTML 报告支持「卡片 / 表格」双视图切换,表格视图含点赞/评论/播放/分享全字段。
  • YouTube 点赞/评论数由 videoDetail 详情接口逐条补全(默认全量覆盖搜索结果 20 条,本地化计数串已解析为整数)。

参数说明

参数说明默认值
keywords关键词,中英文均可,多词英文逗号分隔(位置参数)—
--days时间窗口:最近 N 天(0=不限)1
--platforms平台列表:x,tiktok,youtube 任意组合x,tiktok,youtube
--sort排序:views / likes / comments / timeviews
--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 实测)

平台接口状态
Xsearch / tweetDetail / tweetComments✅ 全部可用;search 必填 searchType(Top/Latest),缺失会误报 3203
TikToksearchVideo / awemeDetail / userAwemeList✅ 全部可用,searchVideo 自带全量互动数据
YouTubesearchVideo / 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 并生成报告。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

多平台账号主页视频提取器 — 输入平台名称和账号id/链接,自动拉取抖音/快手/B站/YouTube 四大平台主页作品,解析下载链接,支持批量下载。适用场景:竞品账号内容拆解与逐帧学习、收藏喜欢的创作者全部作品避免被删、批量搬运素材二次剪辑创作、保存自己账号作品做本地备份防丢失、课程/教程类视频离线囤货反复看、达人合作前快速拉取对方作品做背调分析。触发词:主页视频下载、批量下载视频、账号视频提取、快手主页下载、B站视频提取、YouTube频道下载、视频保存、无水印下载、竞品视频下载、博主视频备份。

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community448Updated Oct 19, 2026

深度A股情报调查与分析工具,支持A股情报调查、竞品分析、舆情监测、人物背景调查、信息交叉验证,生成结构化调查报告。当用户需要调查A股公司/行业/概念、调查竞品、追踪热点事件、了解人物背景、验证信息真实性时使用。触发词:A股情报、股票调查、财报分析、概念追踪、资金流向、情报调查、竞品分析、舆情调查、背景调查、信息验证、多源搜索。

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community448Updated Oct 19, 2026

B站AI信息源 — 每日扫描B站AI相关账号,按点赞量发现爆款视频,智能聚类话题后生成包含封面图、互动数据与订阅支持的HTML日报。同时基于热门话题执行AI情报调查,采用多引擎搜索与交叉验证,输出结构化调查报告。支持用户自定义关键词定向查询。⚠️数据每日15:00更新前一天数据,目标日期无数据时必须先告知用户并等待确认后才能调用接口,禁止自动获取。当用户需要AI-B站日报、B站爆款、AI-B站热点、B站AI内容、B站AI视频、B站情报或自定义关键词查询时使用。

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community448Updated Oct 19, 2026

B站评论分析工具。输入B站视频链接或BV号即可获取一级评论数据,支持分页浏览、评论情感分析(积极/负面/需求/竞品),生成精美 HTML 报告。当用户需要查看B站视频评论、分析评论舆情、了解用户反馈时使用。触发词:B站评论、B站视频评论、评论查询、评论分析、评论舆情、看评论、bilibili评论。

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community448Updated Oct 19, 2026

B站关键词搜账号工具。根据用户输入的关键词查询B站相关账号,支持按综合排序或粉丝数排序,返回账号列表(含粉丝数、等级、简介等信息)。当用户需要搜索B站账号、查找B站UP主、找B站同类账号时使用。

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community448Updated Oct 19, 2026

B站关键词搜作品工具。根据用户输入的关键词调用 Redfox 接口搜索B站最新视频,支持按排序方式和发布时间筛选,返回新鲜数据(非缓存/历史数据)。当用户要求搜索B站最新内容、查看某关键词下的视频数据时使用。触发词:B站搜索、B站最新视频、B站热门、B站搜作品、bilibili搜索。

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community448Updated Oct 19, 2026

See all skills by redfox-data

Report a problem with this skill