Skip to content
cccskills
FreePublished on GitHub

toutiao-search

今日头条爆款内容查询 — 输入关键词搜索今日头条最新作品(图文/视频),支持按阅读量/时间排序、限定时间范围,终端表格展示 + CSV 导出 + 交互式 HTML 报告。当用户需要搜索今日头条热门内容、追踪头条热点、分析爆款文章时使用。当接口返回积分不足(code=3210)时,自动唤起支付宝完成充值后继续查询。

The English summary is being prepared. Showing the original description.

See how to install

Files included (6)

  • SKILL.md6.9 KB
  • assets/report_template.html29.3 KB
  • README.en.md4.9 KB
  • README.md5.0 KB
  • references/alipay-recharge.md6.2 KB
  • scripts/search.py33.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

今日头条爆款内容查询

输入关键词搜索今日头条最新作品(图文/视频),终端表格展示 + 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


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

当脚本以退出码 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 参数调整。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

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

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community449Updated Oct 22, 2026

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

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community449Updated Oct 22, 2026

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

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community449Updated Oct 22, 2026

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

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community449Updated Oct 22, 2026

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

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community449Updated Oct 22, 2026

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

The English summary is being prepared. Showing the original description.

redfox-data/redfox-community449Updated Oct 22, 2026

See all skills by redfox-data

Report a problem with this skill