Package Exports
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@subdown/skill) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
SubDownload Skill for Claude
Fetch YouTube transcripts, search videos, browse channels and playlists — instant YouTube data inside Claude.
Anthropic Agent Skill that teaches Claude when and how to use the SubDownload MCP server.
⚡ Install in one command
Claude Code / Cursor / Windsurf
npx @subdown/skillThat's it. Restart Claude Code and ask about any YouTube video.
Install scope:
npx @subdown/skill # user-wide (~/.claude/skills/subdownload)
npx @subdown/skill --project # this project (./.claude/skills/subdownload)Claude.ai (web) / Claude Desktop
- Download: subdownload-skill.zip
- Claude.ai → Settings → Capabilities → Skills → + Create skill → upload the zip
- New chat — the skill activates whenever you mention YouTube
🔌 Add the MCP server (one-time, required)
The skill calls tools from our hosted MCP. Pick your client:
| Client | How |
|---|---|
| Claude.ai / Claude Desktop | Settings → Connectors → Add custom connector → paste https://api.subdownload.com/mcp → sign in with Google |
| Claude Code / Cursor | Add to .mcp.json — see below |
| Gemini CLI | gemini extensions install https://github.com/SubDownload/Skills (coming soon) or add mcpServers entry manually |
| ChatGPT (Developer Mode) | Settings → Developer Mode → Add MCP server → https://api.subdownload.com/mcp |
.mcp.json (Bearer token)
{
"mcpServers": {
"subdownload": {
"url": "https://api.subdownload.com/mcp",
"headers": { "Authorization": "Bearer sk_live_xxx" }
}
}
}Get a key at subdownload.com/account — 150 free credits, no card required.
🎯 What you can ask
- "Summarize this video: https://youtu.be/dQw4w9WgXcQ"
- "What are @mkbhd's latest iPhone review videos?"
- "Search YouTube for Rust async tutorials, top 10"
- "Translate this transcript to Chinese:
" - "List all videos from the @veritasium channel"
🛠 Tools in this skill
| Tool | Purpose | Cost |
|---|---|---|
fetch_transcript |
Transcript / captions in any language | 1 credit |
search_youtube |
Global search (videos, channels, playlists) | 1 credit |
resolve_channel |
@handle / URL → channel info |
Free |
get_channel_latest_videos |
Newest uploads from a channel | Free |
list_channel_videos |
Paginated channel video list | 1 / page |
search_channel_videos |
Search within one channel | 1 credit |
list_playlist_videos |
Paginated playlist contents | 1 / page |
Errors never consume credits — only HTTP 200 is charged.
💰 Pricing
- Free: 150 credits (Google sign-in, no card)
- Pro: 10,000 credits
- 2 endpoints always free (
resolve_channel,get_channel_latest_videos) - 200 req/min per key
🔗 Links
- Website — subdownload.com
- Dashboard & API keys — subdownload.com/account
- API docs — api.subdownload.com/docs
- OpenAPI spec — api.subdownload.com/openapi.yaml
- LLM-friendly docs — api.subdownload.com/docs/llms-full.txt
- MCP server — api.subdownload.com/mcp