本文へ移動
cccskills
無料GitHub で公開

toutiao-search

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

インストール方法を見る

含まれるファイル(5)

  • SKILL.md5.7 KB
  • assets/report_template.html29.3 KB
  • README.en.md4.9 KB
  • README.md5.0 KB
  • scripts/search.py31.6 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

今日头条爆款内容查询

输入关键词搜索今日头条最新作品(图文/视频),终端表格展示 + 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 / timeviews
--hours限定最近 N 小时内发布的作品(0=不限)0
--pages翻页次数(每页约 10 条)3
--video-only只返回视频类作品—
--output-dir输出目录~/Downloads/QoderToutiaoSearch
--api-key指定 API Key—
--no-open不自动打开浏览器—
--csv-only仅生成 CSV,不生成 HTML—
--portHTML 本地服务端口8767

API Key 配置

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

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

注册地址:redfox.hk


功能特点

  • 双接口深度查询: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 参数调整。

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

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

日本語の概要は準備中です。原文の説明を表示しています。

redfox-data/redfox-community4302026年10月12日 更新

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

日本語の概要は準備中です。原文の説明を表示しています。

redfox-data/redfox-community4302026年10月12日 更新

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

日本語の概要は準備中です。原文の説明を表示しています。

redfox-data/redfox-community4302026年10月12日 更新

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

日本語の概要は準備中です。原文の説明を表示しています。

redfox-data/redfox-community4302026年10月12日 更新

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

日本語の概要は準備中です。原文の説明を表示しています。

redfox-data/redfox-community4302026年10月12日 更新

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

日本語の概要は準備中です。原文の説明を表示しています。

redfox-data/redfox-community4302026年10月12日 更新

redfox-data のスキルをすべて見る

このスキルの問題を報告する