douyin-creator-insight

分析公开抖音创作者的视频主题、互动结构和代表内容，并输出 HTML、Markdown、JSON 报告。适用于研究某个抖音博主、拆解选题和内容结构；不用于收藏夹同步、私密账号或绕过平台访问控制。

Install

openclaw skills install @tars1230/douyin-creator-insight

Douyin Creator Insight

使用条件

仅分析公开可访问数据。默认真实抓取使用已授权的本地浏览器 profile，不依赖 Apify key；Apify 仅是显式 fallback。不要在对话、脚本、报告或仓库中输出 token、cookie、浏览器 profile、私人绝对路径或未公开内容。

Actor 的价格、配额、可用性和 schema 会变化。运行前查看当前 Actor 页面；任何费用或耗时只能作为本次运行的实测结果陈述，不能沿用固定承诺。

输入

从用户原话提取：

creator_query：优先主页 URL、sec_uid，或包含 v.douyin.com 的完整分享消息；脚本会提取短链接。
max_videos：默认 200；用户要求省资源或试跑时降低。
transcript_count：默认 5。
transcript_max_duration_minutes：默认 5，用于候选筛选。
output_formats：默认 html、md、json。
output_dir：默认当前任务的专用输出目录。

主页 URL、分享短链接或 sec_uid 最稳定。昵称和抖音号只可用于候选确认，不能自动选择同名账号；搜索验证码或模糊结果时要求用户改贴主页/分享链接。

流程

用 scripts/resolver.py 判断输入类型，并从分享消息提取短链接。
对 URL/短链接/sec_uid，优先运行 scripts/run_pipeline.py --browser。它在现有 persistent profile 的页面上下文读取公开作品分页，并验证每条返回视频的作者 sec_uid。
昵称或抖音号不可自动选人；搜索触发验证码、无候选或多个候选时停止并请求主页/分享链接。
用 scripts/parser.py 标准化字段，再执行 quality_gate.py。门禁失败时停止，不生成伪完整报告。
用 selector.py 选择精华候选。浏览器模式未配置独立转写 provider 时，必须标为 skipped，不得伪装为 transcript。
用 categorizer.py 分类、report_builder.py 输出真实数据源；浏览器不可用时才用 profile/transcript actor fallback。

Tool 调用契约

Profile actor 输入：

json

{
  "maxPostsPerProfile": 50,
  "profileUrls": ["https://www.douyin.com/user/<sec_uid>"]
}

Actor ID、输入字段和 fallback 以 references/apify-douyin-actors.md 为准。不要假设文档中的历史 actor 永久可用；调用失败时先核对 Actor 页面和返回 schema。

质量门

身份必须 matched，且含 sec_uid 或抖音号。
视频列表不能为空；少于质量门默认阈值时阻断。
超过一半的视频缺少标题与描述时阻断。
转写成功率低于门槛时，报告必须明确降级或停止。
低置信度身份不得自动选择。

运行脚本

Agent 已经完成采集后，可直接复用 scripts/ 中的解析、筛选和报告函数。独立 CLI 必须显式选择一种模式：

bash

# 非联网验证
python3 scripts/run_pipeline.py --creator <profile_url> --dry-run

# 默认真实路径：已登录浏览器中的公开主页接口
python3 scripts/run_pipeline.py --creator '<share_or_profile_url>' --browser --output-dir ./output

# 使用显式 adapter 真实运行
python3 scripts/run_pipeline.py \
  --creator <profile_url> \
  --adapter my_adapter:call_actor \
  --output-dir ./output

没有 --dry-run、--browser 或 --adapter 时，CLI 必须失败；不得把 dry-run 返回当成真实报告。

失败处理

场景	行为
找不到账号	返回候选或要求更稳定的主页 URL
浏览器 profile 未登录、主页接口失败	不要求复制 cookie；提示在已有 profile 中恢复登录或稍后重试
昵称搜索验证码/同名	不绕过验证码，不自动选人；要求主页或分享链接
Profile actor 失败	核对 schema 后使用记录在 reference 中的 fallback
视频不足或字段异常	质量门阻断，保留原始响应供排查
Transcript 失败	fallback；仍失败则标记 `failed` 或 `empty_transcript`
配额不足	停止真实调用，建议用户缩小样本或稍后重试
输出写入失败	返回非成功状态和明确路径，不宣称完成

验证

修改 Skill 或脚本后必须运行：