# telegram-group-analytics-bot

This skill tracks Telegram group activity: member growth, message counts, hourly heatmaps and scheduled reports you can export.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 610 installs · ★ 5
- Author: reason-machines
- License: LicenseRef-Unknown · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/data-skills/tree/HEAD/skills/telegram-group-analytics-bot/SKILL.md
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/skills/telegram-group-analytics-bot

## What it does

The skill gives your agent a set of tools for reading Telegram group activity. It counts joins and leaves, messages per user, and builds hourly and daily heatmaps. Reports go out as CSV, HTML or PDF, and the schedule lives in `config.json` — a daily report at 09:00, for instance.

Under the hood is the `telegram_analytics` Python library with `GroupAnalyzer`, `MessageTracker`, `ReportGenerator`, `AlertManager` and `DataExporter`. Everything lands in a `stats.db` database. The bot also answers commands in the chat itself: `/stats`, `/growth`, `/activity`, `/export csv`. Alerts fire when message counts or active users drop below thresholds you set.

You need a bot token from @BotFather and the group ID, passed through `TELEGRAM_BOT_TOKEN` and `TELEGRAM_GROUP_ID`. Without those, nothing runs. Python and the packages in `requirements.txt` are required too.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/data-skills --skill telegram-group-analytics-bot -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/telegram-group-analytics-bot/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/telegram-group-analytics-bot/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/data-skills --skill telegram-group-analytics-bot -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/telegram-group-analytics-bot/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/data-skills --skill telegram-group-analytics-bot -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/telegram-group-analytics-bot/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/data-skills telegram-group-analytics-bot
```

2. **Manually: put the files in place**
- File: `.github/skills/telegram-group-analytics-bot/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/data-skills --skill telegram-group-analytics-bot -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/data-skills --path skills/telegram-group-analytics-bot
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/telegram-group-analytics-bot/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/data-skills --skill telegram-group-analytics-bot -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/data-skills/tree/HEAD/skills/telegram-group-analytics-bot/SKILL.md

## When to use it
- measure member growth and churn over a week
- find the most active posters in a month
- build an hourly activity heatmap
- export group stats to CSV or PDF
- set up a daily report with an activity threshold

## Example prompts
- analyze Telegram group stats for the last 7 days
- generate a weekly activity report and save it as PDF
- show the top 10 users by message count

## Similar
- [telegram](https://affpapa.org/en/nevibecode/plugins/telegram.md) — plugin · ★ 44635
- [telegram-mini-app](https://affpapa.org/en/nevibecode/skills/sickn33-telegram-mini-app.md) — skill · 1700 installs
- [business-analytics-reporter](https://affpapa.org/en/nevibecode/skills/business-analytics-reporter.md) — skill · 2200 installs
- [discord-bot](https://affpapa.org/en/nevibecode/skills/discord-bot.md) — skill · 5300 installs

From the same set: [reason-machines/data-skills](https://affpapa.org/en/nevibecode/by/reason-machines/data-skills.md) — 22 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md