ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

torrent-downloader

Search magnet links for movies/TV shows and download via qBittorrent. Automatically scores and ranks results by subtitle availability and resolution. Triggers: download movie, download TV show, magnet download, BT download, torrent download, find resources, 下载电影, 下载剧, 磁力下载, BT下载, 种子下载, 帮我下, 找资源.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/d19310/torrent-downloader
Or

Torrent Downloader

Search magnet links for movies and TV shows, auto-rank by quality, and push to qBittorrent for download.

Prerequisites

  • qBittorrent with Web UI enabled (default: http://localhost:8080)
  • Python 3 (no extra packages needed — uses only stdlib)

Configuration

Set these environment variables (or edit the scripts directly):

VariableDefaultDescription
QBT_URLhttp://localhost:8080qBittorrent Web UI URL
QBT_USERadminqBittorrent username
QBT_PASSadminadminqBittorrent password

Workflow

  1. Search magnet links using keyword
  2. Auto-score results (built-in Chinese subtitles > external subs; 1080P/4K preferred)
  3. Pick the best result and push to qBittorrent
  4. Report download status to user

Search

python3 {baseDir}/scripts/search_magnet.py "keyword" [--prefer-4k] [--limit N]
  • Default preference: 1080P. Add --prefer-4k for 4K priority.
  • Scoring: built-in Chinese subtitles (+100) > external subtitles (+50); 4K (+80/40) > 1080P (+60/30)
  • Output: JSON with results[].magnet, results[].title, results[].score

Download

python3 {baseDir}/scripts/qbt_download.py "<magnet_url>" [--category CATEGORY]

Check Download Status

python3 {baseDir}/scripts/qbt_download.py --status

Agent Behavior Rules

  • After search, pick the highest-scored result and start download — don't show the search list to user
  • After download starts, tell user: title, file size, resolution info
  • If no results found, retry with English title
  • Honor user's resolution preference when specified
Read Full Documentation on GitHub

Metadata

Author@d19310
Stars3409
Views0
Updated2026-03-25
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-d19310-torrent-downloader": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.