Get the list of available torrent sources.

Perform an advanced torrent search across multiple providers.

Result Analysis & Ranking:

1. Quality: Prefer 1080p or 4k, over 720p.

2. Efficiency: Prefer h265/HEVC for better quality/size ratio.

3. Health: Maximize seeders + leechers.

4. Size: Prefer smaller files within the same quality bracket.

5. Language: Ultimately, if multiple equivalent options are available, choose the one with more languages.

Response Requirements:

• Recommend the top 3-5 results maximum.

• For each recommendation, include: Filename, Size, Seeds/Leechs, Date, Source, and a 1-sentence "Why this?" reason.

• If results are poor, irrelevant or too diverse, suggest specific keywords to improve the search.

Get the most popular torrents right now across providers with an official top listing.

Output is grouped per source (thepiratebay.org, uindex.org, 1337x.to, eztvx.to, yts.vg, nyaa.si), keeping up to per_source results per site, each site's entries pre-ranked by swarm health.

Response Requirements:

• Recommend the top 5-10 results maximum, focused on latest releases.

• For each recommendation, include: Filename, Size, Seeds/Leechs, Date, Source, and a 1-sentence "Why this?" reason.

Get the magnet link for a specific torrent by id.

Authorize a browser on the Torrent Search webapp via its pairing code.

The code comes from an user interaction on the webapp: they click "Open in Telegram", scan the QR code, or copy the prompt message, which sends "Authorize for Torrent Search" to you. Take the code from that message and call this tool with it and the user's Telegram chat id. Codes are single-use and expire after 5 minutes. After approval the user MUST go back to the webapp: the browser polls and completes the authentication there (it shows "Access granted" and unlocks the app permanently).

Present the Torrent Search webapp and its Telegram pairing access system.

Returns the webapp URL and how to get authorized by you. Tell the user to open the URL: on first visit the site shows a pairing dialog with a QR code and buttons ("Open in Telegram", "t.me" fallback, "Copy Prompt"). Ask the user to scan the QR code, click "Open in Telegram", or copy the prompt message and send it to you in the Telegram chat. That message ("Authorize for Torrent Search") carries the code; when it arrives, extract it and call authorize_webapp with it and the user's Telegram chat id. Codes expire after 5 minutes.