TeleScout v1.0.0

TeleScout v1.0.0 — first public release. 🛰️

Discover, scrape and score public Telegram channels for advertising research — with or without the Telegram API. One service layer powers a Streamlit UI, a Typer CLI and a typed FastAPI service.

Highlights

• 🧠 Explainable 0–100 quality score + engagement rate (ERR), with a per-component breakdown surfaced in telescout explain, the Excel/JSON export and the API.
• 🔎 Two engines: official Telegram API (Telethon) and a credential-free Web Discovery mode with wave-based post-link graph expansion.
• 🧰 Three interfaces, one pipeline — identical ranked, scored, audit-logged results everywhere.
• 📊 Analytics tab, SQLite cache, per-run JSON audit trail + auto-saved Excel.
• ✅ 102 tests, ruff + mypy clean, CI on Python 3.11 & 3.12, Docker (UI + API), installable wheel.

Try it in 30 seconds: pip install -e ".[ui,api]" then telescout demo.

Full CHANGELOG.