uc-cli — unknowncheats.me in your terminal

Browse forums, threads, and search UnknownCheats from the command line. Handles Cloudflare bypass, authenticated sessions, and clean terminal output.

Install

pip install git+https://github.com/overtimepog/uc-cli.git
# or for dev:
git clone https://github.com/overtimepog/uc-cli.git
cd uc-cli && pip install -e .

Requires Python 3.9+.

Usage

Browse

# List forum categories
uc forums

# List threads in a forum (by URL slug)
uc threads anti-cheat-bypass
uc threads counter-strike-2-a

# View a thread — accepts ID, URL, or path
uc thread 753248
uc thread https://www.unknowncheats.me/forum/anti-cheat-bypass/753248-steelseries-sonar.html
uc thread anti-cheat-bypass/753248-slug.html

# Search (experimental)
uc search "gpu spoof"

Auth

uc login       # prompts for username + password (or use -u/-p flags)
uc whoami      # check login status
uc logout      # clear session

Sessions persist automatically — cookies are saved to ~/.config/uc-cli/cookies.json and reused across invocations. If uc whoami shows "Not logged in", re-run uc login.

Thread reference formats

All of these work with uc thread:

Input	Example
Numeric ID	753248
Full URL	https://www.unknowncheats.me/forum/anti-cheat-bypass/753248-slug.html
Relative path	anti-cheat-bypass/753248-slug.html

How it works

• Transport: cloudscraper session (Cloudflare bypass) with graceful fallback to requests
• Parsing: BeautifulSoup + lxml
• Auth: GET index → extract CSRF token → POST login → persist cookies

Dev

pip install -e ".[dev]"
pytest -v          # 26 tests with mock HTML fixtures
pytest --cov=uc_cli

Project layout

uc-cli/
  uc_cli/
    cli.py       — Click CLI (forums, threads, thread, search, login, logout, whoami)
    scraper.py   — fetch_page, parsing (forums, threads, search), session management
    auth.py      — login, logout, session persistence (~/.config/uc-cli/cookies.json)
  tests/
    conftest.py           — shared fixtures
    fixtures/*.html       — mock HTML
    test_scraper.py       — 7 tests
    test_cli.py           — 8 tests
    test_auth.py          — 11 tests
  pyproject.toml

Known issues

• Forum listing (uc forums) may return empty — the live homepage DOM differs from test fixtures. Use uc threads <slug> directly as a workaround.
• Sticky threads show blank author — intentional; forum announcements don't have the usual "by username" markup.
• Search is experimental — not verified against all query types, may return empty.
• Cloudflare 403: ensure cloudscraper>=1.2 is installed. Stale versions get cf-mitigated: challenge.
• Cookie expiry: UC sessions can expire server-side even if the cookie file exists. Re-run uc login.

License

MIT