用途
本技能用于查询今日头条平台的爆款内容。输入关键词即可搜索今日头条最新发布的作品（图文/视频），实时拉取、无缓存延迟，帮助用户追踪头条热点、分析爆款文章、监控竞品内容、采集选题灵感或快速了解舆情风向。
主要能力
- 关键词搜索今日头条最新作品，覆盖图文与视频两类内容。
- 排序方式：按阅读量（views）或发布时间（time）降序排列。
- 时间过滤：可限定最近 N 小时内发布的作品（0 表示不限）。
- 视频筛选：通过 --video-only 只返回视频类作品。
- 多页翻页：通过 --pages 获取更多结果，每页约 10 条。
- 双接口深度查询：searchWork 搜索列表 + workDetail 补全阅读、点赞、评论、转发、分享等完整指标。
- 终端表格展示：包含标题、作者、阅读量、点赞数、评论数、转发数、发布时间、类型、链接等字段。
- CSV 导出：自动生成 UTF-8 BOM 编码的 CSV。
- HTML 交互报告：深色主题，图文/视频标签区分，作品卡片可点击跳转原文，支持页内搜索与分页加载。
- 本地代理服务：避免浏览器跨域限制，支持页内实时搜索。
使用方式
需先配置 API Key，可通过环境变量 REDFOX_API_KEY、--api-key 参数或配置文件传入。
基础搜索：
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
参数说明
- 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。
API Key 配置
任选一种方式：
- 环境变量（推荐）：
export REDFOX_API_KEY=ak_你的密钥 - 命令行参数：
--api-key ak_你的密钥 - 配置文件：
echo '{"api_key":"ak_你的密钥"}' > ~/.qoder/apis/redfox.json
注册地址：redfox.hk
依赖
pip3 install requests
适用场景
- 热点话题追踪：搜 "AI" 了解今日头条上最新的 AI 相关内容。
- 爆款内容分析：搜 "大模型" 找出阅读量最高的爆款文章。
- 竞品内容监控：搜品牌关键词，追踪竞品在今日头条的投放内容。
- 选题灵感采集：搜 "新能源" 批量导出 CSV 做数据分析找选题。
- 舆情快速了解：搜某事件关键词，快速了解头条平台讨论风向。
- 视频内容挖掘：搜 "测评" 配合 --video-only 筛选视频类爆款。
限制
- 需先配置 API Key 才能使用。
- 搜索范围目前提供近 1 年的作品，优先覆盖近期发布的内容。
- 每页约 10 条，默认翻 3 页（约 30 条），可通过 --pages 调整。
- 搜索接口只返回基础信息，需额外进行详情查询以补全阅读量、点赞、转发等完整指标。
- 额度用完后需前往 redfox.hk 注册获取 Token。
- CSV / HTML 默认保存在 ~/Downloads/QoderToutiaoSearch/。