# paulpierre/informer

A Telegram Mass Surveillance Bot in Python

Repository: https://github.com/paulpierre/informer
Canonical: https://ross.abutalabs.com/products/informer
Homepage: https://www.twitter.com/paulpierre
Language: Python
License: MIT
License Family: permissive
Topics: telegram-bot, telegram, cryptocurrency, telegram-api, telethon-userbot, telethon, telegrambot, telegram-bot-api, surveillance, python, scraper, monitor, spy, listener, listen, bot
Last push: 2025-10-20T23:16:20+00:00

## Health v2 (maintenance only)
Score: 54/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 48, release rhythm 35, longevity 100
- inputs: {"age_days": 2460, "days_push": 317, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1662, forks 243 (observed 2026-08-28T04:05:18.700363+00:00)

## What it is
A Python library built on Telethon that masquerades as real Telegram user accounts to monitor and log messages from hundreds of channels per account. It persists message and channel metadata to MySQL, Google Sheets, and a private Telegram channel for later analysis.

## Use cases
- monitor hundreds of telegram channels for keywords
- scrape telegram channel messages into a database
- track cryptocurrency shilling and sentiment in telegram groups
- run brand monitoring across telegram channels
- log telegram channel activity to google sheets
- analyze telegram channel participants and message volume

## When to choose
- you need to monitor many telegram channels at scale using real user accounts
- you want keyword regex filtering with messages stored in MySQL or Google Sheets
- you want a dockerized, self-hosted telegram listener that stays logged in

## When to avoid
- you need an official Telegram Bot API solution rather than user-account automation
- you require production-grade stability - it is a proof-of-concept with known bugs
- your use case may violate Telegram's terms of service or local surveillance laws

## Facets
- artifact type: library
- maturity: experimental
- function: web-scraping, monitoring, chatbot, database, logging
- domain: messaging-platforms, social-media
- platform: python, self-hosted
- tags: telegram, telethon, userbot, mass-surveillance, channel-monitoring, keyword-filtering, google-sheets, sock-puppet, surveillance, automation, cryptocurrency, docker

## Member repositories
- paulpierre/informer (main) score 54

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:18.700363+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:44:35.332157+00:00, confidence not recorded.
  - readme: https://github.com/paulpierre/informer (fetched 2026-08-28T04:05:18.700363+00:00, sha 30e4a4fb3886)
- Data as of 2026-08-30T08:39:29.467469+00:00.