Douyin Analytics

抖音数据抓取技能

根据抖音用户主页 URL 和 Cookie，抓取该用户发布的视频列表数据，包含标题、发布日期、点赞/评论/分享/播放数据，以表格形式汇报。

工作流程

严格按照以下顺序执行，每步确认后再继续：

第一步：收集必要信息

依次询问用户以下信息：

1. 目标抖音用户主页 URL

• 格式示例：https://www.douyin.com/user/MS4wLjABAAAA...
• 从 URL 中提取 sec_user_id 参数

2. 抖音登录 Cookie

• 引导用户：打开浏览器开发者工具 (F12) → Network 标签 → 刷新页面 → 找到任意 douyin.com 请求 → 复制 Request Headers 中的 Cookie 值
• Cookie 必须包含 sessionid 字段，否则无法获取数据

3. 抓取时间范围

• 询问：抓取最近多少天的视频？
• 默认值：7 天
• 建议范围：1-30 天

第二步：准备环境

# 将 Cookie 写入临时文件
echo "<用户提供的Cookie>" > /tmp/dy_cookie.txt

# 确保 requests 库可用
pip install requests -q

第三步：执行数据抓取

运行 scripts/fetch_videos.py 脚本：

python ~/.openclaw/workspace/skills/douyin-analytics/scripts/fetch_videos.py \
  --sec_user_id "<从URL提取的sec_user_id>" \
  --cookie_file /tmp/dy_cookie.txt \
  --days <用户指定的天数>

第四步：汇报结果

以表格形式展示抓取结果：

数据摘要：

• 视频总数：X 条
• 平均播放量：X
• 最高播放视频：[标题] (X 次播放)

错误处理

注意事项

• Cookie 包含敏感信息，仅在本次会话使用，不会存储
• 抖音 API 可能有频率限制，大量抓取时建议间隔请求
• 视频数据可能不完整，部分视频可能无播放量数据