Cap 验证码服务管理（tokengx-cap-admin）

前置条件

本技能依赖 TokenGX CAPTCHA MCP 连接器（mcp__tokengx-cap）。使用前需在 ~/.workbuddy/mcp.json 中添加连接器配置：

{
  "mcpServers": {
    "tokengx-cap": {
      "url": "https://cap.tokengx.cn/mcp",
      "headers": {
        "Authorization": "Bearer <你的_TokenGX_API_Key>"
      },
      "disabled": false
    }
  }
}

请前往 TokenGX 控制台获取你自己的 API Key，替换 <你的_TokenGX_API_Key>。配置完成后需在 WorkBuddy 连接器管理页面点击「Trust」启用该连接器。

Overview

本技能通过 TokenGX CAPTCHA MCP 连接器（mcp__tokengx-cap）提供人机验证服务的站点管理、token 验证和数据统计功能。适用于需要查看验证码站点配置、验证用户提交的 CAPTCHA token、或分析验证数据的场景。

可用工具

本技能依赖以下 MCP 工具，均通过 mcp__tokengx-cap__ 前缀调用：

核心工作流

1. 检查服务状态

当用户想了解验证服务是否正常运行时：

1. 调用 mcp__tokengx-cap__get_service_info 获取服务版本和状态
2. 向用户汇报服务运行状态、版本信息

2. 查看站点列表

当用户想查看所有验证码站点时：

1. 调用 mcp__tokengx-cap__list_sites 获取站点列表
2. 展示每个站点的名称、siteKey 及最近24小时统计

3. 查看站点详情与统计

当用户需要某个站点的详细配置或统计数据时：

1. 询问用户要查看的站点 siteKey（若已知则直接使用）
2. 调用 mcp__tokengx-cap__get_site，传入 siteKey 和可选的 duration 参数
3. duration 可选值：today、yesterday、last7days、last28days、last91days、alltime，默认 last7days
4. 展示站点配置、验证次数、成功率等统计数据

4. 验证 CAPTCHA Token

当用户需要验证一个 CAPTCHA token 是否有效时：

1. 确认用户提供的 token 和对应的 siteKey
2. 调用 mcp__tokengx-cap__verify_token，传入 token 和 siteKey
3. token 格式为三段式：siteKey:challenge:signature
4. 向用户汇报验证结果（有效/无效/过期等）

5. 查看地理分布统计

当用户需要了解验证请求的来源地理分布时：

1. 询问用户要查看的站点 siteKey
2. 调用 mcp__tokengx-cap__get_geo_stats，传入 siteKey
3. 展示国家分布、ASN 分布、平台和操作系统统计

6. 查看封禁列表

当用户需要查看站点的封禁策略时：

1. 询问用户要查看的站点 siteKey
2. 调用 mcp__tokengx-cap__get_blocked_ips，传入 siteKey
3. 展示被封禁的 IP 地址、CIDR 范围、ASN 和国家列表

注意事项

• 所有需要 siteKey 参数的工具，如果用户不知道 siteKey，先调用 list_sites 获取站点列表，帮助用户选择
• token 验证的三段式格式为 siteKey:challenge:signature，验证时需同时提供 token 和 siteKey
• MCP 连接器使用 Bearer 认证，认证凭证由用户自行在 ~/.workbuddy/mcp.json 中配置，参见上方「前置条件」段落