enzosantana-mv/telegram-ai-scope

O que telegram-ai-scope faz?

Monitor do Telegram com IA 2026: Classificação de Mensagens em Tempo Real e Painel de Insights

Visão Geral

Esta skill transforma seu ambiente de desenvolvimento em um sistema de monitoramento inteligente para grupos e canais do Telegram. Ao conectar-se à API do Telegram, ela captura mensagens em tempo real, aplica modelos de IA (como transformadores ou LLMs) para classificar conteúdo por tópico, sentimento ou intenção, e exibe os resultados em um painel de insights interativo. Foi projetada para desenvolvedores que desejam automatizar moderação, analisar comunidades ou criar dashboards personalizados sem complexidade extra.

Funcionalidades Principais

• Classificação em Tempo Real: Cada mensagem recebida é processada por modelos de NLP para categorização.
• Painel de Insights: Visualize métricas como volume de mensagens, palavras-chave frequentes, distribuição de sentimentos e tendências ao longo do tempo.
• Integração Simples: Conecte-se a qualquer grupo ou canal do Telegram usando um bot token.
• Extensível: Adicione novos classificadores, fontes de dados ou saídas (Slack, webhooks, bancos de dados).
• Compatível com Múltiplos Agentes: Funciona com Claude Code, Cursor, Codex e outras plataformas de agentes de IA.

Como Funciona

1. Configuração: Forneça o token do seu bot do Telegram e os IDs dos chats a monitorar.
2. Captura: O sistema escuta eventos de mensagens via API (long polling ou webhook).
3. Classificação: Cada mensagem é enviada a um pipeline de IA que identifica tópico, sentimento (positivo/negativo/neutro) e intenção (pergunta, comando, spam, etc.).
4. Dashboard: Os resultados são agregados em um painel web (incluído) com gráficos atualizados em tempo real.

Exemplo de Uso

# Instalar dependências
pip install python-telegram-bot transformers pandas flask

# Configurar variáveis de ambiente
export TELEGRAM_BOT_TOKEN="seu_token_aqui"
export TELEGRAM_CHAT_IDS="-1001234567890"
export CLASSIFICATION_MODEL="distilbert-base-uncased-finetuned-sst-2-english"

# Executar o monitor
python monitor.py

# Exemplo de classificador customizado
from telegram_ai_scope import Classifier

class SentimentClassifier(Classifier):
    def classify(self, message):
        # Lógica com transformers
        return {"sentiment": "positive", "confidence": 0.92}

Plataformas Suportadas

• Claude Code
• Cursor
• Codex
• Qualquer ambiente Python 3.8+ com agentes de IA

Dependências

• python-telegram-bot
• transformers (Hugging Face)
• pandas
• flask ou fastapi (para dashboard)

Contribuição

Contribuições são bem-vindas! Abra issues ou pull requests no repositório oficial.

Licença

MIT