torrent-scrapers 0.0.1

Simple collection of scrapers of popular torrent sites.

Torrent Scraper Collection

Collection of web scrapers of popular torrent sites.

Currently package provides scrapers for:

• 1337x
• The Pirate Bay

---

🚀 Features

• Scrape torrent listings (name, seeders, leechers, size, uploader, etc.)
• Fetch magnet links
• Handle pagination and search filters (category, sorting)
• Easily extendable to other torrent sites
• Logs warnings for missing data, connection errors and timeouts

Installation

You can install the package from pypi or clone the repository.

Package

pip install torrent-scrapers

Manual installation

🧱 Requirements

• Python 3.10+
• requests
• beautifulsoup4

Clone repository

git clone https://github.com/flisakl/torrent-scrapers
cd torrent-scrapers

Install dependencies

pip install requests beautifulsoup4

🛠 Usage

Using built in scraper

from scrapers import Scrapper1337, SearchParams

scraper = Scrapper1337()

params = SearchParams(
    name="ubuntu",
    order_column="seeders",
    order_ascending=False
)

results = scraper.find_torrents(params, pages=(1, 2))
scraper.get_magnet_links(results)

for torrent in results:
    print(torrent.name, torrent.magnet)

🧩 Making your own scraper

To add support for a new torrent site:

1. Subclass Scrapper
2. Implement the following methods:
   • get_request_data
   • parse_response
   • fetch_magnet_link - implement when magnet link can not be obtained on site's search page

🔧 Structures

TorrentInfo

Dataclass containing torrent informations

Field	Type	Description
name	str	Search term
url	str	URL for torrent detail page
seeders	int	Number of seeders
leechers	int	Number of leechers
size	str	Size of torrent's data
uploader	str	Optional name of torrent uploader
magnet	str	Magnet link

SearchParams

Immutable dataclass for filters

Field	Type	Description
name	str	Search term
category	str	Optional category
order_column	str	Sorting column
order_ascending	bool	Sort order

If order_column is set to None, ordering will not be applied.