overseas-trending-search
海外跨平台热文搜索 — 输入任意关键词(中文/英文),一次搜索 X / TikTok / YouTube 三平台热门内容,每平台 Top N(默认5)统一列表(平台/标题/作者/播放/点赞/评论/发布时间/链接),终端分组表格 + CSV 导出 + 交互式 HTML 报告(卡片/表格双视图)。按关键词语言智能优先同语言内容(中文词→中文优先,英文词→英文优先,其余语言兜底)。当用户需要搜索海外平台热点、跨平台内容对比、话题/竞品舆情监控、选题素材采集时使用。
Install
npx skills add https://github.com/redfox-data/redfox-community/tree/main/skills/overseas-trending-search
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install redfox-data-redfox-community@llmmart
git clone https://github.com/redfox-data/redfox-community.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole redfox-data/redfox-community collection as a plugin from our marketplace. Git is the plain clone.
README
海外跨平台热文搜索 / overseas-trending-search
简介
海外跨平台热文搜索是一款跨平台热点洞察工具,输入任意关键词(中文/英文),即可一键搜索 X、TikTok、YouTube 三大海外平台的热门内容,智能识别关键词语言并优先展示同语言结果,输出统一字段列表与交互式 HTML 报告。
核心价值
- 🔍 三平台覆盖:一键搜索 X / TikTok / YouTube 三大海外平台的热门内容
- 🌐 智能语言优先:中文关键词优先中文内容,英文关键词优先英文内容,解决跨语言歧义
- 📊 多格式输出:终端分组表格 + CSV 数据导出 + 交互式 HTML 报告(卡片/表格双视图)
- ⚡ 灵活排序:支持按播放数/点赞数/评论数/发布时间自由排序,每平台独立取 Top N
适用对象
- ✍️ 内容创作者 — 每日热点追踪,获取选题灵感与素材
- 📈 市场运营 — 跨平台内容对比,了解不同平台内容形态差异
- 🏢 品牌方 — 竞品舆情监控,查看海外用户真实讨论
- 📊 数据分析师 — 话题事件追踪,量化跨平台传播效果
功能特性
核心功能
- 🔍 三平台搜索:覆盖 X、TikTok、YouTube 三大海外平台的关键词搜索
- 🌐 语言智能优先:中文关键词各平台优先展示中文内容,英文关键词优先英文内容,其余语言兜底
- 📋 统一字段列表:平台、标题、作者、播放数、点赞数、评论数、发布时间、链接,跨平台一致
- 📊 多维度排序:支持按播放数/点赞数/评论数/发布时间排序,每平台独立取 Top N
- 📄 多格式输出:终端分组表格展示、CSV 数据导出、交互式 HTML 报告(卡片/表格双视图)
- 🔗 多关键词支持:英文逗号分隔多个关键词,一次搜索同时命中
- 🔄 错误容忍:某平台异常时自动跳过,不影响其他平台结果
使用指南
直接用自然语言描述需求,无需记忆命令。
常用说法速查
| 意图 | 示例话术 | 效果 |
|---|---|---|
| 热点搜索 | 「搜索 AI 在海外平台的热门内容」 | 三平台搜索 + 终端表格 + CSV + HTML |
| 指定平台 | 「帮我看 TikTok 上关于 AI 的热门视频」 | 仅搜索指定平台 |
| 跨平台对比 | 「对比 X 和 YouTube 上 iPhone 16 的热度」 | 指定平台对比分析 |
| 多关键词 | 「搜索 人工智能,AI agent 的海外热文」 | 同时搜索多个关键词 |
| 竞品监控 | 「搜一下 Tesla 在海外的讨论」 | 品牌竞品舆情追踪 |
| 素材采集 | 「导出 AI 相关的海外热文 CSV」 | 导出 CSV 做选题库 |
输出示例
搜索完成后,你将依次收到:
终端分组表格 → 按平台分组展示 Top N 结果,含标题、作者、播放/点赞/评论/发布时间、链接 CSV 导出 → 结构化数据导出,便于数据分析与存档 HTML 报告 → 交互式报告,支持卡片/表格双视图切换,可离线保存
使用场景
| 场景 | 角色 | 示例问法 | 收益 |
|---|---|---|---|
| 每日热点追踪 | 内容创作者 | 「搜索 AI 今天的热门内容」 | 掌握三平台当日最热内容 |
| 跨平台对比 | 市场运营 | 「对比 X 和 YouTube 上 Vision Pro 的热度」 | 了解不同平台内容形态差异 |
| 话题事件追踪 | 品牌方 | 「搜 新能源,EV 近 7 天传播情况」 | 追踪特定话题跨平台传播 |
| 竞品舆情监控 | 数据分析师 | 「搜一下 Tesla 在海外的真实讨论」 | 看海外用户真实反馈 |
| 素材灵感采集 | 自媒体运营 | 「导出 AI 相关海外热文 CSV」 | 导出数据做选题库 |
Skill manifest
海外跨平台热文搜索
输入任意关键词(中文/英文),一键搜索 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 并生成报告。
Files (redfox-community)
-
assets
-
report_template.html 9.7 KB · in bundle
-
-
scripts
-
sources
-
base.py 5 KB
Loading… -
tiktok_source.py 2.3 KB
Loading… -
x_source.py 2.7 KB
Loading… -
youtube_source.py 6.4 KB
Loading… -
__init__.py 304 B
Loading…
-
-
config.py 3.2 KB
Loading… -
digest.py 18.7 KB
Loading…
-
-
README.en.md 4 KB
Loading… -
README.md 3.7 KB
# 海外跨平台热文搜索 / overseas-trending-search --- ## 简介 海外跨平台热文搜索是一款跨平台热点洞察工具,输入任意关键词(中文/英文),即可一键搜索 X、TikTok、YouTube 三大海外平台的热门内容,智能识别关键词语言并优先展示同语言结果,输出统一字段列表与交互式 HTML 报告。 **核心价值** - 🔍 **三平台覆盖**:一键搜索 X / TikTok / YouTube 三大海外平台的热门内容 - 🌐 **智能语言优先**:中文关键词优先中文内容,英文关键词优先英文内容,解决跨语言歧义 - 📊 **多格式输出**:终端分组表格 + CSV 数据导出 + 交互式 HTML 报告(卡片/表格双视图) - ⚡ **灵活排序**:支持按播放数/点赞数/评论数/发布时间自由排序,每平台独立取 Top N **适用对象** - ✍️ 内容创作者 — 每日热点追踪,获取选题灵感与素材 - 📈 市场运营 — 跨平台内容对比,了解不同平台内容形态差异 - 🏢 品牌方 — 竞品舆情监控,查看海外用户真实讨论 - 📊 数据分析师 — 话题事件追踪,量化跨平台传播效果 --- ## 功能特性 ### 核心功能 - 🔍 **三平台搜索**:覆盖 X、TikTok、YouTube 三大海外平台的关键词搜索 - 🌐 **语言智能优先**:中文关键词各平台优先展示中文内容,英文关键词优先英文内容,其余语言兜底 - 📋 **统一字段列表**:平台、标题、作者、播放数、点赞数、评论数、发布时间、链接,跨平台一致 - 📊 **多维度排序**:支持按播放数/点赞数/评论数/发布时间排序,每平台独立取 Top N - 📄 **多格式输出**:终端分组表格展示、CSV 数据导出、交互式 HTML 报告(卡片/表格双视图) - 🔗 **多关键词支持**:英文逗号分隔多个关键词,一次搜索同时命中 - 🔄 **错误容忍**:某平台异常时自动跳过,不影响其他平台结果 --- ## 使用指南 直接用自然语言描述需求,无需记忆命令。 ### 常用说法速查 | 意图 | 示例话术 | 效果 | |------|---------|------| | 热点搜索 | 「搜索 AI 在海外平台的热门内容」 | 三平台搜索 + 终端表格 + CSV + HTML | | 指定平台 | 「帮我看 TikTok 上关于 AI 的热门视频」 | 仅搜索指定平台 | | 跨平台对比 | 「对比 X 和 YouTube 上 iPhone 16 的热度」 | 指定平台对比分析 | | 多关键词 | 「搜索 人工智能,AI agent 的海外热文」 | 同时搜索多个关键词 | | 竞品监控 | 「搜一下 Tesla 在海外的讨论」 | 品牌竞品舆情追踪 | | 素材采集 | 「导出 AI 相关的海外热文 CSV」 | 导出 CSV 做选题库 | ### 输出示例 搜索完成后,你将依次收到: > **终端分组表格** → 按平台分组展示 Top N 结果,含标题、作者、播放/点赞/评论/发布时间、链接 > **CSV 导出** → 结构化数据导出,便于数据分析与存档 > **HTML 报告** → 交互式报告,支持卡片/表格双视图切换,可离线保存 --- ## 使用场景 | 场景 | 角色 | 示例问法 | 收益 | |------|------|---------|------| | 每日热点追踪 | 内容创作者 | 「搜索 AI 今天的热门内容」 | 掌握三平台当日最热内容 | | 跨平台对比 | 市场运营 | 「对比 X 和 YouTube 上 Vision Pro 的热度」 | 了解不同平台内容形态差异 | | 话题事件追踪 | 品牌方 | 「搜 新能源,EV 近 7 天传播情况」 | 追踪特定话题跨平台传播 | | 竞品舆情监控 | 数据分析师 | 「搜一下 Tesla 在海外的真实讨论」 | 看海外用户真实反馈 | | 素材灵感采集 | 自媒体运营 | 「导出 AI 相关海外热文 CSV」 | 导出数据做选题库 | -
SKILL.md 9.4 KB
--- 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) | --- ## 使用方法 ```bash # 基础用法:单关键词(默认最近 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` / `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](https://redfox.hk/settings/api-keys?source=redskill) --- ## 架构说明 ``` 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) | --- ## 依赖 ```bash 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` 并生成报告。
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.