视频号作品搜索

📝 简介

根据关键词搜索视频号热门作品，支持分页浏览翻页获取更多结果，返回标题、点赞数、作者、时长、发布时间等数据，结果以结构化表格展示。

获取 API Key：前往红狐hub
配置方式1：写入 ~/.openclaw/openclaw.json → { "env": { "REDFOX_API_KEY": "ak_xxxx..." } }
配置方式2：终端执行 export REDFOX_API_KEY="ak_xxxx..."

执行脚本：

python3 "$SKILL_PATH/scripts/fetch_sph_ai.py" "<关键词>"

默认按热度排序（searchType=0）。用户明确要求「最新」时才传 --sort 1。

API 请求参数：

脚本返回 JSON：

字段	类型	说明
articles	array	当前页作品列表（已标准化处理）
totalCount	number	当前页作品数量
offset	number	当前结果偏移量
cookiesBuffer	string	翻页游标，传入 `--buffer` 获取下一页；非空表示还有更多页

翻页：从上一页返回的 cookiesBuffer 传入 --buffer 参数即可获取下一页。必须使用最新返回的 buffer，不可复用旧值。cookiesBuffer 为空时已到最后一页。

# 翻页
python3 "$SKILL_PATH/scripts/fetch_sph_ai.py" "<关键词>" --buffer "<上一页的cookiesBuffer>"

每条作品（articles[]）字段：

字段	说明
title	作品标题/描述文案（API `description` 字段）
author	作者昵称（API `nickname` 字段）
likeCount	点赞数（数值），内部使用
likeDisplay	点赞数展示值（API `likeNum` 原始值，如 `1.2万`、`1167`），用于表格展示
coverUrl	封面图 URL（API `image` 字段），不对外展示
videoUrl	作品视频链接（API `videoUrl` 字段），不对外展示
duration	视频时长（如 `00:40`）
publishTime	发布时间（已转换为 `MM-DD HH:MM`）
publishTimestamp	发布时间原始 Unix 时间戳
opusId	作品 ID

直接输出接口返回的全部数据：

📊 关键词「XXX」搜索结果如下：

| # | 作品标题 | 点赞数 | 作者 | 时长 | 发布时间 |
|---|---------|--------|------|------|----------|
| 1 | 完整作品描述文案，不截断 | 1.2w | 作者名 | 00:40 | 06-02 19:55 |

格式化规则：

表格后必须输出提示：

🔔 受视频号平台规则限制，无法提供作品链接，您可复制作品标题前往视频号搜索查看。

脚本返回的 cookiesBuffer 非空时提示翻页：

📄 该关键词还有更多结果，是否需要翻页查看更多？回复「翻页」获取下一页数据。

展示完毕后末尾附上：

📩 是否订阅「XXX」的每日推送？订阅后每天 9:00 自动推送最新视频号作品。回复「确认订阅」即可创建定时任务。

优先使用平台内置定时任务，若无则提供通用方案：

任务名称：视频号作品订阅 - <关键词>
执行频率：每天 9:00（cron 0 9 * * *）
执行命令：python3 "$SKILL_PATH/scripts/fetch_sph_ai.py" "<关键词>" --sort 1
⚠️ 订阅推送固定使用 --sort 1（按最新排序），确保每日推送最新数据
通用 crontab：0 9 * * * python3 "$SKILL_PATH/scripts/fetch_sph_ai.py" "<关键词>" --sort 1

创建成功后告知："已成功订阅关键词「<关键词>」的视频号作品推送，每天 9:00 将自动查询最新数据并通知你。"

脚本内部将 Redfox API 原始返回字段映射为统一字段名，详见 api-mapping.md。