Arekejoker

Douyin Download Skill — Development skill for Claude Code

Development community

抖音作品获取 skill v3.1：分享文本/短链/ID 单入口解析，按需下载图/视频/实况/文案/BGM，带元数据、SHA256 与显式状态；适用 Claude Code / Codex / Cursor / OpenClaw.

How to install Douyin Download Skill

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Arekejoker/douyin-download-skill and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Douyin Download Skill does

Alternatives in Development

Understand Anything — Graphs that teach graphs that impress 80.7k ★
Ralphy — My Ralph Wiggum setup, an autonomous bash script that runs Claude Code, Codex, OpenCode, Cursor agent, Qwen & 2.8k ★
Agentic Stack — One brain, many harnesses 2.2k ★

README

douyin-download — 抖音作品获取 Skill

给 AI agent 用的抖音单作品获取工具（[Agent Skills](https://agentskills.io) 开放格式，Claude Code / Codex / Cursor / OpenClaw 等均可使用）：

分享即用：整段分享口令、v.douyin.com 短链、长链、纯 ID 都能解析
按需下载：原图（自动换全尺寸模板、不删签名参数）、无水印视频（yt-dlp 优先，DOM 兜底）、实况照片、BGM
元数据：作者/粉丝/赞评藏转/发布时间/话题，缺失留空不推测
可靠交付：每个文件 ffprobe 校验 + SHA256，manifest 落盘；显式状态（success / partial / failed + 错误码），不确定不报成功

原理：走浏览器会话（CDP）取平台**本来提供的干净流**，不做后期去水印、不做批量爬取。

安装

选一个：

# 任意 agent（推荐，自动识别 Claude Code / Codex / Cursor 等）
npx skills add Arekejoker/douyin-download-skill

# GitHub 官方 CLI（gh ≥ 2.90）
gh skill install Arekejoker/douyin-download-skill douyin-download --agent claude-code

# OpenClaw
openclaw skills install git:Arekejoker/douyin-download-skill@main

# Claude Code 手动
git clone https://github.com/Arekejoker/douyin-download-skill ~/.claude/skills/douyin-download

装好后对 agent 说：`帮我下载这个抖音 https://v.douyin.com/xxxx/`。

首次准备（一次性，约 2 分钟）

**依赖**：python3.10+、`curl`、`ffprobe`（随 ffmpeg）；Python 包：`pip install -r requirements.txt`（只有 `websockets`）。`yt-dlp` 可选，没有也行（视频有 DOM 兜底）。
**启动一个已登录抖音的 Chrome（挂 CDP 端口）**：
```
# macOS 把 google-chrome 换成对应应用路径
google-chrome --remote-debugging-port=18800 --user-data-dir="$HOME/.douyin-chrome" https://www.douyin.com
```
在弹出的窗口里**扫码登录抖音，然后保持窗口开着**。这个 skill 只在你要东西时连接它，从不自启/重启/清理浏览器。
**自检**：
```
python3 scripts/dy.py doctor   # 全部 required 通过即可用
```
cookie 文件会自动生成（首次 fetch 时），也可以手动 `python3 scripts/dy.py cookies`。

使用

python3 scripts/dy.py resolve "<分享文本 / 短链 / 长链 / ID>"          # 解析出 aweme_id / type
python3 scripts/dy.py fetch  "<分享文本 / 短链 / 长链 / ID>"           # 默认 text,image,video
python3 scripts/dy.py fetch  "<...>" --want text,image,video,audio,cover
python3 scripts/dy.py fetch  "<...>" --route dom                       # 强制 DOM 轨道
python3 scripts/dy.py fetch  "<...>" --out-dir ~/Pictures/douyin       # 指定输出目录
python3 scripts/dy.py doctor