Agent Skill for searching and downloading torrents via TorrentClaw. Includes SKILL.md with OpenClaw metadata, bash scripts for torrent client detection, CONTRIBUTING.md, CHANGELOG.md, CI/CD with GitHub Actions (shellcheck + conventional commits), lefthook git hooks, Makefile, and .editorconfig.
3.2 KiB
torrentclaw-skill
Version: 0.1.13 License: MIT Homepage: https://torrentclaw.com
Agent Skill for searching and downloading torrents via TorrentClaw.
Compatible with Claude Code, OpenClaw, Codex CLI, Cline, Roo Code, and any tool supporting the Agent Skills specification.
Alternative: For Claude Desktop, Cursor, or Windsurf, use the MCP Server instead (npx @torrentclaw/mcp).
Features
- Search movies and TV shows across 12+ torrent sources (YTS, EZTV, Knaben, Prowlarr, Bitmagnet, Torrentio, DonTorrent, Torrents.csv, and more)
- Filter by quality (480p-2160p), genre, year, rating, language, season/episode (S01E05, 1x05)
- API key authentication for higher rate limits (120 req/min free, 1K req/min pro)
- Quality scoring (0-100) based on resolution, codec, seeders, source trust
- Multi-language support (11 languages with accent-insensitive search)
- Detect installed torrent clients (Transmission, aria2)
- Add magnet links directly to your torrent client
- Download .torrent files or copy magnet links
- OS-specific installation guides for torrent clients
Install
Claude Code
# Personal (all projects)
ln -s /path/to/torrentclaw-skill ~/.claude/skills/torrentclaw
# Or project-specific
ln -s /path/to/torrentclaw-skill .claude/skills/torrentclaw
OpenClaw
claw skill install torrentclaw
# or from local
ln -s /path/to/torrentclaw-skill ~/.openclaw/skills/torrentclaw
ClawHub
clawhub install torrentclaw
Usage
/torrentclaw "Inception 1080p"
/torrentclaw "Breaking Bad S05E14"
/torrentclaw "best 4K movies 2024"
Or just ask naturally:
"Find me Inception in the best quality" "I need Breaking Bad season 5 episode 14" "Search for sci-fi movies from 2023 in 4K"
The skill will:
- Detect your torrent client (Transmission, aria2)
- Search TorrentClaw across 12+ sources
- Present results ranked by quality score (0-100)
- Add best torrent to your client or provide magnet link
- Show install guide if no client detected
Scripts
| Script | Purpose |
|---|---|
scripts/detect-client.sh |
Detect Transmission/aria2 and output JSON |
scripts/add-torrent.sh |
Add magnet to detected client |
scripts/install-guide.sh |
Show OS-specific install instructions |
API
Public API at https://torrentclaw.com/api/v1/.
Authentication: Optional. Anonymous usage allows 30 req/min. API keys provide higher limits:
- Free tier: 120 req/min, 1,000 req/day
- Pro tier: 1,000 req/min, 10,000 req/day
See references/api-reference.md for full documentation and SKILL.md for workflow examples.
Links
- Website: https://torrentclaw.com
- Skill Documentation: https://torrentclaw.com/skill
- MCP Server: https://torrentclaw.com/mcp
- API Reference: https://torrentclaw.com/api/docs
- OpenAPI Spec: https://torrentclaw.com/api/openapi.json
- Changelog: CHANGELOG.md
- GitHub: https://github.com/torrentclaw/torrentclaw-skill
Contributing
See CONTRIBUTING.md for guidelines.
License
MIT — See LICENSE for details.