douyin-video-processor

# Douyin Video Processor

Process Douyin (TikTok China) share links: extract video speech to text, get watermark-free download URLs, and download videos locally.

## First-Time Setup

Before using any script, install the Python dependencies:

```bash
bash scripts/install_deps.sh
```

This installs `requests` and `dashscope`. Only needed once.

## Environment Variable

The text extraction feature requires `DASHSCOPE_API_KEY` from Alibaba Cloud Bailian.

The user must set this before you can call `douyin_extract_text.py`. If it is not set, tell the user:

> To use text extraction, you need an Alibaba Cloud Bailian API key.
> 1. Go to https://help.aliyun.com/zh/model-studio/get-api-key
> 2. Create an API key (starts with `sk-`)
> 3. Set it: `/secrets set DASHSCOPE_API_KEY sk-your-key`

The other two scripts (parse and download) do **not** need any API key.

## Available Scripts

### 1. Parse Video Info (no API key needed)

Extract video metadata (ID, title, watermark-free URL) from a Douyin share link.

```bash
python3 scripts/douyin_parse.py "SHARE_LINK"
```

**Input:** A Douyin share link or text containing one (e.g. `https://v.douyin.com/xxxxx/` or a full share text like `"7.29 复制打开抖音... https://v.douyin.com/xxxxx/"`)

**Output:** JSON to stdout:
```json
{
  "status": "success",
  "video_id": "7345678901234567890",
  "title": "Video title here",
  "download_url": "https://..."
}
```

**When to use:** User wants to see video info, or you need the download URL without downloading the file.

---

### 2. Download Video (no API key needed)

Download a watermark-free video file to local disk.

```bash
python3 scripts/douyin_download.py "SHARE_LINK" [output_directory]
```

**Input:**
- Arg 1: Douyin share link or text containing one
- Arg 2 (optional): Output directory, defaults to current directory

**Output:** JSON to stdout:
```json
{
  "status": "success",
  "video_id": "7345678901234567890",
  "title": "Video title here",
  "file_path": "/absolute/path/to/video....

# Douyin Video Processor — OpenClaw Skill

Extract text from Douyin (TikTok China) videos, get watermark-free download links, and download videos — all from within OpenClaw.

## What It Does

| Capability | API Key Needed? |
|---|:---:|
| Parse video info (ID, title, URL) from share link | No |
| Download watermark-free video to local file | No |
| Transcribe video speech to text (Chinese + English) | Yes |

## Quick Setup

### 1. Install the Skill

```
/skills install @yzfly/douyin-video-processor
```

### 2. Get an API Key (for text extraction only)

Go to [Alibaba Cloud Bailian](https://help.aliyun.com/zh/model-studio/get-api-key) and create an API key.

### 3. Set the Key

```
/secrets set DASHSCOPE_API_KEY sk-your-key-here
```

Done. Start pasting Douyin links.

## Usage

**Extract text from video:**
> "Extract text from this Douyin video: https://v.douyin.com/xxxxx/"

**Get download link:**
> "Get the download link for this Douyin video: https://v.douyin.com/xxxxx/"

**Download video:**
> "Download this Douyin video: https://v.douyin.com/xxxxx/"

**Batch processing:**
> "Transcribe all these Douyin videos: [link1] [link2] [link3]"

## How It Works

This skill ships 3 standalone Python scripts. No external MCP server or service is needed — everything runs locally (except the Alibaba Cloud ASR API call for text extraction).

| Script | Purpose |
|--------|---------|
| `scripts/douyin_parse.py` | Parse share link → video metadata JSON |
| `scripts/douyin_download.py` | Parse + download watermark-free .mp4 |
| `scripts/douyin_extract_text.py` | Parse + transcribe speech to text via Alibaba Cloud ASR |

All scripts accept a Douyin share link as input and output JSON to stdout.

## Requirements

- Python 3.10+
- Python packages: `requests`, `dashscope` (auto-installed via `scripts/install_deps.sh`)

## Cost

- Parsing and downloading are **completely free**
- Text extraction uses Alibaba Cloud ASR — very low per-minute pricing

## Security

- API key is only sent to...