douyin_downloader · diff
git:20260406.6129a11 to git:20260730.13a8f56
24 added, 24 removed. Audit C to C.
# SKILL.md — Video Downloader Extension
- ## Mô tả
- Extension **Downloader** cho phép tải video từ TikTok và Douyin (DouYin).
+ ## Description
+ The **Downloader** extension allows downloading videos from TikTok and Douyin (DouYin).
- ## Khi nào dùng
- - User gửi link TikTok hoặc Douyin kèm yêu cầu tải
- - User yêu cầu "tải video", "download video", "lấy video" VÀ CÓ KÈM URL
+ ## When to use
+ - User sends a TikTok or Douyin link along with a download request
+ - User requests "tải video", "download video", "lấy video" AND INCLUDES A URL
- > ⛔ **KHÔNG DÙNG** khi: tin nhắn không chứa URL video, tin nhắn chỉ là chào hỏi/chat thường.
+ > ⛔ **DO NOT USE** when: the message contains no video URL, the message is just a greeting/casual chat.
- ## Cách kích hoạt (AI OUTPUT JSON)
+ ## How to trigger (AI OUTPUT JSON)
- ### Tải video từ URL:
+ ### Download video from URL:
```json
{"action": "download_video", "url": "https://www.douyin.com/video/XXXXXXX"}
```
- ### Formats URL được hỗ trợ:
- - `https://www.douyin.com/video/<VIDEO_ID>` — Douyin video trực tiếp
+ ### Supported URL formats:
+ - `https://www.douyin.com/video/<VIDEO_ID>` — Douyin direct video
- `https://www.tiktok.com/@<user>/video/<ID>` — TikTok video
- `https://vm.tiktok.com/<SHORT_CODE>` — TikTok short URL
- `https://v.douyin.com/<SHORT_CODE>` — Douyin short URL
- `https://www.iesdouyin.com/share/video/<ID>` — Douyin share link
## API Endpoints
- | Method | Path | Mô tả |
+ | Method | Path | Description |
|--------|------|-------|
| POST | `/api/v1/douyin_downloader/parse` | Parse video info: `{"url": "..."}` |
- | POST | `/api/v1/douyin_downloader/download` | Tải video: `{"url": "..."}` |
- | GET | `/api/v1/douyin_downloader/status/{task_id}` | Check tiến trình |
- | GET | `/api/v1/douyin_downloader/history` | Lịch sử tải |
+ | POST | `/api/v1/douyin_downloader/download` | Download video: `{"url": "..."}` |
+ | GET | `/api/v1/douyin_downloader/status/{task_id}` | Check progress |
+ | GET | `/api/v1/douyin_downloader/history` | Download history |
| GET | `/api/v1/douyin_downloader/file/{filename}` | Serve file |
- ## Workflow tự động (AI tự hành)
- 1. AI nhận URL từ user
- 2. AI output JSON `{"action": "download_video", "url": "..."}`
- 3. Hệ thống gọi `/parse` → lấy download URL
- 4. Hệ thống gọi `/download` → tải file
- 5. Bot Telegram gửi file trực tiếp cho user (sendDocument)
+ ## Automated workflow (AI autonomous)
+ 1. AI receives the URL from the user
+ 2. AI outputs JSON `{"action": "download_video", "url": "..."}`
+ 3. The system calls `/parse` → gets the download URL
+ 4. The system calls `/download` → downloads the file
+ 5. The Telegram bot sends the file directly to the user (sendDocument)
- ## QUAN TRỌNG
- - **KHÔNG bao giờ** hướng dẫn user vào Dashboard để tải
- - **LUÔN LUÔN** output JSON action để hệ thống tự tải
- - Sau khi tải xong, file được gửi trực tiếp về Telegram
+ ## IMPORTANT
+ - **NEVER** instruct the user to go to the Dashboard to download
+ - **ALWAYS** output the JSON action so the system downloads automatically
+ - After downloading, the file is sent directly to Telegram