whether the copy is AI-generated
title strategy
persuasion methods
logical flaws / manipulation / exaggeration

Output contract

Produce:

short status update in chat
transcript note in Obsidian
analysis note in Obsidian
final chat summary with note paths

Workflow

1. Resolve the real video page

Open the Douyin URL in Chrome if needed.
Extract:
- canonical video URL
- title
- description
- account name
- visible chapter points / page text
Be explicit about what came from page metadata vs full transcript.

2. Extract media URLs if possible

Prefer reading browser performance resources from the actual loaded page.
Capture candidate audio/video stream URLs.
If direct download gets 403, retry with browser-derived headers/cookies when available.
Save temporary files under /tmp/douyin_transcribe/.

3. Transcribe audio

Prefer a local/offline path.
Current practical path on this machine:
- Python venv in /tmp/douyin_transcribe/venv
- mlx-whisper
First pass:
- use a smaller model to get a usable draft quickly
If needed:
- do a second pass or manual cleanup for readability
Clearly label transcript status:
- raw machine transcript
- cleaned readable version
- final polished version

4. Summarize before criticizing

Before any critical-thinking judgment, always do these two steps:

A. Content summary

produce a concise summary of what the video actually says
separate hook / core claim / support / conclusion
avoid mixing your judgment into the summary

B. Useful information + evidence extraction

List the video's actually useful information and pair each item with the evidence the video itself provides. For each item, give an initial confidence judgment:

high
medium
low

This prevents the analysis from becoming pure attitude.

5. Analyze critically

Always cover, unless the user narrows scope:

what the video is actually saying
whether the title/hook exaggerates or distorts the case
whether the script appears AI-generated / AI-assisted / human-written
emotional triggers used
hidden assumptions
survivorship bias / overgeneralization / false lessons
what is genuinely useful vs what is manipulative or shallow

6. Save into Obsidian

Default destination:

transcript note → OpenClaw/Inbox/YYYY-MM-DD 抖音视频口播转写 - <topic>.md
analysis note → OpenClaw/Inbox/YYYY-MM-DD 抖音视频分析 - <topic>.md

Include:

source URL
canonical URL
account name if available
what was directly obtained vs inferred
transcript quality warning if imperfect

Response rules

Never pretend a full transcript was obtained if only page metadata was captured.
If only metadata is available, say so plainly.
Distinguish between:
- page title/description analysis
- full script analysis
Prefer usefulness over theatrical certainty.

Local implementation notes

Useful browser path

Probe browser bridge
Use macOS Chrome bridge to:
- open the page
- evaluate page JS
- inspect visible text
- inspect performance.getEntriesByType("resource")

Useful temporary files

/tmp/douyin_transcribe/audio*.mp4
/tmp/douyin_transcribe/venv

Suggested helper scripts

A. Grab page and audio

python3 /Users/bobzhong/.openclaw/workspace/skills/douyin-video-analysis/helpers/douyin_grab.py '<douyin-url>'

It will:

open the Douyin page in Chrome
fetch page metadata from the loaded Chrome tab
extract candidate media URLs
attempt authenticated audio download via curl with copied headers/cookies
return JSON containing canonical URL, title, body preview, audio URL, and local audio path

B. Transcribe and create notes

python3 /Users/bobzhong/.openclaw/workspace/skills/douyin-video-analysis/helpers/transcribe_and_note.py \
  --audio-file /tmp/douyin_transcribe/audio_latest.mp4 \
  --title '<video-title>' \
  --source-url '<shared-url>' \
  --page-url '<canonical-url>' \
  --account '<creator>' \
  --topic '<short-topic>'

It will:

transcribe the local audio with mlx-whisper
create a transcript note in Obsidian
create an analysis-note skeleton in Obsidian
return both note paths as JSON

Limits

Some videos may block direct media download.
Machine transcripts may contain proper noun and number errors.
Large-model transcription may be slow; start fast, then refine if needed.

When done

Tell the user:

whether transcript is metadata-only / rough transcript / cleaned transcript
where the notes were saved
whether further cleanup would materially improve the analysis

douyin-video-analysis

Douyin Video Analysis

Scope

Inputs