funstat BOT 完整功能列表（基于截图分析）

# funstat BOT 完整功能列表

## 基于用户截图的功能发现

**更新时间**: 2025-10-26 14:10

---

## BOT 完整信息

- **真实名称**: funstat | infostat (RESERVE LINK)
- **显示名称**: KT超级数据
- **用户名**: @openaiw_bot
- **类型**: Telegram 数据查询与群组搜索服务

### 数据库规模 💎
- **用户**: 1,012,339,264 人
- **群组/频道**: 50,704,308 个
- **消息**: 91,122,802,688 条

---

## 已确认的命令列表

### 核心命令

| 命令 | 功能描述 | 参数示例 |
|------|---------|---------|
| `/start` | 启动 BOT，显示欢迎信息和帮助 | - |
| `/menu` | 显示主菜单（内联键盘） | - |
| `/balance` | 查看积分余额 | - |
| `/search` | 群组搜索 | 关键词 |
| `/topchat` | 群组目录（热门群组） | - |
| `/text` | 通过消息文本搜索 | 消息内容 |
| `/human` | 通过名字搜索用户 | 用户名 |

### 查询功能（通过直接发送）

根据 `/start` 信息，BOT 支持以下查询方式：

| 查询类型 | 说明 |
|---------|------|
| `username` | 发送用户名查询用户信息 |
| `user id (or group)` | 发送用户 ID 或群组 ID 查询 |
| `contact` | 发送联系人查询 |
| `sticker (detect author)` | 发送贴纸检测作者 |
| `link to message in group` | 发送群组消息链接 |
| `forward message from group` | 转发群组消息进行查询 |

---

## 主菜单按钮功能

`/menu` 命令会显示以下功能按钮：

| 按钮 | 功能 |
|------|------|
| 🛒 Buy | 购买积分 |
| 🕵️ Hide data | 隐藏个人数据 |
| 💎 Coins | 积分管理 |
| ⛏️ Mine | 我的信息/个人中心 |
| 🔄 Mirrors | 镜像功能 |
| 📊 Top chats | 热门聊天排行 |
| 👥 Tracked users | 追踪的用户列表 |
| 🔑 My access | 我的访问权限 |
| 🏆 Auction | 拍卖功能 |
| 📬 Catching msg | 捕获消息 |
| 📰 News | 新闻/公告 |

---

## 用户状态信息

`/menu` 命令会返回用户状态：

```
You have 339 💎

├ status: Client [?]
├ me: 7363537082
├ referals: 4
├ stealth: No
├ /lang: en

Total in 4 week: -81
├ Consumption: -105
```

### 字段说明
- **💎 积分**: 当前可用积分
- **status**: 用户等级（Client/VIP 等）
- **me**: 用户 ID
- **referals**: 推荐人数
- **stealth**: 隐身模式状态
- **lang**: 语言设置
- **Total in 4 week**: 4 周总消耗
- **Consumption**: 消耗量

---

## 免费测试配置

BOT 提供以下免费测试 ID：
- 7745296119
- 994270689
- 7864982459
- 5095649820
- 5933194496
- 7695732077

---

## MCP 工具接口设计（v2）

基于完整功能，重新设计 MCP 工具：

### 1. funstat_search_groups
搜索群组
```json
{
  "command": "/search",
  "parameters": {
    "query": "搜索关键词"
  }
}
```

### 2. funstat_search_by_text
通过消息文本搜索
```json
{
  "command": "/text",
  "parameters": {
    "text": "消息内容"
  }
}
```

### 3. funstat_search_by_name
通过名字搜索用户
```json
{
  "command": "/human",
  "parameters": {
    "name": "用户名"
  }
}
```

### 4. funstat_query_user
查询用户信息
```json
{
  "parameters": {
    "user_id": "用户 ID 或用户名"
  }
}
```

### 5. funstat_get_top_chats
获取热门群组
```json
{
  "command": "/topchat"
}
```

### 6. funstat_get_balance
查看积分余额
```json
{
  "command": "/balance"
}
```

### 7. funstat_get_menu
获取主菜单状态
```json
{
  "command": "/menu"
}
```

---

## 待探索的功能

以下按钮功能需要进一步测试：

- [ ] Buy - 购买流程
- [ ] Hide data - 隐藏数据的具体操作
- [ ] Coins - 积分详细管理
- [ ] Mine - 个人中心功能
- [ ] Mirrors - 镜像具体用途
- [ ] Tracked users - 如何添加/管理追踪用户
- [ ] My access - 权限管理详情
- [ ] Auction - 拍卖机制
- [ ] Catching msg - 消息捕获设置
- [ ] News - 新闻内容

---

## 下一步测试计划

1. 测试所有命令的响应格式
2. 测试按钮点击后的回调处理
3. 测试各种查询方式的输入格式
4. 测试积分消耗机制
5. 测试错误处理（余额不足、查询失败等）