Claude Skill

toutiao-search

今日头条爆款内容查询 — 输入关键词搜索今日头条最新作品(图文/视频),支持按阅读量/时间排序、限定时间范围,终端表格展示 + CSV 导出 + 交互式 HTML 报告。当用户需要搜索今日头条热门内容、追踪头条热点、分析爆款文章时使用。

LLM Mart · 0 points · 3 views 0 listing impressions 0 install-command copies
Download redfox-data-redfox-community-skills_toutiao-search-d2e24f0.zip · 29 KB

Install

skills CLI npx skills add https://github.com/redfox-data/redfox-community/tree/main/skills/toutiao-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

今日头条爆款内容查询 / toutiao-search


简介

输入关键词就能搜到今日头条刚发布的作品,能按阅读量或发布时间排序、限定最近几小时内内容,给到你的都是平台刚更新的新鲜内容,不会拿旧缓存数据糊弄你。

核心价值

  • 内容新鲜不滞后:每次搜索都直接拉取平台最新发布的作品,只给刚发的内容,不用老旧存档、缓存数据。
  • 筛选方式灵活好用:能按阅读量或发布时间排序,还能限定最近几小时内内容,自由搭配条件查找。
  • 图文视频都能搜:图文和视频作品一网打尽,想看哪种都能找到,不会遗漏任何类型。
  • 翻页查看不遗漏:结果多的时候可以一页页翻着看,不遗漏任何一条内容。
  • 数据指标一目了然:阅读量、点赞、评论、转发等互动数据直观展示,还能自动导出 CSV 和交互式 HTML 报告,下载即用。

适用对象

  • 🔍 内容创作者 — 快速了解今日头条上同赛道最新趋势与热门选题,获取创作灵感。
  • 📊 运营 / 数据分析 — 追踪关键词相关内容在头条的数据表现,掌握流量趋势。
  • 🏢 品牌 / MCN — 监控竞品与行业关键词在今日头条的最新内容表现,辅助策略决策。

功能特性

核心功能

  • 关键词搜索:输入任意关键词搜索今日头条最新爆款作品。
  • 双排序切换:按阅读量(views)或发布时间(time)降序排列,快速定位高质量或最新内容。
  • 时间过滤:--hours N 限定最近 N 小时内的新鲜内容,拒绝过期数据。
  • 视频筛选:--video-only 只返回视频类作品,精准找视频爆款。
  • 翻页浏览:--pages N 控制翻页次数,每页约 10 条,默认 3 页。
  • 终端表格输出:标题、作者、阅读、点赞、评论、转发、发布时间、类型一览无余。
  • CSV 自动导出:UTF-8 BOM 编码 CSV,Excel 直接打开不乱码。
  • HTML 交互报告:深色主题,图文/视频标签区分,作品卡片点击跳转原文,支持页内搜索。

密钥获取与安全说明

  • 本技能需要使用环境变量:REDFOX_API_KEY。
  • REDFOX_API_KEY 由 红狐 hub 提供。
  • 请前往 红狐 hub 注册账号,获取 REDFOX_API_KEY。
  • 配置设备环境变量 REDFOX_API_KEY 后使用本技能。
  • 在提供密钥前,请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。
  • 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。

使用指南

直接用自然语言描述需求,无需记忆命令。

常用说法速查

意图 示例话术 效果
搜某个话题内容 「搜一下今日头条 AI 相关内容」 按阅读量排序搜索并展示结果
指定排序方式 「按最新发布搜索大模型相关作品」 切换为按发布时间排序后搜索
限定时间范围 「搜索最近 24 小时新能源相关作品」 设置 --hours 24,只返回一天内作品
只看视频内容 「搜一下测评类的视频」 开启 --video-only,只返回视频作品
翻页查看更多 「多翻几页」/「看更多结果」 增加 --pages 翻页获取更多数据
导出数据 「导出 CSV」/「生成 HTML 报告」 自动生成 CSV 和交互式 HTML 报告

输出示例

查询完成后,你将看到类似以下格式的表格:

📊 关键词「AI」查询到 30 条作品(排序:按阅读量 | 时间范围:不限 | 第 1-3 页),以下是详细数据:

# 标题 作者 阅读 点赞 评论 转发 发布时间 类型
1 某某爆款文章标题最多三十字... 某某作者 12w 3.2k 412 89 2026-06-30 14:30 图文
2 另一个热门视频标题展示... 另一位作者 8.5w 1.5k 230 56 2026-06-30 12:00 视频

📄 CSV 和 HTML 报告已保存至 ~/Downloads/QoderToutiaoSearch/。

(数据以终端表格形式展示,CSV 和 HTML 同时自动保存。)


使用场景

场景 角色 示例问法 收益
热点话题追踪 内容创作者 「搜一下今日头条 AI 相关内容」 第一时间掌握头条平台最新话题动向
爆款内容分析 运营 / 数据 「搜大模型,按阅读量排序」 快速找到高阅读量爆款,研究爆文规律
竞品内容监控 品牌运营 「搜品牌关键词最近 24 小时内容」 追踪竞品在头条的最新投放与表现
选题灵感采集 创作者 「搜新能源,导出 CSV 分析」 批量获取数据找选题方向,用数据说话
视频内容挖掘 MCN 「搜测评,只看视频类」 精准筛选视频爆款,评估内容方向

Skill manifest

今日头条爆款内容查询

输入关键词搜索今日头条最新作品(图文/视频),终端表格展示 + CSV 导出 + 交互式 HTML 报告。

需先配置 API Key,通过环境变量 REDFOX_API_KEY 或 --api-key 参数传入。 搜索范围:今日头条平台最新发布的作品,实时拉取,无缓存延迟。


使用场景

当你需要执行以下任务时,应优先使用本技能:

场景 示例
热点话题追踪 搜 "AI" 了解今日头条上最新的 AI 相关内容
爆款内容分析 搜 "大模型" 找出阅读量最高的爆款文章
竞品内容监控 搜品牌关键词,追踪竞品在今日头条的投放内容
选题灵感采集 搜 "新能源" 批量导出 CSV 做数据分析找选题
舆情快速了解 搜某事件关键词,快速了解头条平台讨论风向
视频内容挖掘 搜 "测评" 配合 --video-only 筛选视频类爆款

使用方法

# 基础搜索
python3 "$SKILL_PATH/scripts/search.py" "关键词"

# 按阅读量排序(默认按时间)
python3 "$SKILL_PATH/scripts/search.py" "AI" --sort views

# 限定最近 24 小时内发布的作品
python3 "$SKILL_PATH/scripts/search.py" "大模型" --hours 24

# 只查视频类作品
python3 "$SKILL_PATH/scripts/search.py" "测评" --video-only

# 多页翻页,获取更多结果
python3 "$SKILL_PATH/scripts/search.py" "新能源汽车" --pages 5

# 仅导出 CSV,不生成 HTML
python3 "$SKILL_PATH/scripts/search.py" "AI" --csv-only

# 不自动打开浏览器
python3 "$SKILL_PATH/scripts/search.py" "AI" --no-open

终端输出按指定排序方式(时间/阅读量)降序排列;结果较少或无结果时自动提示。

HTML 报告特性:深色主题 · 点击搜索按钮查询 · 作品卡片点击跳转原文 · 图文/视频标签区分 · 分页加载。

CSV / HTML 默认保存在 ~/Downloads/QoderToutiaoSearch/。


返回结果展示规范

向用户展示搜索结果时,必须使用以下完整字段列表,不得省略:

序号 字段 说明
# 排名序号 从 1 开始
标题 作品标题 最多显示 30 字,超出截断
作者 作者昵称 —
阅读量 viewCount 用千/万简写(如 3.2k、12w)
点赞数 likeCount 同上
评论数 commentCount 同上
转发数 repostCount 同上
发布时间 publishTime 格式:YYYY-MM-DD HH:mm
类型 workType 图文 / 视频
链接 workUrl 可点击跳转原文

表格示例:

| # | 标题 | 作者 | 阅读 | 点赞 | 评论 | 转发 | 发布时间 | 类型 |
|---|------|------|------|------|------|------|----------|------|
| 1 | 某某爆款文章标题... | 某某作者 | 3.2k | 412 | 89 | 56 | 2026-06-28 14:30 | 图文 |

参数说明

参数 说明 默认值
keyword 搜索关键词(必填,位置参数) —
--sort 排序方式:views / time views
--hours 限定最近 N 小时内发布的作品(0=不限) 0
--pages 翻页次数(每页约 10 条) 3
--video-only 只返回视频类作品 —
--output-dir 输出目录 ~/Downloads/QoderToutiaoSearch
--api-key 指定 API Key —
--no-open 不自动打开浏览器 —
--csv-only 仅生成 CSV,不生成 HTML —
--port HTML 本地服务端口 8767

API Key 配置

任选一种方式配置个人 Key:

方式 命令
环境变量(推荐) export REDFOX_API_KEY=ak_你的密钥
命令行参数 --api-key ak_你的密钥
配置文件 echo '{"api_key":"ak_你的密钥"}' > ~/.qoder/apis/redfox.json

注册地址:redfox.hk


💳 积分不足充值(支付宝接管)

当脚本以退出码 3 结束、并在 stdout 打印 ===PAYMENT_REQUIRED_JSON_START=== 区块时,表示当前 API Key 积分不足(接口 code=3210,兼容 3201)。响应体 data 内含结构化支付信息:cashierUrl(支付宝收银台链接)、amount(订单金额,元)、goodsName(商品名称)、outTradeNo(订单号)。

脚本退出码说明:0 正常返回;1 参数/鉴权/接口错误;3 积分不足,需要充值(按下述流程处理)。

完整的前置检查、alipay-bot trigger-payment-signal → submit-payment → poll-payment-status 编排步骤、钱包绑定处理、支付接管规则与失败处理,统一见 references/alipay-recharge.md(通用流程,可被其他 skill 复用)。submit-payment 后由 Agent 用 poll-payment-status --out-shake-no <查询单号> 自动监听支付回调到账,无需用户再手动确认;到账(outcome=success)后自动用用户原始的查询参数重新运行 scripts/search.py 输出结果。


功能特点

  • 双接口深度查询:searchWork 搜索列表 + workDetail 获取完整数据(阅读/点赞/评论/转发/分享)
  • 时间过滤:限定最近 N 小时内的新鲜内容,拒绝过期缓存
  • 灵活排序:按发布时间或阅读量降序排列
  • 视频筛选:--video-only 只找视频类爆款
  • 终端表格:标题、作者、阅读、点赞、评论、转发、发布时间、链接、类型
  • CSV 导出:自动生成 UTF-8 BOM 编码的 CSV
  • HTML 交互报告:深色主题,图文/视频标签区分,支持页内搜索
  • 本地代理服务:避免浏览器跨域限制,支持页内实时搜索

依赖

pip3 install requests

常见问题

Q:能搜到每条爆款吗? A:能保证每次的关键词都有作品。

Q:搜索范围覆盖多久之前的作品? A:目前提供近 1 年的作品,优先会覆盖近期发布的内容。

Q:为什么搜索后还要等待详情查询? A:搜索接口只返回基础信息,同时提供单作品补全阅读量、点赞、转发等完整指标,让数据更完整。

Q:搜索后如何保存数据? A:可以让 AI 为你导出 Excel,也可以让 AI 导出 HTML。

Q:额度用完怎么办? A:前往 redfox.hk 注册获取 Token。

Q:最多能获取多少条? A:每页约 10 条,默认翻 3 页(约 30 条)。可通过 --pages 参数调整。

Files (redfox-community)
  • assets
    • report_template.html 29.3 KB · in bundle
  • references
    • alipay-recharge.md 6.2 KB
      Loading…
  • scripts
    • search.py 33.6 KB
      Loading…
  • README.en.md 4.9 KB
    Loading…
  • README.md 5 KB
    # 今日头条爆款内容查询 / toutiao-search
    
    ---
    
    ## 简介
    
    输入关键词就能搜到今日头条刚发布的作品,能按阅读量或发布时间排序、限定最近几小时内内容,给到你的都是平台刚更新的新鲜内容,不会拿旧缓存数据糊弄你。
    
    **核心价值**
    
    - **内容新鲜不滞后**:每次搜索都直接拉取平台最新发布的作品,只给刚发的内容,不用老旧存档、缓存数据。
    - **筛选方式灵活好用**:能按阅读量或发布时间排序,还能限定最近几小时内内容,自由搭配条件查找。
    - **图文视频都能搜**:图文和视频作品一网打尽,想看哪种都能找到,不会遗漏任何类型。
    - **翻页查看不遗漏**:结果多的时候可以一页页翻着看,不遗漏任何一条内容。
    - **数据指标一目了然**:阅读量、点赞、评论、转发等互动数据直观展示,还能自动导出 CSV 和交互式 HTML 报告,下载即用。
    
    **适用对象**
    
    - 🔍 **内容创作者** — 快速了解今日头条上同赛道最新趋势与热门选题,获取创作灵感。
    - 📊 **运营 / 数据分析** — 追踪关键词相关内容在头条的数据表现,掌握流量趋势。
    - 🏢 **品牌 / MCN** — 监控竞品与行业关键词在今日头条的最新内容表现,辅助策略决策。
    
    ---
    
    ## 功能特性
    
    ### 核心功能
    
    - **关键词搜索**:输入任意关键词搜索今日头条最新爆款作品。
    - **双排序切换**:按阅读量(`views`)或发布时间(`time`)降序排列,快速定位高质量或最新内容。
    - **时间过滤**:`--hours N` 限定最近 N 小时内的新鲜内容,拒绝过期数据。
    - **视频筛选**:`--video-only` 只返回视频类作品,精准找视频爆款。
    - **翻页浏览**:`--pages N` 控制翻页次数,每页约 10 条,默认 3 页。
    - **终端表格输出**:标题、作者、阅读、点赞、评论、转发、发布时间、类型一览无余。
    - **CSV 自动导出**:UTF-8 BOM 编码 CSV,Excel 直接打开不乱码。
    - **HTML 交互报告**:深色主题,图文/视频标签区分,作品卡片点击跳转原文,支持页内搜索。
    
    ---
    
    ## 密钥获取与安全说明
    
    - 本技能需要使用环境变量:`REDFOX_API_KEY`。
    - `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?source=github) 提供。
    - 请前往 [红狐 hub](https://redfox.hk?source=github) 注册账号,获取 `REDFOX_API_KEY`。
    - 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。
    - 在提供密钥前,请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。
    - 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。
    
    ---
    
    ## 使用指南
    
    直接用自然语言描述需求,无需记忆命令。
    
    ### 常用说法速查
    
    | 意图 | 示例话术 | 效果 |
    | ---- | -------- | ---- |
    | 搜某个话题内容 | 「搜一下今日头条 AI 相关内容」 | 按阅读量排序搜索并展示结果 |
    | 指定排序方式 | 「按最新发布搜索大模型相关作品」 | 切换为按发布时间排序后搜索 |
    | 限定时间范围 | 「搜索最近 24 小时新能源相关作品」 | 设置 `--hours 24`,只返回一天内作品 |
    | 只看视频内容 | 「搜一下测评类的视频」 | 开启 `--video-only`,只返回视频作品 |
    | 翻页查看更多 | 「多翻几页」/「看更多结果」 | 增加 `--pages` 翻页获取更多数据 |
    | 导出数据 | 「导出 CSV」/「生成 HTML 报告」 | 自动生成 CSV 和交互式 HTML 报告 |
    
    ### 输出示例
    
    查询完成后,你将看到类似以下格式的表格:
    
    > 📊 关键词「**AI**」查询到 **30 条**作品(排序:按阅读量 | 时间范围:不限 | 第 1-3 页),以下是详细数据:
    
    | # | 标题 | 作者 | 阅读 | 点赞 | 评论 | 转发 | 发布时间 | 类型 |
    |---|------|------|------|------|------|------|----------|------|
    | 1 | [某某爆款文章标题最多三十字...](链接) | 某某作者 | 12w | 3.2k | 412 | 89 | 2026-06-30 14:30 | 图文 |
    | 2 | [另一个热门视频标题展示...](链接) | 另一位作者 | 8.5w | 1.5k | 230 | 56 | 2026-06-30 12:00 | 视频 |
    
    > 📄 CSV 和 HTML 报告已保存至 `~/Downloads/QoderToutiaoSearch/`。
    
    (数据以终端表格形式展示,CSV 和 HTML 同时自动保存。)
    
    ---
    
    ## 使用场景
    
    | 场景 | 角色 | 示例问法 | 收益 |
    | ---- | ---- | -------- | ---- |
    | 热点话题追踪 | 内容创作者 | 「搜一下今日头条 AI 相关内容」 | 第一时间掌握头条平台最新话题动向 |
    | 爆款内容分析 | 运营 / 数据 | 「搜大模型,按阅读量排序」 | 快速找到高阅读量爆款,研究爆文规律 |
    | 竞品内容监控 | 品牌运营 | 「搜品牌关键词最近 24 小时内容」 | 追踪竞品在头条的最新投放与表现 |
    | 选题灵感采集 | 创作者 | 「搜新能源,导出 CSV 分析」 | 批量获取数据找选题方向,用数据说话 |
    | 视频内容挖掘 | MCN | 「搜测评,只看视频类」 | 精准筛选视频爆款,评估内容方向 |
    
  • SKILL.md 6.9 KB
    ---
    name: toutiao-search
    description: 今日头条爆款内容查询 — 输入关键词搜索今日头条最新作品(图文/视频),支持按阅读量/时间排序、限定时间范围,终端表格展示 + CSV 导出 + 交互式 HTML 报告。当用户需要搜索今日头条热门内容、追踪头条热点、分析爆款文章时使用。当接口返回积分不足(code=3210)时,自动唤起支付宝完成充值后继续查询。
    ---
    
    # 今日头条爆款内容查询
    
    输入关键词搜索今日头条最新作品(图文/视频),终端表格展示 + CSV 导出 + 交互式 HTML 报告。
    
    > 需先配置 API Key,通过环境变量 REDFOX_API_KEY 或 --api-key 参数传入。
    > 搜索范围:今日头条平台**最新发布的作品**,实时拉取,无缓存延迟。
    
    ---
    
    ## 使用场景
    
    当你需要执行以下任务时,应优先使用本技能:
    
    | 场景 | 示例 |
    |------|------|
    | **热点话题追踪** | 搜 "AI" 了解今日头条上最新的 AI 相关内容 |
    | **爆款内容分析** | 搜 "大模型" 找出阅读量最高的爆款文章 |
    | **竞品内容监控** | 搜品牌关键词,追踪竞品在今日头条的投放内容 |
    | **选题灵感采集** | 搜 "新能源" 批量导出 CSV 做数据分析找选题 |
    | **舆情快速了解** | 搜某事件关键词,快速了解头条平台讨论风向 |
    | **视频内容挖掘** | 搜 "测评" 配合 --video-only 筛选视频类爆款 |
    
    ---
    
    ## 使用方法
    
    ```bash
    # 基础搜索
    python3 "$SKILL_PATH/scripts/search.py" "关键词"
    
    # 按阅读量排序(默认按时间)
    python3 "$SKILL_PATH/scripts/search.py" "AI" --sort views
    
    # 限定最近 24 小时内发布的作品
    python3 "$SKILL_PATH/scripts/search.py" "大模型" --hours 24
    
    # 只查视频类作品
    python3 "$SKILL_PATH/scripts/search.py" "测评" --video-only
    
    # 多页翻页,获取更多结果
    python3 "$SKILL_PATH/scripts/search.py" "新能源汽车" --pages 5
    
    # 仅导出 CSV,不生成 HTML
    python3 "$SKILL_PATH/scripts/search.py" "AI" --csv-only
    
    # 不自动打开浏览器
    python3 "$SKILL_PATH/scripts/search.py" "AI" --no-open
    ```
    
    终端输出按**指定排序方式**(时间/阅读量)降序排列;结果较少或无结果时自动提示。
    
    HTML 报告特性:深色主题 · 点击搜索按钮查询 · 作品卡片点击跳转原文 · 图文/视频标签区分 · 分页加载。
    
    CSV / HTML 默认保存在 `~/Downloads/QoderToutiaoSearch/`。
    
    ---
    
    ## 返回结果展示规范
    
    向用户展示搜索结果时,**必须**使用以下完整字段列表,不得省略:
    
    | 序号 | 字段 | 说明 |
    |------|------|------|
    | # | 排名序号 | 从 1 开始 |
    | 标题 | 作品标题 | 最多显示 30 字,超出截断 |
    | 作者 | 作者昵称 | — |
    | 阅读量 | viewCount | 用千/万简写(如 3.2k、12w) |
    | 点赞数 | likeCount | 同上 |
    | 评论数 | commentCount | 同上 |
    | 转发数 | repostCount | 同上 |
    | 发布时间 | publishTime | 格式:`YYYY-MM-DD HH:mm` |
    | 类型 | workType | 图文 / 视频 |
    | 链接 | workUrl | 可点击跳转原文 |
    
    **表格示例:**
    
    ```
    | # | 标题 | 作者 | 阅读 | 点赞 | 评论 | 转发 | 发布时间 | 类型 |
    |---|------|------|------|------|------|------|----------|------|
    | 1 | 某某爆款文章标题... | 某某作者 | 3.2k | 412 | 89 | 56 | 2026-06-28 14:30 | 图文 |
    ```
    
    ---
    
    ## 参数说明
    
    | 参数 | 说明 | 默认值 |
    |------|------|--------|
    | `keyword` | 搜索关键词(必填,位置参数) | — |
    | `--sort` | 排序方式:`views` / `time` | `views` |
    | `--hours` | 限定最近 N 小时内发布的作品(0=不限) | `0` |
    | `--pages` | 翻页次数(每页约 10 条) | `3` |
    | `--video-only` | 只返回视频类作品 | — |
    | `--output-dir` | 输出目录 | `~/Downloads/QoderToutiaoSearch` |
    | `--api-key` | 指定 API Key | — |
    | `--no-open` | 不自动打开浏览器 | — |
    | `--csv-only` | 仅生成 CSV,不生成 HTML | — |
    | `--port` | HTML 本地服务端口 | `8767` |
    
    ---
    
    ## 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=github)
    
    ---
    
    ## 💳 积分不足充值(支付宝接管)
    
    当脚本以**退出码 3** 结束、并在 stdout 打印 `===PAYMENT_REQUIRED_JSON_START===` 区块时,表示当前 API Key 积分不足(接口 `code=3210`,兼容 `3201`)。响应体 `data` 内含结构化支付信息:`cashierUrl`(支付宝收银台链接)、`amount`(订单金额,元)、`goodsName`(商品名称)、`outTradeNo`(订单号)。
    
    脚本退出码说明:`0` 正常返回;`1` 参数/鉴权/接口错误;`3` **积分不足,需要充值**(按下述流程处理)。
    
    完整的前置检查、`alipay-bot trigger-payment-signal` → `submit-payment` → `poll-payment-status` 编排步骤、钱包绑定处理、支付接管规则与失败处理,统一见 **[references/alipay-recharge.md](references/alipay-recharge.md)**(通用流程,可被其他 skill 复用)。`submit-payment` 后由 Agent 用 `poll-payment-status --out-shake-no <查询单号>` **自动监听支付回调到账**,无需用户再手动确认;到账(`outcome=success`)后自动用用户原始的查询参数重新运行 `scripts/search.py` 输出结果。
    
    ---
    
    ## 功能特点
    
    - **双接口深度查询**:`searchWork` 搜索列表 + `workDetail` 获取完整数据(阅读/点赞/评论/转发/分享)
    - **时间过滤**:限定最近 N 小时内的新鲜内容,拒绝过期缓存
    - **灵活排序**:按发布时间或阅读量降序排列
    - **视频筛选**:`--video-only` 只找视频类爆款
    - **终端表格**:标题、作者、阅读、点赞、评论、转发、发布时间、链接、类型
    - **CSV 导出**:自动生成 UTF-8 BOM 编码的 CSV
    - **HTML 交互报告**:深色主题,图文/视频标签区分,支持页内搜索
    - **本地代理服务**:避免浏览器跨域限制,支持页内实时搜索
    
    ---
    
    ## 依赖
    
    ```bash
    pip3 install requests
    ```
    
    ---
    
    ## 常见问题
    
    **Q:能搜到每条爆款吗?**
    A:能保证每次的关键词都有作品。
    
    **Q:搜索范围覆盖多久之前的作品?**
    A:目前提供近 1 年的作品,优先会覆盖近期发布的内容。
    
    **Q:为什么搜索后还要等待详情查询?**
    A:搜索接口只返回基础信息,同时提供单作品补全阅读量、点赞、转发等完整指标,让数据更完整。
    
    **Q:搜索后如何保存数据?**
    A:可以让 AI 为你导出 Excel,也可以让 AI 导出 HTML。
    
    **Q:额度用完怎么办?**
    A:前往 [redfox.hk](https://redfox.hk/settings/api-keys?source=github) 注册获取 Token。
    
    **Q:最多能获取多少条?**
    A:每页约 10 条,默认翻 3 页(约 30 条)。可通过 `--pages` 参数调整。
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.