Telegram Scraping & Intelligence Platform

Harrier is a web-based tool for scraping Telegram channels and groups, looking up user profiles, and alerting on keyword matches - built as a spiritual successor to telegram-scraper.

• Scrapes messages, media, and reactions from any Telegram channel or group you have access to
• Supports forum channels with automatic topic separation
• Continuous scraping mode - re-checks for new messages at a configurable interval
• User lookup by phone number or username - pulls profile info, bio, badges, and historic profile photos
• Keyword-based webhook alerts to Discord, Slack, or any custom endpoint
• Exports scraped data as CSV, JSON, or ZIP archive
• Live dashboard with real-time progress via WebSocket

• Backend: Python, FastAPI, Telethon, SQLite
• Frontend: React, Vite

• Python 3.11–3.13 (3.14+ not supported - will auto-install via pyenv if needed)
• Node.js 18+

git clone https://github.com/skuggrev/harrier.git
cd harrier
./start.sh

On first run start.sh will install Python and frontend dependencies automatically, then start the app.

Opens at http://localhost:3000

Everything is configured from the Settings page in the UI - API credentials, download directory, webhook URL, and keywords. Get your API credentials from my.telegram.org/apps.

Once your API ID and API Hash are saved, you need to authenticate your Telegram account. The recommended way is QR code - open Telegram on your phone, go to Settings > Devices > Link Desktop Device, and scan the code shown in the UI. Alternatively you can log in with your phone number and the SMS code Telegram sends you.

MIT - see LICENSE

If you find this useful: ko-fi.com/skuggrev