前言¶

做内容运营或竞品调研时，经常要在今日头条里按关键词翻最新图文和视频，再按阅读量或发布时间筛一批样本。手工在 App 或网页里翻页、抄标题和链接，很难系统化对比，也不方便交给表格或报告继续分析。下面介绍 SkillHub 上的社区 Skill「今日头条爆款内容查询」，把搜索、排序、时间范围限定和结果展示（终端表格、CSV、HTML 报告）交给 Agent 按对话触发，减少重复检索劳动。

这是什么¶

「今日头条爆款内容查询」是 SkillHub 坐标 @user_5f9c21aa/toutiao-search-redfox 上的数据分析类 Skill（分类 data-analysis，版本 1.0.0，来源 community）。页面标注作者为 to the moon（红狐数据）。

一句话定位：输入关键词搜索今日头条最新作品（图文/视频），支持按阅读量或时间排序、限定时间范围，并在终端以表格展示结果，同时支持 CSV 导出与交互式 HTML 报告。官方说明适用于需要搜索今日头条热门内容、追踪头条热点、分析爆款文章的场景。

SkillHub 标签含 requires_api_key=true，表示使用前需要配置 API Key；具体变量名与获取方式以安装后包内 SKILL.md 及发布者说明为准，本文不展开未在公开页写明的配置项。

核心功能¶

以下能力均来自 SkillHub 公开简介，未做延伸：

1. 关键词搜索：针对给定关键词检索今日头条上的最新作品，覆盖图文与视频。
2. 排序：支持按阅读量排序，或按时间排序，便于看「当前最热」或「最近更新」。
3. 时间范围：可限定检索的时间范围，缩小样本窗口。
4. 结果呈现：
   - 终端表格展示，便于在 CLI 会话里快速浏览；
   - CSV 导出，便于二次统计或导入其他工具；
   - 交互式 HTML 报告，便于在浏览器里查看与筛选。

安装与启用¶

Skill 遵循通用 SKILL.md 格式。在 SkillHub 上，官方给出的安装方式是：让当前使用的 AI 客户端根据安装文档拉取该 Skill。

通过对话安装（官方推荐提示）¶

将下面意图发给支持 Skill 的 Agent（Cursor、Claude Code、Codex 等均可按各自 skills 目录落盘）：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_5f9c21aa/toutiao-search-redfox`。

Agent 会按 SkillHub 安装文档检查或安装 skillhub CLI，并把 Skill 安装到当前环境的 skills 目录。

使用 skillhub CLI（文档中的标准路径）¶

若本机已有 skillhub，可先确认版本：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 文档执行完整安装（含 CLI 与默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被客户端加载。文档记载的常用路径示例：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装命令形式为：

skillhub install user_5f9c21aa/toutiao-search-redfox --dir <你的 skills 目录>

具体目录以你当前使用的客户端为准；安装后若客户端要求重启或重新加载 skills，按其产品说明操作。

API Key¶

公开标签标明 requires_api_key=true。在首次调用搜索相关能力前，应按 Skill 包内说明配置 API Key；未在 SkillHub 摘要页列出的字段名不在本文编造。

典型用法¶

公开页未提供固定 shell 子命令示例，典型用法是在已启用该 Skill 的 Agent 里用自然语言描述检索需求，由 Skill 驱动搜索与导出。可与官方简介对齐的表述例如：

1. 「用关键词『新能源汽车』搜今日头条最近一周的视频，按阅读量从高到低排，结果导出 CSV。」
2. 「查今日头条里和『本地生活』相关的图文，按时间排序，限定最近 3 天，并生成 HTML 报告。」
3. 「追踪头条热点词『某某事件』的最新作品，先在终端表格里给我看前 20 条。」

经过上面的步骤，Agent 应能完成搜索、排序、时间过滤，并按你指定的形式输出表格、CSV 或 HTML。若某次调用失败，优先核对 API Key 是否已配置、网络是否可达，以及 Skill 是否安装在正确的 skills 目录。

适用场景与注意¶

适合谁

• 需要按关键词批量查看今日头条图文/视频样本的内容、运营或分析人员；
• 要在 Agent 工作流里做热点追踪、爆款结构参考检索，并希望结果可落盘（CSV/HTML）的团队。

使用上需注意

• 数据来自 Skill 所对接的检索能力，时效性与字段以实际返回为准；公开材料未承诺与头条官方后台数据完全一致。
• 社区来源（community），版本当前为 1.0.0；升级可通过 skillhub 或 SkillHub 页面关注新版本。
• SkillHub 页面统计（截至抓取）：评分 100000，下载 2278；安装数在抓取快照中为 0，仅作商店侧参考，不代表你本机是否已安装。
• 涉及平台内容与合规使用时，应遵守今日头条及相关服务的使用条款；批量抓取或商用需自行评估授权与频率限制。

结尾¶

「今日头条爆款内容查询」把头条关键词检索、排序与时间过滤，以及终端表格、CSV 与 HTML 报告几种输出方式收进一个 Skill，适合在 Cursor 等 Agent 环境里做热点与爆款样本的快速拉取。安装与优先源配置以 SkillHub 文档为准；Skill 详情与安装入口：

• SkillHub 页面：https://www.skillhub.cn/skills/user_5f9c21aa/toutiao-search-redfox
• API 坐标页：https://api.skillhub.cn/user_5f9c21aa/toutiao-search-redfox