torrentclaw/torrentclaw-skill
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Claude Code skill for TorrentClaw integration
6 commits 1 branch 6 tags 80 KiB
Find a file
Exact
Deivid Soto d3d6c702ed fix(security): eliminate shell injection and add input validation 
Replace unsafe string interpolation in aria2 RPC JSON construction
with jq --arg for proper escaping. Add magnet URL format validation
to reject arbitrary input. Refactor detect-client.sh JSON output
to use jq. Add CI security check to prevent regression.

Resolves VirusTotal "Suspicious" classification caused by the
shell injection vulnerability in add-torrent.sh.
2026-02-15 10:47:10 +01:00
.github/workflows fix(security): eliminate shell injection and add input validation 2026-02-15 10:47:10 +01:00
references docs: align API docs with OpenAPI spec and improve ClawHub discoverability 2026-02-13 20:37:32 +01:00
scripts fix(security): eliminate shell injection and add input validation 2026-02-15 10:47:10 +01:00
.editorconfig feat: initial open-source project structure 2026-02-13 18:40:53 +01:00
.gitignore feat: initial open-source project structure 2026-02-13 18:40:53 +01:00
.lefthookrc feat: initial open-source project structure 2026-02-13 18:40:53 +01:00
CHANGELOG.md fix(security): eliminate shell injection and add input validation 2026-02-15 10:47:10 +01:00
CONTRIBUTING.md feat: initial open-source project structure 2026-02-13 18:40:53 +01:00
lefthook.yml feat: initial open-source project structure 2026-02-13 18:40:53 +01:00
LICENSE Initial commit 2026-02-13 10:55:12 +01:00
Makefile feat: initial open-source project structure 2026-02-13 18:40:53 +01:00
README.md fix(security): eliminate shell injection and add input validation 2026-02-15 10:47:10 +01:00
SKILL.md fix(security): eliminate shell injection and add input validation 2026-02-15 10:47:10 +01:00

README.md

torrentclaw-skill

Version: 0.1.16 License: MIT Homepage: https://torrentclaw.com

Search and download movies and TV shows from 30+ torrent sources directly from your AI agent. TorrentClaw aggregates torrents from YTS, EZTV, Knaben, Prowlarr, Bitmagnet, Torrentio, DonTorrent, Torrents.csv and more — enriched with TMDB metadata, quality scoring, and multi-language support.

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 30+ torrent sources (YTS, EZTV, Knaben, Prowlarr, Bitmagnet, Torrentio, DonTorrent, Torrents.csv, and more)
  • Filter by quality (480p–2160p), genre, year, rating, language, audio codec, HDR format, season/episode
  • HDR and Dolby Vision filtering (hdr10, dolby_vision) and audio codec filtering (AAC, FLAC, Opus, Atmos)
  • Quality scoring (0–100) based on resolution, codec, seeders, source trust
  • Multi-language support (11 languages with accent-insensitive search)
  • TMDB metadata enrichment: posters, backdrops, genres, cast, director credits
  • Detect installed torrent clients (Transmission, aria2) and add magnets directly
  • Download .torrent files or copy magnet links
  • OS-specific installation guides for torrent clients (Linux, macOS, Windows/WSL)
  • API key authentication for higher rate limits (anonymous 30/min, free 120/min, pro 1K/min)

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:

  1. Detect your torrent client (Transmission, aria2)
  2. Search TorrentClaw across 30+ sources
  3. Present results ranked by quality score (0-100)
  4. Add best torrent to your client or provide magnet link
  5. 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

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT — See LICENSE for details.