القائمة
今日头条爆款内容查询 — 输入关键词搜索今日头条最新作品（图文/视频），支持按阅读量/时间排序、限定时间范围，终端表格展示 + CSV 导出 + 交互式 HTML 报告。当用户需要搜索今日头条热门内容、追踪头条热点、分析爆款文章时使用。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/redfox-data/redfox-community --skill toutiao-searchيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
文旅B站信息源 — 搜索文旅相关B站热门视频，按点赞量筛选最火内容，生成精美 HTML 报告。当用户需要文旅B站、旅游攻略、景区热度、文旅资讯、文旅爆款内容时使用。触发词：文旅B站、文旅信息源、文旅资讯、旅游B站、景区视频、文旅爆款。
文旅抖音信息源 — 搜索文旅相关抖音热门作品，按点赞量筛选最火内容，生成精美 HTML 报告。当用户需要文旅抖音、旅游攻略、景区热度、文旅资讯、文旅爆款内容时使用。触发词：文旅抖音、文旅信息源、文旅资讯、旅游抖音、景区视频、文旅爆款。
文旅公众号信息源 — 搜索文旅相关公众号热门文章，按阅读量筛选最火内容，生成精美 HTML 报告。当用户需要文旅公众号、旅游攻略、景区热度、文旅资讯、文旅爆款内容时使用。触发词：文旅公众号、文旅信息源、文旅资讯、旅游公众号、景区文章、文旅爆款。
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | toutiao-search |
| description | 今日头条爆款内容查询 — 输入关键词搜索今日头条最新作品（图文/视频），支持按阅读量/时间排序、限定时间范围，终端表格展示 + CSV 导出 + 交互式 HTML 报告。当用户需要搜索今日头条热门内容、追踪头条热点、分析爆款文章时使用。 |
输入关键词搜索今日头条最新作品（图文/视频），终端表格展示 + 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 |
任选一种方式配置个人 Key：
| 方式 | 命令 |
|---|---|
| 环境变量（推荐） | export REDFOX_API_KEY=ak_你的密钥 |
| 命令行参数 | --api-key ak_你的密钥 |
| 配置文件 | echo '{"api_key":"ak_你的密钥"}' > ~/.qoder/apis/redfox.json |
注册地址：redfox.hk
searchWork 搜索列表 + workDetail 获取完整数据（阅读/点赞/评论/转发/分享）--video-only 只找视频类爆款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 参数调整。