Smart Media Downloader
https://github.com/yizhiyanhua-ai/media-downloader- Category
- AI Agents
- Rank
- No. 1961Tools index
- Pricing
- Open Source
- Type
- TOOL
- Builder
- yizhiyanhua-ai
- GitHub
- 403 stars
- Date
About
Describe what you want and the agent searches and downloads matching images or video clips automatically.
What it does
This Claude Code skill wraps several media sources behind conversational requests and a direct command-line interface. It can fetch stock images, stock footage, YouTube videos, or audio, then trim video to a requested time range. Search-only and local trimming modes are also documented.
Why it's ranked here
The source coverage and trimming workflow make it useful for quickly assembling project assets. Its value comes from combining stock-library retrieval, YouTube handling, audio extraction, and local video cutting. Setup friction remains significant because complete operation depends on external programs, browser cookies, and provider credentials.
What's good
It supports three stock libraries rather than locking image retrieval to one provider. YouTube downloads need no API key, while stock credentials are requested only when needed. Users can choose output locations, limit result counts or clip duration, search without downloading, extract audio, and issue commands in Chinese or English.
Tradeoffs
Image search returns nothing without at least one configured provider key. Stock video coverage excludes Unsplash, while YouTube work requires yt-dlp and trimming requires ffmpeg. YouTube anti-bot checks may force access to a logged-in browser session. The downloader catches broad errors and often reports failure through printed messages or empty results, which can obscure the underlying cause.
How to use it well
Use it when a Claude Code workflow needs a few stock assets, a YouTube segment, extracted audio, or a quick local trim. Check dependency status first, configure only the stock providers you need, and set an explicit output directory. It does not replace media editing, rights review, or asset catalog management.
Technical notes+
media_cli.py is a Python command-line implementation using argparse, requests, subprocesses, environment variables, and filesystem output. It defines ImageDownloader, VideoDownloader, and VideoTrimmer; the supplied source is truncated during the latter class. Search adapters call the Pexels, Pixabay, and Unsplash HTTP APIs, while YouTube search and download shell out to yt-dlp. Availability checks invoke yt-dlp --version and ffmpeg -version. SKILL.md supplies bilingual Claude triggers, setup guidance, and execution policy. README.md and README_CN.md document status, image, video, YouTube, search, and trim CLI modes.
Observed
- License
- MIT License
- Primary language
- Python
- Install surface
- Claude Code skill installed from the GitHub repository, with separate yt-dlp, ffmpeg, and requests dependencies
- Interfaces
- Bilingual Claude Code skill and direct command-line interface
- Media sources
- Pexels and Pixabay for images and video, Unsplash for images, and YouTube for video
- Credential model
- Provider keys come from environment variables; YouTube does not require an API key
Read from README.md, media_cli.py, SKILL.md, README_CN.md.
What it can do
Search for images based on text description
Text description of desired image → Matching image files
Search for video clips based on text description
Text description of desired video content → Matching video files
Download images automatically
Image search results → Downloaded image files on local storage
Download video clips automatically
Video search results → Downloaded video files on local storage
Filter media by user criteria
Search parameters and quality preferences → Filtered list of relevant media files
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.