douyin-obsidian

Extract Douyin video transcripts and image-note content into structured Obsidian Markdown notes.

61|5|Updated Aug 6, 2026
One-click install
npx skills add https://github.com/zzybrim/douyin-obsidian --skill douyin-obsidian-zzybrim
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: douyin-obsidian
Source: https://github.com/zzybrim/douyin-obsidian
Command: npx skills add https://github.com/zzybrim/douyin-obsidian --skill douyin-obsidian-zzybrim

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, ffmpeg-python, playwright, and includes scripts (resource) components.

What problem does it solve? Manually transcribing Douyin videos and saving image-note content into a knowledge base is tedious and error-prone. This Skill automates the full pipeline from a Douyin share link to a structured, archived Markdown note in your Obsidian vault. ## Core Features & Use Cases - Video Post Extraction: Downloads watermark-free videos, extracts audio with FFmpeg, and transcribes speech via the SiliconFlow API into full transcripts. - Image-Note Extraction: Pulls the text body of Douyin image-text posts and batch-downloads all images, with no API key required. - Structured Archiving: Generates tiered (light/standard/deep) structured Markdown notes with frontmatter, wikilinks to assets, and organized output folders following Obsidian conventions. - Anti-Scraping Fallback: Automatically degrades to a Playwright-driven Chrome browser extraction when standard page parsing is blocked by Douyin's anti-bot measures. - Use Case: Send a Douyin share link to your AI agent and receive a complete knowledge-base note with transcript, downloaded media, and linked attachments, ready for review in Obsidian. ## Quick Start Send a Douyin share link to the agent and ask it to extract the content and save it as a note in your Obsidian vault.

Frequently Asked Questions about douyin-obsidian

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract a transcript from a Douyin video?

Run the pipeline script with the share link and the extract action. It downloads the watermark-free video, extracts audio with FFmpeg, and transcribes speech using the SiliconFlow API, saving the result as transcript.md.

How do I download images from a Douyin image-text post?

Use the extract action on an image-note share link. The tool detects the post type automatically, pulls the body text, and batch-downloads all images as image_001.jpg and similar files, with no API key needed.

Does Douyin extraction require an API key?

Only video posts require a SiliconFlow API key for speech recognition, stored locally in ~/.douyin-video/config.json. Image-text posts and link parsing work without any API key.

What happens when Douyin blocks standard link parsing?

The pipeline automatically falls back to a browser-based method using Playwright with your installed Chrome, calling the detail API with cooldown retries. No manual intervention is needed unless both methods fail.

Why does video transcription fail with an FFmpeg error?

FFmpeg must be installed for audio extraction. Run the setup.py script to install it automatically, or install it manually via brew on macOS or apt on Linux, then verify with the setup script.