33 lines
884 B
Markdown
33 lines
884 B
Markdown
# 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
|
|
|
|
```bash
|
|
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.
|
|
|
|
```text
|
|
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.
|