douyin-creator-insight
分析公开抖音创作者的视频主题、互动结构和代表内容,并输出 HTML、Markdown、JSON 报告。适用于研究某个抖音博主、拆解选题和内容结构;不用于收藏夹同步、私密账号或绕过平台访问控制。 Skill: douyin-creator-insight Owner: tars1230 Summary: 分析公开抖音创作者的视频主题、互动结构和代表内容,并输出 HTML、Markdown、JSON 报告。适用于研究某个抖音博主、拆解选题和内容结构;不用于收藏夹同步、私密账号或绕过平台访问控制。 Tags: latest:1.3.6 Version history: v1.3.6 | 2026-08-05T12:42:37.389Z | user setup/缺Key强制三步:推荐注册页→控制台建Key→export;交互可打开 https://cloud.siliconflow.cn/i/1srulim9 v1.3.5 | 2026-08-05T09:53:13.121Z | user ASR 简化为单一路径:只下 video_url → ffmpeg 抽音 → SenseVoice;去掉 audio_url 优先分支
Rank
62
Safety
84
Downloads
972
Updated
Oct 11, 2026
Version
1.3.6
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 972 downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 972 downloadsadoption · observed Oct 11, 2026
- Latest release
- 1.3.6release · observed Aug 5, 2026
- Handshake status
- UNKNOWNsecurity
What changed
Newest first. Only changes that point at a source are listed.
Release 1.3.6release
setup/缺Key强制三步:推荐注册页→控制台建Key→export;交互可打开 https://cloud.siliconflow.cn/i/1srulim9
Observed Aug 5, 2026 · source
Install and run
Setup complexity: low.
clawhub skill install s174ad9z7a9pq8vt2njhqm0hk983qfsw:douyin-creator-insight- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-tars1230-douyin-creator-insight/snapshot"
Run-check
$0.02 USD1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.
Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.
Documentation
CLAWHUB
156,308 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
--- name: douyin-creator-insight version: 1.3.6 description: 分析公开抖音创作者的视频主题、互动结构和代表内容,并输出 HTML、Markdown、JSON 报告。适用于研究某个抖音博主、拆解选题和内容结构;不用于收藏夹同步、私密账号或绕过平台访问控制。 --- # Douyin Creator Insight ## 使用条件 仅分析公开可访问数据。默认真实抓取使用已授权的本地浏览器 profile,不依赖 Apify key;Apify 仅是显式 fallback。不要在对话、脚本、报告或仓库中输出 token、cookie、浏览器 profile、私人绝对路径或未公开内容。 ## 安装与共享配置 `douyin-creator-insight` 可独立安装和运行,`douyin-favorites-to-knowledge`(旧名/旧目录可能是 `douyin-knowledge-base-pipeline`)不是前置依赖。若两者都存在,本 skill 只复用已登录的 persistent browser profile 和 ASR 环境变量,绝不读取收藏记录、修改增量 metadata,或加入收藏 skill 的 23:00 任务。 首次运行先执行 `python3 scripts/setup.py`。它只写非敏感偏好:`cloud`(云端 ASR)/ `local`(Whisper)/ `index`(只索引),以及可选 profile/output 位置;不保存 API key、cookie 或 token。若检测到已安装 `douyin-favorites-to-knowledge`,优先复用其已登录浏览器 profile 和转录偏好,但状态、账本、输出和 23:00 任务仍完全隔离。缺 Key 时 setup 会打印 **①②③ 逐步指引**,交互终端可询问是否**打开推荐注册页**。 **云端 ASR 真相(抖音)**:抖音 CDN(`*.douyinvod.com` 等)带防盗链,**阿里云百炼 URL-ASR 服务端拉不到媒体**,会稳定失败——不是用户 Key 配错。公开 skill 的默认可用路径是: 1. **推荐 `SILICONFLOW_API_KEY`**:本机用浏览器式 `Referer: https://www.douyin.com/` 临时下载 → 抽音频 → 上传 SiliconFlow `FunAudioLLM/SenseVoiceSmall` → 立即清理临时文件。 2. **可选 `DASHSCOPE_API_KEY`**:仅当媒体 URL 是第三方可公网直链时走百炼 URL-ASR;对抖音 CDN **默认跳过**(可用 `DOUYIN_FORCE_DASHSCOPE_URL=1` 强行试)。 3. 至少配置上述之一才允许 `cloud` 真跑;**两者都缺**时停止,不下载、不静默切 Whisper。 4. 云端都失败且用户允许 local fallback 时才进 Whisper;`index` 永不 ASR。 **新用户拿 Key(必须按序,别自己乱搜):** 1. 打开推荐注册/登录页:https://cloud.siliconflow.cn/i/1srulim9 2. 控制台创建 API Key:https://cloud.siliconflow.cn/account/ak 3. `export SILICONFLOW_API_KEY='…'` 或写入 `~/.hermes/.env` / 仓库 `.env.local`,**重启 Agent** 4. 价格参考:https://siliconflow.cn/pricing(SenseVoiceSmall 可能标免费,以账单为准) 百炼说明(可选):`https://help.aliyun.com/zh/model-studio/get-api-key`。Key 放本机环境变量/Secret Manager,不要发聊天或进仓库。skill 自动读 shell、`~/.hermes/.env`、仓库 `.env` / `.env.local`。运行前 `python3 scripts/integration.py`;共享 profile 被占用必须等待。报告写入独立 `<output-root>/creator-insight/`。 > **ASR 费用(默认 SenseVoiceSmall)**:截至 **2026-08-05**,硅基流动[官方价格页](https://siliconflow.cn/pricing)将 `FunAudioLLM/SenseVoiceSmall` 标注为 **免费**(同页 `TeleSpeechASR` 亦免费;TTS 另计)。需要 `SILICONFLOW_API_KEY`。价格会变,**不承诺永久免费**;以价格页与控制台账单为准。可选百炼 `qwen3-asr-flash` 另计费(与 SiliconFlow 账单分离),且对抖音 CDN 常失败。 - **SiliconFlow 注册推荐链接**:[https://cloud.siliconflow.cn/i/1srulim9](https://cloud.siliconflow.cn/i/1srulim9) - Key 控制台:[https://cloud.siliconflow.cn/account/ak](https://cloud.siliconflow.cn/account/ak) Actor 的价格、配额、可用性和 schema 会变化。运行前查看当前 Actor 页面;任何费用或耗时只能作为本次运行的实测结果陈述,不能沿用固定承诺。 ## 输入 从用户原话提取: - `creator_query`:优先主页 URL、`sec_uid`,或包含 `v.douyin.com` 的完整分享消息;脚本会提取短链接。 - `max_videos`:默认 1000;用户要求省资源或试跑时降低。超过上限时结果必须标为 `partial`。 - `transcript_count`:未指定时按作品数自动分档;用户显式指定时优先遵从。 - `transcript_max_duration_minutes`:默认 5,用于候选筛选。 - `transcript_mode`:`cloud`(默认)/ `local` / `index`。 - `output_formats`:默认 `html`、`md`、`json`。 - `output_dir`:默认当前任务的专用输出目录。 主页 URL、分享短链接或 `sec_uid` 最稳定。昵称和抖音号只可用于候选确认,不能自动选择同名账号;搜索验证码或模糊结果时要求用户改贴主页/分享链接。 ## 流程 1. 用 `scripts/resolver.py` 判断输入类型,并从分享消息提取短链接。 2. 对 URL/短链接/`sec_uid`,优
assets/README.md
# Assets · 模板文件
本目录存放报告生成所需的静态资源。
## 文件清单
- `README.md`:本说明
- `report_template.html`:HTML 报告模板(参考用)
- `report_style.css`:报告样式(参考用)
- `creator_card_template.html`:博主封面卡片模板(参考用)
## 当前实现
**注意**:当前 `scripts/report_builder.py` 使用内置 Python 字符串模板,**不依赖** assets/ 目录。
assets/ 中的文件仅作为参考 / 自定义起点。
## 自定义指南
如果需要自定义样式:
### 方式 1:直接修改内置模板
编辑 `scripts/report_builder.py::HTML_TEMPLATE`,调整 CSS 部分。
### 方式 2:使用 jinja2 渲染
1. 安装:`pip install jinja2`
2. 把内置 HTML_TEMPLATE 复制到 `assets/report_template.html`
3. 用 jinja2 渲染
```python
from jinja2 import Environment, FileSystemLoader
env = Environment(loader=FileSystemLoader('assets'))
template = env.get_template('report_template.html')
html = template.render(
nickname=nickname,
followers=followers,
...
)
```
### 方式 3:完全重写
如果需要差异化设计(如杂志风、暗色模式),可以:
1. 创建新文件 `assets/report_template_magazine.html`
2. 在 `scripts/report_builder.py` 中加 `build_html_report_magazine()`
3. 调用方选择用哪个模板
## 配色参考
| 风格 | 配色 |
|---|---|
| 默认(深紫蓝) | `#1e3a8a → #5b21b6` |
| 杂志风(暖色) | `#b45309 → #d97706` |
| 暗色模式 | `#0f172a → #1e293b` |
| 极简(白底) | `#f8fafc → #f1f5f9` |
## 示例模板
### 默认模板(已在 report_builder.py)
```html
<header class="hero">
<h1>{{ nickname }} · 抖音内容洞察报告</h1>
<div class="creator-stats">
<div class="stat"><span class="num">{{ followers }}</span></div>
...
</div>
</header>
```
### 杂志风模板(待创建)
参考 `guizang-ppt-skill` 的杂志风风格。README.md
# Douyin Creator Insight 从公开抖音主页、分享短链接或 `sec_uid` 出发,生成可审计的创作者内容洞察报告。默认使用已登录的本地浏览器 profile 读取公开作品;Apify 是可选 fallback。输出包含 HTML、Markdown 和 JSON。 [](https://github.com/tars1230/douyin-creator-insight/actions/workflows/ci.yml) [](LICENSE) [](https://www.python.org/downloads/) ## 能做什么 - 解析主页 URL、`sec_uid` 和完整分享文案中的短链接;昵称或抖音号只用于人工候选确认,不自动选择同名账号。 - 标准化不同数据源的视频字段。 - 按账号规模自动选择转写候选:小账号全量转写,大账号以点赞、收藏和近期作品分层抽样。 - 对解析、视频数量和转写质量执行阻断式质量门。 - 生成 HTML、Markdown、JSON 三种报告。 本项目只处理公开数据,不绕过登录、隐私或平台访问控制。 ## 安装与分发入口 - Agent 一键安装:[ClawHub douyin-creator-insight](https://clawhub.ai/tars1230/skills/douyin-creator-insight) - 国内源码镜像:[Gitee tars123/douyin-creator-insight](https://gitee.com/tars123/douyin-creator-insight) - 源码与版本发布:[GitHub tars1230/douyin-creator-insight](https://github.com/tars1230/douyin-creator-insight) ## 运行方式 ### 独立运行,可选复用收藏 skill 本 skill 可以独立安装。第一次运行先执行 `python3 scripts/setup.py`,明确选择: - `cloud`:云端 ASR(默认)。**抖音场景推荐配置 `SILICONFLOW_API_KEY`**(本机带 Referer 临时下载 → 上传 SenseVoice → 清理)。 - `local`:本地 Whisper。只有用户明确选择时才临时下载视频,结束后清理。 - `index`:只索引标题、描述、互动数据和链接,不调用 ASR。 ### 云端 ASR 重要说明(请先读) 抖音播放地址在 `*.douyinvod.com` 等 CDN 上,带防盗链。**阿里云百炼的 URL-ASR 无法从服务端下载这些地址**,会稳定返回 download 失败——这不是 API Key 坏了,也不是“测通了百炼就等于抖音能转写”。 | Key | 是否抖音刚需 | 作用 | |---|---|---| | **`SILICONFLOW_API_KEY`** | **是(推荐)** | 下载(`Referer: https://www.douyin.com/`)+ 上传 `FunAudioLLM/SenseVoiceSmall` | | `DASHSCOPE_API_KEY` | 否(可选) | 仅对**可公网直链**媒体做 URL-ASR;对抖音 CDN 默认跳过 | - SiliconFlow 控制台:[创建 API Key](https://cloud.siliconflow.cn/account/ak) - 百炼说明(可选):[如何获取 API Key](https://help.aliyun.com/zh/model-studio/get-api-key) 两者都缺时,`cloud` 真跑会安全停止,不下载、不静默切 Whisper。只有 `DASHSCOPE`、没有 SiliconFlow 时会告警。Key 放环境变量/Secret Manager,不要发聊天或进仓库。 skill 会自动读取当前 shell、`~/.hermes/.env`、仓库 `.env` / `.env.local` 中的相关配置,Hermes 没透传环境也能继续走 cloud 默认。 同时安装 `douyin-favorites-to-knowledge` 时,setup 会探测并优先复用它的已登录浏览器 profile 和转录偏好,但状态、输出和调度完全隔离:Creator Insight 默认写入 `./output/creator-insight/`,不读取收藏 metadata,也不加入 23:00 收藏任务。运行前执行 `python3 scripts/integration.py`;若共享 profile 已被占用,等待当前流程结束即可。`douyin-mcp` 是可选诊断工具,不是安装或运行依赖。 ### 1. 本地浏览器模式(默认推荐) 首次独立使用时,本 skill 会使用中性的共享浏览器 profile;登录一次抖音即可。若已安装收藏 skill,则自动复用它现有的已登录 profile。之后可直接粘贴主页、`sec_uid`,或包含 `https://v.douyin.com/.../` 的完整分享消息: ```bash python3 scripts/setup.py python3 scripts/integration.py python3 scripts/run_pipeline.py \ --creator '长按复制此条消息,打开抖音搜索 https://v.douyin.com/xxxx/ ...' \ --browser --max-videos 50 --output-dir ./output ``` 该模式只读取公开作品列表,逐页验证每条作品作者的 `sec_uid`,不复制 cookie、不输出 profile、不绕过验证码。抖音媒体默认走 SiliconFlow 上传 ASR(Referer 下载后清理);非抖音公网媒体可走百炼 URL ASR;全部云端失败才回退本地 Whisper。 非交互环境可以显式配置: ```bash # 云端:保存选择;若 Key 尚未配置,真实运行会安全停止并给出申请入口 python3 scripts/setup.py --transcript-mode cloud # 本地:只有明确选择 local 后,真实运行才允许临时下载视频 python3 scripts/setu
_meta.json
{
"ownerId": "kn7fgfkjyfqbz673wvzymh5e1x821vpk",
"slug": "douyin-creator-insight",
"version": "1.3.6",
"publishedAt": 1785933757389
}references/apify-douyin-actors.md
# Apify Douyin Actors 对照表
## 三个核心 actor
### 1. `zen-studio/douyin-profile-scraper` ⭐ 主用
**用途**:抓取指定博主的所有视频列表
**输入**:
```json
{
"maxPostsPerProfile": 200,
"profileUrls": ["https://www.douyin.com/user/MS4w..."]
}
```
**输出字段**:
```json
[
{
"id": "7600998358588812742",
"text": "视频文案/描述",
"title": "标题",
"createTime": 1737638400,
"createDate": "2025-01-23",
"statistics": {
"diggCount": 12345,
"commentCount": 678,
"shareCount": 90,
"collectCount": 234,
"playCount": 567890
},
"videoMeta": {
"duration": 120000,
"cover": "https://..."
},
"hashtags": [{"name": "..."}],
"series": {"name": "..."},
"shareUrl": "https://...",
"authorMeta": {
"name": "...",
"signature": "...",
"followersCount": 333000,
"heartCount": 2672708,
"awemeCount": 200
}
}
]
```
**价格**:以 Apify Actor 当前页面为准。公开视频、README 和教程里不要承诺固定成本;第一次建议先小样本验证。
**限制**:maxPostsPerProfile 上限 200
**调用示例**:
```python
apify_caller(
actor="zen-studio/douyin-profile-scraper",
input={
"maxPostsPerProfile": 200,
"profileUrls": [profile_url]
},
wait_secs=45
)
```
### 2. `zen-studio/douyin-transcripts-scraper` ⭐ 主用转写
**用途**:抓取视频语音转写;当前限制以 Actor 页面为准
**输入**:
```json
{
"targetLanguage": "zh",
"videoUrls": ["https://www.douyin.com/video/7575296454722398441", ...]
}
```
**输出**:
```json
[
{
"id": "7575296454722398441",
"caption": "...",
"text": "完整转写文本...",
"duration": 812,
"segments": [{"start": 0, "end": 5.2, "text": "..."}, ...]
}
]
```
**价格**:以 Apify Actor 当前页面为准。
**调用示例**:
```python
apify_caller(
actor="zen-studio/douyin-transcripts-scraper",
input={
"targetLanguage": "zh",
"videoUrls": [video_url1, video_url2, ...]
},
wait_secs=45
)
```
### 3. `apple_yang/douyin-transcripts-scraper` 备选
**用途**:备用转写服务
**输入**:
```json
{
"videoUrl": "https://www.douyin.com/video/..."
}
```
**输出**:同上
**限制**:历史测试中长视频支持不稳定;当前限制以 Actor 页面为准
**价格**:以 Apify Actor 当前页面为准。
## 备选 actor(不推荐)
### `bovi/douyin-scraper`
- 优点:功能多
- 缺点:`user_videos` 模式 2026 起需要登录 cookies,已验证空结果
- 不推荐
### `sian.agency/douyin-scraper`
- 优点:支持 userVideos
- 缺点:可能排队较久,且可能需要登录 cookies
- 不推荐
### `apify--rag-web-browser`
- 用途:网页搜索 + 渲染
- 兜底方案:当 profile scraper 失败时用此搜索主页
- 调用示例:
```python
apify_browser(
query="https://www.douyin.com/user/MS4w...",
max_results=1
)
```
## 经验教训
1. **优先用 zen-studio 系列**,但运行前核对当前访问要求与输入 schema
2. **user_videos 模式 = 需要登录**(2026 现状)→ 慎用 bovi/sian.agency
3. **转写超时**:降低样本或候选时长,并核对 Actor 当前限制
4. **TOON 格式**:Apify 返回的是 TOON 格式,需要手动解析(见 `data-schema.md`)
5. **字段 schema 不稳定**:不同 actor 返回字段名差异大,需要多别名解析(见 `parser.py::_extract_field`)
## 失败兜底顺序
```
zen-studio profile scraper (主)
↓ 失败
apify--rag-web-browser 渲染主页
↓ 失败
WebSearch + 用户手动提供数据
```
```
zen-studio transcripts scraper (主)
↓ 失败
apple_yang transcripts scraper (备用,限制以当前 Actor 页面为准)
↓ 失败
跳过该视频,继续下一个
```AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
- Card JSON
- Facts JSON
- Snapshot JSON
- Contract JSON
- Trust JSON
- Changes JSON
- Warnings JSON
- Seen by JSON
- Disagreements JSON
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/tars1230/skills/douyin-creator-insight",
"sourceUrl": "https://clawhub.ai/tars1230/skills/douyin-creator-insight",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T23:58:08.863Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-tars1230-douyin-creator-insight/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-tars1230-douyin-creator-insight/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T23:58:08.863Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "972 downloads",
"href": "https://clawhub.ai/tars1230/douyin-creator-insight",
"sourceUrl": "https://clawhub.ai/tars1230/douyin-creator-insight",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T23:58:08.863Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.3.6",
"href": "https://clawhub.ai/tars1230/douyin-creator-insight",
"sourceUrl": "https://clawhub.ai/tars1230/douyin-creator-insight",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-05T12:42:37.389Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-tars1230-douyin-creator-insight/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-tars1230-douyin-creator-insight/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.3.6",
"description": "setup/缺Key强制三步:推荐注册页→控制台建Key→export;交互可打开 https://cloud.siliconflow.cn/i/1srulim9",
"href": "https://clawhub.ai/tars1230/douyin-creator-insight",
"sourceUrl": "https://clawhub.ai/tars1230/douyin-creator-insight",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-05T12:42:37.389Z",
"isPublic": true
}
]
}Record generated Oct 12, 2026.
For crawlers
This page is free to read. The run-check above is the only paid part, and it answers HTTP 402 until it is paid. Everything else here is public.
- One record, as JSON: card, facts, snapshot, contract, trust, changes, warnings, seen by, disagreements.
- Every agent, one feed: /.well-known/ai-catalog.json
- What this site sells, and the price: /.well-known/x402
- Paid run-check: /api/v1/agents/clawhub-tars1230-douyin-creator-insight/run-check
