Douyin

# Douyin Skill

Download videos from Douyin using browser automation.

## Setup (One-Time)

```bash
python -m nodriver_kit.tools.login_interactive --url https://www.douyin.com --profile douyin
```

## Download Video

```bash
python scripts/download.py "https://v.douyin.com/xxx"
python scripts/download.py "https://v.douyin.com/xxx" --info-only
python scripts/download.py "https://v.douyin.com/xxx" --output ./videos
```


# Douyin Skill

A Claude Code skill for downloading Douyin (抖音) videos.

**Usage:** See [SKILL.md](./SKILL.md)

## Dependencies

- [nodriver-kit](https://github.com/anthropics/nodriver-kit)


AGPL-3.0


# Python
__pycache__/
*.py[cod]
*$py.class
*.so
.Python
.venv/
venv/
ENV/
env/

# Data and cache
data/
*.json
*.db
*.log

# IDE
.vscode/
.idea/
*.swp
*.swo
*~

# OS
.DS_Store
Thumbs.db

# Temporary files
*.tmp
temp/


#!/usr/bin/env python3
"""
Download Douyin videos.

Usage:
    python download.py <url> [--output <dir>] [--info-only]

Examples:
    python download.py https://v.douyin.com/xxx
    python download.py https://www.douyin.com/video/123456 --output ./videos
    python download.py https://v.douyin.com/xxx --info-only
"""

import argparse
import asyncio
import json
import logging
import re
import sys
from pathlib import Path
from typing import Any, Dict, List, Optional

import requests

logger = logging.getLogger(__name__)

DEFAULT_PROFILE = "douyin"


async def parse_video(url: str, profile: str = DEFAULT_PROFILE, timeout: int = 30) -> Dict[str, Any]:
    """Parse video info from Douyin URL using CDP network monitoring."""
    from nodriver_kit import cdp, connect_browser, browser_start, browser_stop

    browser = None
    api_responses: List[Dict] = []
    own_browser = False
    started_port = None  # Track port if we started browser

    try:
        # Try to connect to existing browser first
        try:
            browser = await connect_browser(port=9222)
            logger.info("Connected to existing browser on port 9222")
        except Exception:
            # Start new browser using nodriver-kit (handles session restore, etc.)
            logger.info(f"Starting browser with profile: {profile}")
            result = browser_start(profile=profile)
            if "error" in result:
                raise RuntimeError(result["error"])
            started_port = result["port"]
            browser = await connect_browser(port=started_port)
            own_browser = True

        tab = browser.main_tab
        await tab.send(cdp.network.enable())

        request_map: Dict[str, str] = {}

        def on_request(event: cdp.network.RequestWillBeSent):
            req_url = event.request.url
            if "aweme/v1/web/aweme/detail" in req_url:
                request_map[event.request_id.to_json()] = req_url

        async def on_response(event: cdp.network.ResponseReceived):
            req_id = event.request_id.to_json()
            if req_id in request_map:
                try:
                    body_result = await tab.send(cdp.network.get_response_body(event.request_id))
                    api_responses.append(json.loads(body_result[0]))
                except Exception:
                    pass

        tab.add_handler(cdp.network.RequestWillBeSent, on_request)
        tab.add_handler(cdp.network.ResponseReceived, on_response)

        logger.info(f"Navigating to: {url}")
        await tab.get(url)

        for _ in range(timeout):
            await asyncio.sleep(1)
            if api_responses:
                await asyncio.sleep(2)
                break

        current_url = tab.url
        logger.info(f"Page URL: {current_url}")

        # Extract video ID
        video_id = _extract_video_id(current_url) or _extract_video_id(url)

        # Parse API response
        video_url =