Telegram Bot, Terminal CLI, 또는 MCP Server(AI Agent용)를 통해 Telkomsel 계정 관리에 기반한 도구입니다.

특징

• 세션 캐싱과 SMS OTP 로그인
• • 프로필, 균형, 할당량 검사
• ☸ Browse 권장 패키지
• ∅️ 구매 패키지 (Pulsa / QRIS)
• 자동 구매 모니터 (쿼타가 사용자 정의 MB 임계값의 밑에 depleted 때 자동 추적)
• OTP 웹훅을 통해 자동 재로그인 (설명서 개입없이 세션 갱신)
• AI Agent 통합을 위한 MCP 서버

빠른 시작

형태

설치 (Pre-build Binaries)

Go를 설치하거나 직접 빌드하지 않으려면 Windows, Linux 및 macOS의 사전 컴파일 실행을 다운로드 할 수 있습니다 Releases 이 저장소의 페이지.

바이너리를 전 세계적으로 설치하기 위해 당신은 어떤 폴더에서 telbot]을 실행할 수 있습니다:

** 리눅스 / macOS:**

1. 릴리스 페이지에서 적절한 바이너리를 다운로드합니다.

2. 파일 실행을 만드십시오:

3. 글로벌 빈 디렉토리로 이동:

4. 명세.

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)