Go-инструмент для управления учетными записями Telkomsel через Telegram Bot, Terminal CLI или MCP Server (для агентов ИИ).

Особенности

• SMS OTP login с кэшированием сеанса Профиль, баланс, проверка квот Просмотреть рекомендуемые пакеты Купить пакеты (Pulsa / QRIS) Монитор автоматической покупки (автопокупка, когда квота исчерпана или ниже пользовательского порога MB) Автоматическая перерегистрация через OTP webhook (обновление сеанса без ручного вмешательства) MCP-сервер для интеграции агентов ИИ

Быстрый старт

Режимы

Флаг → Описание → [скрыто] [скрыто] [скрыто] [скрыто] | --bot | Телеграм-бот (требуется .env конфигурация) | --cli | Интерактивный интерфейс терминала (Bubbletea) | --mcp | MCP-сервер для агентов ИИ (stdio) |

##Установка (предварительно построенные двоичные файлы)

Если вы не хотите устанавливать Go или создавать его самостоятельно, вы можете загрузить предварительно скомпилированные исполняемые файлы для Windows, Linux и macOS непосредственно со страницы Releases этого репозитория.

Чтобы установить двоичный файл глобально, вы можете запустить telbot из любой папки:

**Linux / macOS: ** 1.Скачайте соответствующий двоичный файл со страницы Релизы. 2.Сделать файл исполняемым:

3. Переместите его в глобальный каталог бин:

Telbot

Go-based tool for managing Telkomsel accounts via Telegram Bot, Terminal CLI, or MCP Server (for AI agents).

Features

• 🔑 SMS OTP login with session caching
• 📊 Profile, balance, quota checking
• 📦 Browse recommended packages
• 🛍️ Purchase packages (Pulsa / QRIS)
• ⏰ Auto-buy monitor (auto-purchase when quota is depleted or below a custom MB threshold)
• 🔄 Auto re-login via OTP webhook (session renewal without manual intervention)
• 🤖 MCP server for AI agent integration

Quick Start

git clone https://github.com/0xtbug/telbot
cd telbot
cp .env.example .env   # fill in your tokens
go mod tidy

Modes

go run . --bot       # Telegram bot
go run . --cli       # Terminal UI
go run . --mcp       # MCP server

Installation (Pre-built Binaries)

If you don’t want to install Go or build it yourself, you can download the pre-compiled executables for Windows, Linux, and macOS directly from the Releases page of this repository.

To install the binary globally so you can run telbot from any folder:

Linux / macOS:

1. Download the appropriate binary from the Releases page.
2. Make the file executable:

   chmod +x telbot-linux-amd64  # Replace with your downloaded file name
   

3. Move it to your global bin directory:

   sudo mv telbot-linux-amd64 /usr/local/bin/telbot
   

4. You can now run telbot from anywhere in your terminal.

Windows:

1. Download the Windows .exe executable from the Releases page.
2. Rename the downloaded file to telbot.exe.
3. Move it to a permanent folder, for example C:\telbot\.
4. Open the Windows Start menu, search for Edit the system environment variables, and open it.
5. Click Environment Variables, find Path in the System variables list, and click Edit.
6. Click New, add C:\telbot\, and click OK to save everything.
7. You can now run telbot from any new PowerShell or Command Prompt window.

Environment Variables

You can either export these directly in your terminal, or place them in a .env file located in your platform’s standard configuration directory:

• Windows: %APPDATA%\telbot\.env (e.g., C:\Users\\AppData\Roaming\telbot\.env)
• Linux/macOS: ~/.config/telbot/.env

🤖 AI Agent Integration (OpenClaw)