tag-hunter/README.md

Tag Hunter

Simple Python TUI/CLI utility for finding Telegram nicknames that:

1. Do not appear to belong to a user, channel, or group on Telegram.
2. Do not show up as an auction/sale listing on Fragment.

This MVP uses public web pages, not private Telegram credentials or Fragment tokens. It also retries on 429 and transient 5xx responses with exponential backoff.

Run

python tag_hunter.py nicknames.txt

Or run without arguments and enter the file path interactively.

Input format

One nickname per line. Leading @ is optional.

alice
@bob
charlie_123

Notes

• The checker is best-effort. Public pages can change, and some usernames may be reported as UNKNOWN if the response is ambiguous or the site rate-limits too aggressively.
• The estimated runtime shown at startup is approximate and depends on network latency and retries.