Telegram BOT (@openaiw_bot) 探索与 MCP 封装项目

# Telegram BOT (@openaiw_bot) 探索与 MCP 封装项目

## 项目概述

本项目旨在将 Telegram BOT `@openaiw_bot` (KT超级数据) 封装成 MCP (Model Context Protocol) 工具，使其能够被 Claude Code 直接调用。

## BOT 基本信息

- **BOT 名称**: KT超级数据
- **BOT 用户名**: @openaiw_bot
- **BOT ID**: 8410096573
- **BOT Token**: `8410096573:AAFLJbWUp2Xog0oeoe7hfBlVqR7ChoSl9Pg`
- **功能类型**: 数据查询服务

### BOT 能力
- 可以加入群组: ✅
- 可以读取所有群消息: ❌
- 支持内联查询: ❌
- 可连接到商业账户: ❌

## 已发现的命令

根据 BOT 的命令配置，目前已确认以下命令：

| 命令 | 描述 | 状态 |
|------|------|------|
| `/start` | 🚀 开始使用机器人 | ✅ 已确认 |
| `/search` | 🔍 搜索数据 | ✅ 已确认 |
| `/balance` | 💰 查看积分余额 | ✅ 已确认 |

## 探索工具

已创建以下 Python 脚本用于探索 BOT 功能：

### 1. explore_bot.py
- 获取 BOT 基本信息
- 获取命令列表
- 查找可用的 chat_id

### 2. test_bot_commands.py  
- 自动测试所有命令
- 等待并捕获 BOT 响应
- 保存测试结果到 JSON

### 3. check_webhook.py
- 检查 Webhook 配置
- 确保可以使用 polling 模式（getUpdates）

### 4. check_history.py
- 查看历史消息记录
- 分析对话内容和格式

### 5. interact_with_bot.py
- 实时监听 BOT 消息
- 交互式测试工具
- 记录完整的消息交互日志

## 技术细节

### Webhook 状态
- 当前未配置 Webhook
- 使用 polling 模式（getUpdates API）
- pending_update_count: 0

### API 基础信息
- API 基础 URL: `https://api.telegram.org/bot{BOT_TOKEN}`
- 支持的方法:
  - `getMe` - 获取 BOT 信息
  - `getUpdates` - 获取消息更新
  - `sendMessage` - 发送消息
  - `getMyCommands` - 获取命令列表
  - `getWebhookInfo` - 获取 Webhook 信息

## 待确认信息

以下信息需要通过实际交互来确认：

1. **命令参数格式**
   - `/search` 命令的具体使用方法
   - 需要什么参数？
   - 支持什么类型的搜索？

2. **响应格式**
   - 文本响应的结构
   - 是否有内联按钮或键盘
   - 是否返回图片或文档

3. **积分系统**
   - `/balance` 返回什么信息？
   - 如何获取积分？
   - 积分的用途？

4. **其他隐藏命令**
   - 是否有 `/help` 命令？
   - 是否有其他未列出的命令？

## MCP 工具设计（草案）

基于目前已知信息，初步设计的 MCP 工具接口：

### Tool 1: openaiw_search
```json
{
  "name": "openaiw_search",
  "description": "使用 KT超级数据 BOT 搜索数据",
  "parameters": {
    "query": "搜索关键词"
  }
}
```

### Tool 2: openaiw_get_balance
```json
{
  "name": "openaiw_get_balance",
  "description": "查询 KT超级数据 BOT 的积分余额",
  "parameters": {}
}
```

### Tool 3: openaiw_start
```json
{
  "name": "openaiw_start",
  "description": "初始化与 KT超级数据 BOT 的会话",
  "parameters": {}
}
```

## 下一步行动

1. ⏳ 等待用户在 Telegram 中测试 BOT 并提供反馈
2. ⏳ 分析 BOT 的实际响应格式
3. ⏳ 完善 MCP 工具接口设计
4. ⏳ 实现 MCP 服务器代码
5. ⏳ 测试完整的 MCP 工具功能

## 相关文件

- `explore_bot.py` - BOT 探索脚本
- `test_bot_commands.py` - 命令测试脚本
- `check_webhook.py` - Webhook 检查脚本
- `check_history.py` - 历史消息查看脚本
- `interact_with_bot.py` - 交互式监听工具

---

**创建时间**: 2025-10-26  
**项目状态**: 🔄 进行中 - 等待 BOT 功能确认