今日头条爆款内容查询 / 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	「搜测评，只看视频类」	精准筛选视频爆款，评估内容方向