torr

prateekmedia's avatarfrom prateekmedia

Search and download torrents using ArcTorrent API and WebTorrent. Use when users request to: (1) Search for torrents across multiple sources, (2) Download content via magnet links, (3) Find torrents filtered by seeder counts, or any torrent-related tasks

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 30, 2025

When & Why to Use This Skill

This Claude skill automates the end-to-end workflow of discovering and retrieving peer-to-peer content by integrating the ArcTorrent API and WebTorrent. It enables users to perform multi-source torrent searches, apply advanced filtering based on seeder counts for optimal health, and execute downloads via magnet links directly through a unified interface, significantly reducing the manual effort required for media and data acquisition.

Use Cases

  • Automated Content Discovery: Search across multiple torrent trackers simultaneously to find specific files, software, or datasets without visiting individual websites.
  • Download Optimization: Filter results by seeder counts to identify the most reliable and high-speed torrents available, ensuring efficient bandwidth usage.
  • Headless Media Management: Retrieve magnet links and initiate downloads to a local or remote directory using simple CLI-based commands integrated with Claude.
  • Bulk Data Acquisition: Streamline the process of finding and downloading large open-source files, such as Linux distributions or public domain archives, for lab environments.
nametorr
descriptionSearch and download torrents using ArcTorrent API and WebTorrent. Use when users request to: (1) Search for torrents across multiple sources, (2) Download content via magnet links, (3) Find torrents filtered by seeder counts, or any torrent-related tasks

Torrent Search & Download

Prerequisites

  • ArcTorrent API at http://localhost:3000
    # Clone to /tmp and start
    cd /tmp && git clone https://github.com/theriturajps/ArcTorrent
    cd ArcTorrent && npm install && npm start &
    
  • jq for JSON parsing
scripts/search.sh <source> "<query>" [page]
scripts/search.sh piratebay "ubuntu iso" 1
scripts/search.sh yts "big buck bunny" 1

Sources

List available sources:

scripts/search.sh --list-sources
# First result
scripts/search.sh piratebay "ubuntu" 1 | head -1 | cut -f4

# Filter by seeders (>10), get first magnet
scripts/search.sh piratebay "ubuntu" 1 | awk -F'\t' '$3+0 > 10 {print $4; exit}'

Download

# Basic download
node scripts/download.js "magnet:?xt=urn:btih:..." /tmp/downloads

# With custom timeout (default: 10800s)
node scripts/download.js "magnet:?xt=urn:btih:..." /tmp/downloads --timeout 3600

# JSON output for automation
node scripts/download.js "magnet:?xt=urn:btih:..." /tmp/downloads --json

Complete Workflow

MAGNET=$(scripts/search.sh piratebay "ubuntu iso" 1 | head -1 | cut -f4)
node scripts/download.js "$MAGNET" /tmp/downloads

Troubleshooting

Issue Fix
API not responding cd /tmp/ArcTorrent && npm start &
Download slow/hangs Filter for seeders > 20; try different source