Auto-Publishing Skill for Douyin Videos

Usage Scenarios

• When users need to publish videos to Douyin
• When users say "post to Douyin", "upload to Douyin", "publish to Douyin"
• When users have video files that need to be distributed to the Douyin platform

Technical Principles

1. Scan the QR code to log in for the first use and save cookies
2. Auto-login using cookies for subsequent uses
3. Automatically fill in information such as title, hashtags, cover, etc.
4. Supports scheduled publishing

Prerequisites

1. Install Dependencies

pip install playwright
playwright install chromium

2. Obtain Cookies via Initial Login

python .opencode/skills/auto-douyin/scripts/get_cookie.py

Workflow

Step 1: Verify Login Status

python .opencode/skills/auto-douyin/scripts/check_cookie.py

python .opencode/skills/auto-douyin/scripts/get_cookie.py

Step 2: Prepare Video Files

• Format:

  .mp4

  (recommended)
• Resolution: 1080x1920 is recommended (vertical 9:16)
• File size: It is recommended not to exceed 4GB

.png

.jpg

Step 3: Publish Video

python .opencode/skills/auto-douyin/scripts/publish.py \
    --video "path/to/video/file" \
    --title "Video Title" \
    --tags "hashtag1,hashtag2,hashtag3" \
    [--cover "path/to/cover/image"] \
    [--schedule "2025-01-31 18:00"]

Parameter Description

--video

-v

--title

-t

--tags

-g

--cover

-c

--schedule

-s

--headless

Usage Examples

# Publish immediately, auto-generate cover
python .opencode/skills/auto-douyin/scripts/publish.py \
    -v ~/Videos/demo.mp4 \
    -t "I learned a super practical trick today" \
    -g "dry-goods-sharing, efficiency-improvement, learning"

# Scheduled publishing with specified cover
python .opencode/skills/auto-douyin/scripts/publish.py \
    -v ~/Videos/demo.mp4 \
    -t "Weekend Vlog | A cozy time alone" \
    -g "vlog, weekend-daily, life-recording" \
    -c ~/Videos/demo_cover.png \
    -s "2025-02-01 18:00"

# Headless mode (run in background)
python .opencode/skills/auto-douyin/scripts/publish.py \
    -v ~/Videos/demo.mp4 \
    -t "Test Video" \
    --headless

Directory Structure

.opencode/skills/auto-douyin/
├── skill.md              # Skill documentation
├── scripts/
│   ├── get_cookie.py     # Obtain login cookies
│   ├── check_cookie.py   # Check cookie validity
│   └── publish.py        # Main video publishing script
└── cookies/
    └── douyin.json       # Cookie storage file (auto-generated)

Notes

1. Cookie Validity Period: Cookies usually have a long validity period, but if not used for a long time or the platform is updated, you may need to log in again
2. Publishing Frequency: It is recommended to control the publishing frequency to avoid being identified as abnormal behavior by the platform
3. Title Limit: Douyin titles are limited to 30 characters; excess will be automatically truncated
4. Number of Hashtags: It is recommended to add 3-5 relevant hashtags to increase exposure
5. Cover Selection: If no cover is specified, the system will automatically select a recommended cover from the video
6. Scheduled Publishing: The scheduled time must be after the current time and within the time range allowed by the platform

Frequently Asked Questions

Q: What to do if cookies expire?

get_cookie.py

Q: What to do if upload fails?

Q: How to publish in batches?

publish.py

Reference Project