# 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.