| name | douyin-video-analyst |
| description | 抖音账号视频批量采集与文案分析工作流。当用户提供抖音账号主页链接、要求抓取最新 N 条视频链接、提取视频文案（语音转文字）、或对视频内容进行总结归纳时，激活此 skill。依赖 browser 工具（抓取视频列表）和 mcporter + douyin-mcp（文案提取）。 |
Douyin Video Analyst
从抖音账号主页批量采集最新视频链接，通过 douyin-mcp 提取视频语音文案，去除口语化后输出精简原始文案，并进行综合总结。
前置依赖
- browser 工具：用于渲染抖音 SPA 页面并抓取视频列表（web_fetch 无效，抖音为纯 JS 渲染）
- mcporter CLI：
which mcporter 确认可用
- douyin-mcp server：在
mcporter list 中应显示 douyin-mcp (5 tools)
mcporter 会自动加载 ~/.cursor/mcp.json 和 ~/.claude.json 两个配置文件中的 MCP server。
版本与 Key 对照
| 版本 | API 平台 | 环境变量 |
|---|
| ≤ 1.1.0 | 硅基流动 | DOUYIN_API_KEY |
| ≥ 1.2.0 | 阿里云百炼 | DASHSCOPE_API_KEY |
两个版本均受支持，根据实际配置选择对应环境变量。配置指南见 references/setup.md。
工作流步骤
Step 1：检查配置
mcporter list 2>&1 | grep douyin-mcp
读取配置文件判断版本和 Key：
python3 << 'EOF'
import json, os
for path in ['~/.cursor/mcp.json', '~/.claude.json']:
p = os.path.expanduser(path)
if not os.path.exists(p): continue
d = json.load(open(p))
cfg = d.get('mcpServers', {}).get('douyin-mcp')
if cfg:
print(f"Found in {path}")
print(' args:', cfg.get('args'))
print(' env keys:', list(cfg.get('env', {}).keys()))
break
EOF
- env 含
DOUYIN_API_KEY → v1.1.0，硅基流动
- env 含
DASHSCOPE_API_KEY → v1.2.0+，阿里云百炼
若未配置，参考 references/setup.md 完成初始化。
Step 2：用 browser 抓取视频列表
抖音是纯 JS SPA，必须用 browser 工具，不可用 web_fetch。
browser(action="open", profile="openclaw", targetUrl="<账号主页URL>")
browser(action="screenshot", ...) # 等页面渲染，确认视频列表出现
browser(action="snapshot", ...) # 提取 listitem 中的 /video/XXXX 链接
从 snapshot 的 aria tree 中提取 link[href=/video/XXXXXXXXXXXXXXXXX]，取前 N 条，拼接完整链接：https://www.douyin.com/video/<video_id>
Step 3：并发提取视频文案
根据 Step 1 检测到的版本，选择对应的环境变量名，并发调用所有视频（不要串行等待）：
DOUYIN_API_KEY="<key>" mcporter call douyin-mcp.extract_douyin_text \
share_link="https://www.douyin.com/video/<video_id>" 2>&1
DASHSCOPE_API_KEY="<key>" mcporter call douyin-mcp.extract_douyin_text \
share_link="https://www.douyin.com/video/<video_id>" 2>&1
同时发起所有 exec 调用（放在同一个工具调用块中），设置 timeout=180，yieldMs=120000。
若出现错误，参考 references/troubleshooting.md。
Step 4：整理与输出
按视频顺序（从新到旧）输出，每条视频包含：
- 视频标题（来自 snapshot 的 link 文本）
- 视频链接
- 精简文案：对原始语音文案去除口语化表达（去掉语气词、重复啰嗦、"大家"/"我们"/"你们"等口语填充词），保留核心信息和论点，以书面化段落呈现，不做摘要压缩，完整保留所有要点
最后附综合总结：跨视频归纳主线逻辑、核心主题、一致的风险提示。
输出格式参考
## 📊 [账号名] 最近 N 条视频文案整理
---
### 视频1 | <标题>
🔗 <链接>
<精简后的书面化文案，完整保留所有要点，去除口语填充>
---
### 视频2 | <标题>
...
---
## 🗂️ 综合总结
| 主线 | 核心逻辑 | 重点方向 |
|------|----------|----------|
| ... | ... | ... |
注意事项
- 抖音登录弹窗出现时：直接读取 snapshot，视频列表通常仍可在 aria tree 中获取
- 第一条视频可能需要登录才能访问，从第二条起往往正常
- extract_douyin_text 耗时较长（30~90s/条），务必并发执行
- 若文案提取失败，可先用
parse_douyin_video_info 获取下载链接，再手动处理
