# video-downloader

> Download videos from YouTube, Bilibili, Douyin, Xiaohongshu, Instagram, Twitter with best quality MP4 format

- Author: zhuyifan
- Repository: kiligzzz/kiligz-skills
- Version: 20260124204059
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/kiligzzz/kiligz-skills
- Web: https://mule.run/skillshub/@@kiligzzz/kiligz-skills~video-downloader:20260124204059

---

---
name: video-downloader
description: Download videos from YouTube, Bilibili, Douyin, Xiaohongshu, Instagram, Twitter with best quality MP4 format
---

# Video Downloader Skill

## When to Use

When user asks to download a video or provides a video URL from supported platforms.

## How to Use

1. Use the `Bash` tool to run the downloader script
2. Command: `python3 .claude/skills/video-downloader/scripts/video_downloader.py "<video_url>"`

## Supported Platforms

| Platform | URL Patterns | Notes |
|----------|-------------|-------|
| YouTube | youtube.com, youtu.be | Best quality with cookies |
| Bilibili | bilibili.com, bilibili.tv | 1080P high-bitrate with premium, supports favlists/playlists |
| Douyin | douyin.com, v.douyin.com | Login required |
| TikTok | tiktok.com | Login required |
| Xiaohongshu | xiaohongshu.com | Login required |
| Instagram | instagram.com | Login recommended |
| Twitter/X | twitter.com, x.com | Login recommended |

## Features

- **Auto-detection**: Automatically detects platform from URL
- **Best Quality**: Downloads bestvideo + bestaudio, merged to MP4
- **Smart Cookies**: Automatically fetches from browser (priority: Edge -> Chrome)
- **Dedicated Downloaders**: Each platform has its own optimized downloader

## Usage

### Unified Entry (Auto-detect)
```bash
python3 .claude/skills/video-downloader/scripts/video_downloader.py "<video_url>"
```

### Individual Platform Downloaders
```bash
# YouTube
python3 .claude/skills/video-downloader/scripts/youtube_downloader.py "https://www.youtube.com/watch?v=..."

# Bilibili
python3 .claude/skills/video-downloader/scripts/bilibili_downloader.py "https://www.bilibili.com/video/BV1o9KUzwEiq"

# Bilibili Favoritelist (download all videos in a favorites list)
python3 .claude/skills/video-downloader/scripts/bilibili_downloader.py "https://space.bilibili.com/307997763/favlist?fid=3407901663&ftype=create"

# Douyin
python3 .claude/skills/video-downloader/scripts/douyin_downloader.py "https://v.douyin.com/A3oE_mcr85U/"

# Xiaohongshu
python3 .claude/skills/video-downloader/scripts/xiaohongshu_downloader.py "https://www.xiaohongshu.com/explore/..."

# Instagram
python3 .claude/skills/video-downloader/scripts/instagram_downloader.py "https://www.instagram.com/p/..."

# Twitter/X
python3 .claude/skills/video-downloader/scripts/twitter_downloader.py "https://twitter.com/.../status/..."
```

## Files Structure

```
/Users/ivan/.claude/skills/video-downloader/
├── SKILL.md                      # Skill documentation
└── scripts/
    ├── video_downloader.py       # Unified entry (auto-detect)
    ├── youtube_downloader.py     # YouTube
    ├── bilibili_downloader.py    # Bilibili
    ├── douyin_downloader.py      # Douyin/TikTok
    ├── xiaohongshu_downloader.py # Xiaohongshu
    ├── instagram_downloader.py   # Instagram
    ├── twitter_downloader.py     # Twitter/X
    └── output/                   # Downloaded videos (relative path)
```

## Notes

- **Cookies**: Automatically fetched from Edge (priority) -> Chrome
- **Fallback**: If cookies not available, automatically tries lower quality download
- **Portable**: All scripts use relative paths - works on any machine
- **Output**: Videos saved to `../../skills-work/video-downloader/` (relative to skill directory)