Claude Skill

overseas-trending-search

海外跨平台热文搜索 — 输入任意关键词(中文/英文),一次搜索 X / TikTok / YouTube 三平台热门内容,每平台 Top N(默认5)统一列表(平台/标题/作者/播放/点赞/评论/发布时间/链接),终端分组表格 + CSV 导出 + 交互式 HTML 报告(卡片/表格双视图)。按关键词语言智能优先同语言内容(中文词→中文优先,英文词→英文优先,其余语言兜底)。当用户需要搜索海外平台热点、跨平台内容对比、话题/竞品舆情监控、选题素材采集时使用。

LLM Mart · 0 points · 3 views 0 listing impressions 0 install-command copies
Download redfox-data-redfox-community-skills_overseas-trending-search-5e7b435.zip · 26 KB

Install

skills CLI npx skills add https://github.com/redfox-data/redfox-community/tree/main/skills/overseas-trending-search
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install redfox-data-redfox-community@llmmart
Git 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
链接 可点击跳转原文

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

  • 条数约束:每个平台最多返回 --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


架构说明

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.

No comments yet.

Reviews (0)

No reviews yet.