O que telegram-agent faz?
Skill universal para agente Telegram no Claude Code, Codex CLI, Cursor, Gemini CLI, Cline, Windsurf. Carregamento sob demanda com ~50x menos contexto que MCP. Inclui CLI autônomo, SKILL.md e instalação com um comando.
Instalação
Via script (recomendado)
bash <(curl -sL https://raw.githubusercontent.com/beautyfree/telegram-agent/main/install.sh)
Manual
-
Clone o repositório:
git clone https://github.com/beautyfree/telegram-agent.git cd telegram-agent -
Configure as variáveis de ambiente:
export TELEGRAM_BOT_TOKEN="seu_token_aqui" export TELEGRAM_CHAT_ID="seu_chat_id_aqui" -
Execute o agente:
python telegram_agent.py
Uso
Enviar mensagem
from telegram_agent import TelegramAgent
agent = TelegramAgent()
agent.send_message("Olá, mundo!")
Enviar foto
agent.send_photo("caminho/para/foto.jpg", "Legenda opcional")
Enviar documento
agent.send_document("caminho/para/documento.pdf")
Comandos CLI
python telegram_agent.py --send "Sua mensagem"
python telegram_agent.py --photo caminho/para/foto.jpg
python telegram_agent.py --document caminho/para/documento.pdf
python telegram_agent.py --help
Configuração
| Variável | Descrição | Obrigatório |
|---|---|---|
TELEGRAM_BOT_TOKEN | Token do bot obtido no BotFather | Sim |
TELEGRAM_CHAT_ID | ID do chat para onde enviar mensagens | Sim |
TELEGRAM_API_URL | URL personalizada da API (opcional) | Não |
Carregamento sob demanda
Este skill é carregado sob demanda, consumindo apenas ~50x menos contexto que implementações MCP equivalentes. O agente só carrega quando necessário, liberando recursos preciosos do contexto.
Plataformas suportadas
- ✅ Claude Code
- ✅ Codex CLI
- ✅ Cursor
- ✅ Gemini CLI
- ✅ Cline
- ✅ Windsurf
Licença
MIT - Consulte o arquivo LICENSE para mais detalhes.