torr
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
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.
| name | torr |
|---|---|
| description | 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 |
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 & jqfor JSON parsing
Search
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
Get Magnet Link
# 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 |