| name | douyin-explore |
| description | 抖音内容发现技能。支持搜索视频、查看作品详情。
当用户要求搜索抖音、查看视频详情时触发。
|
抖音搜索与探索
只处理当前已经稳定实现的发现能力。
🔒 技能边界(强制)
所有搜索和浏览操作只能通过本项目的 python scripts/cli.py 完成,不得使用任何外部项目的工具:
- 唯一执行方式:只运行
python scripts/cli.py <子命令>。
- 忽略其他项目:执行时必须只使用本项目脚本。
- 禁止外部工具:不得调用 MCP 工具、Go 命令行工具,或任何非本项目实现。
- 完成即止:搜索或浏览结束后直接汇报结果。
本技能允许使用的 CLI 子命令:
| 子命令 | 用途 |
|---|
search-videos | 关键词搜索视频 |
get-video-detail | 获取作品详情 |
账号选择(前置步骤)
每次 skill 触发后,先运行:
python scripts/cli.py list-accounts
根据返回的 count:
- 0 个命名账号:直接使用默认账号。
- 1 个命名账号:直接使用该账号。
- 多个命名账号:询问用户选择哪个账号。
必做约束
- 所有操作需要已登录的 Chrome 浏览器。
- 做“搜索 / 探索”类任务时,默认返回 7 条内容;用户明确指定数量时才覆盖。
- 结果应结构化呈现,突出标题、作者、链接、互动数据。
- CLI 输出为 JSON 格式。
- 如果搜索页检测到验证码、身份验证或风控页,必须立即重新以有头模式执行同一步;在 WSLg / Linux 下显式附带:
DISPLAY=:0 WAYLAND_DISPLAY=wayland-0 XDG_RUNTIME_DIR=/run/user/1000 FORCE_HEADED=1;如果已经是有头模式,则停在可见窗口并请求用户人工处理后再继续。
工作流程
主页作品反查(补充)
当用户要求对刚发布的作品继续做点赞、收藏或取链接,而搜索暂时搜不到时:
- 打开
https://www.douyin.com/user/self?showTab=post
- 在作品列表里找到对应文案/标题
- 从作品卡片上的公开链接提取真实
note_id / video_id
- 再交给
douyin-interact 执行互动
搜索视频
python scripts/cli.py search-videos --keyword "关键词" --limit 7
获取作品详情
python scripts/cli.py get-video-detail --video-id VIDEO_ID
明确不支持
以下能力不再属于本技能范围:
- 用户主页抓取
- 高级搜索筛选参数
- 评论区全量抓取
- 账号/视频数据分析
失败处理
- 未登录:提示先执行登录。
- 搜索无结果:建议更换关键词。
- 作品不可访问:提示可能已删除或私密。
- 网络超时:提示稍后重试。