🔗 CLAW Bridge · API 接入方案

让 AI 助手帮你查

析芒全迹 CLAW Bridge 为 OpenCLAW、Hermes Agent 等 AI 助手提供数据查询能力，用自然语言即可查询司法信息、企业背景、身份验证等 30+ 个数据模块。

🔌 支持平台

以下两种主流 AI 助手接入方案均已兼容

🦞

OpenCLAW

开源 CLAW 协议框架
配置 MCP Server 即用

🤖

Hermes Agent

自定义 Tool / Skill
自然语言触发查询

✅ 也支持 curl、Postman、Python requests 等任何 HTTP 客户端

📋 使用流程

三步开启 AI 智能查询

1

下载析芒全迹 APP

在官网 下载页面 下载最新版本 APP，安装后使用手机号注册登录。

2

开启 AI 智能查询

在 APP「我的 → AI 智能查询」页面，点击「立即开启」生成专属 API Key。
⚠️ 系统会展示完整 Key 一次，请务必复制保存。

3

配置 AI 助手

将生成的 API Key 和接口地址填入 OpenCLAW / Hermes 的配置中，即可用自然语言查询。

💡 新用户福利： 注册即送免费查询额度，可直接体验 AI 查询功能。

⚙️ 配置方法

选择你的 AI 助手，按对应配置接入

🦞 OpenCLAW 🤖 Hermes Agent 📡 curl 直调

OpenCLAW 配置

在 OpenCLAW 的 mcp_servers.json 或配置文件中添加 MCP Server：

mcp_servers.json 
{
  "mcpServers": {
    "xmqj-query": {
      "url": "https://xmqjglht.top/api/claw/v1",
      "headers": {
        "X-API-Key": "xmqj_u1_your_api_key_here"
      },
      "type": "openclaw"
    }
  }
}
📖 使用方式：配置完成后，在 OpenCLAW 对话中直接说："查张三的失信记录"、"查询某科技有限公司的工商信息"、"验证王五的身份证"。AI 会自动识别查询模块和参数，调用对应接口。

Hermes Agent 配置

在 Hermes 的 ~/.hermes/config.yaml 中添加自定义 Tool：

~/.hermes/config.yaml 
# Hermes Agent 自定义 Tool
tools:
  xmqj_query:
    type: http
    method: POST
    url: https://xmqjglht.top/api/claw/v1/query
    headers:
      X-API-Key: xmqj_u1_your_api_key_here
    body:
      module_code: "{{module}}"
      params: {{params}}
    description: 析芒全迹背景调查数据查询

  xmqj_modules:
    type: http
    method: POST
    url: https://xmqjglht.top/api/claw/v1/modules
    headers:
      X-API-Key: xmqj_u1_your_api_key_here
    description: 获取所有可查询模块列表

  xmqj_quota:
    type: http
    method: POST
    url: https://xmqjglht.top/api/claw/v1/quota
    headers:
      X-API-Key: xmqj_u1_your_api_key_here
    description: 查询剩余查询额度
📖 使用方式：配置后，在 Hermes Agent 中可以说："帮我查一下张三的失信信息"，Hermes 会自动调用 xmqj_query Tool。

curl 直调

直接用 curl 调用 API 进行测试：

获取模块列表 
# 获取模块列表
curl -X POST https://xmqjglht.top/api/claw/v1/modules \
  -H "X-API-Key: xmqj_u1_your_api_key_here" \
  -H "Content-Type: application/json"
查询失信被执行人 
# 查询失信被执行人
curl -X POST https://xmqjglht.top/api/claw/v1/query \
  -H "X-API-Key: xmqj_u1_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "module_code": "dishonest_person",
    "params": {
      "name": "张三",
      "id_card": "110101199001011234"
    }
  }'
查询剩余额度 
# 查询剩余额度
curl -X POST https://xmqjglht.top/api/claw/v1/quota \
  -H "X-API-Key: xmqj_u1_your_api_key_here" \
  -H "Content-Type: application/json"

📡 API 端点

认证方式：请求头 X-API-Key 传入 API Key

方法端点说明
GET/api/claw/v1/rules获取最新调用规则及版本号（无需认证，AI 自动版本协商）
POST/api/claw/v1/modules获取所有可查询模块列表（旧版，建议改用 rules）
POST/api/claw/v1/quota查询剩余查询额度
POST/api/claw/v1/query执行数据查询（核心接口）

请求格式

POST /api/claw/v1/query 
{
  "module_code": "dishonest_person",
  "params": {
    "name": "张三",
    "id_card": "110101199001011234"
  }
}

响应格式

响应示例 
{
  "success": true,
  "data": {
    "result": { ... },
    "cost": 1,
    "quota_remaining": {
      "free": 8,
      "paid": 5
    }
  }
}
⭐ 版本协商机制： /api/claw/v1/rules 返回包含 version 字段（当前 v3），AI Agent 应每次查询前调用此接口比较版本号。若 server.version 高于本地缓存，则自动拉取新规则替换缓存，重新选择模块。这确保模块增减或调整后 AI 自动适配，无需手动更新配置。
⚠️ 重要提醒：
  • API Key 仅创建时展示一次，请妥善保管，丢失需在 APP 中重置
  • 每个 Key 按月计算额度上限（默认 500 次/月）
  • 超过月度限额会返回 429 状态码，次月自动重置
  • 建议使用 HTTPS 调用，确保传输安全

💬 查询示例

接入后，你可以像聊天一样查询数据

⚖️ 司法查询

"查张三的失信记录"
"李四名下有哪些涉诉案件"
"查某科技有限公司的涉诉信息"

✅ 身份验证

"验证王五的身份证 110101199001011234"
"验银行卡 6228480012345678"
"查张三和李四的婚姻状态"

🏢 企业查询

"查某科技有限公司的工商信息"
"某建筑公司有哪些资质"
"查广州凡科的涉诉记录"

💳 信用评估

"查张三的社保缴纳情况"
"李四的个税评估"
"名下关联企业查询"

🚗 车辆查询

"查车牌 京A12345 的车五项"
"张三名下有哪些车辆"

🧮 金融工具

"算10万元1年的利息"
"迟延履行利息计算"
"查我的剩余额度"

📦 查询模块一览

目前支持 30+ 个数据模块，持续新增中

失信被执行人个人涉诉查询 个人涉诉(详版)企业工商信息 企业模糊查询企业涉诉查询 企业涉诉(详版备)企业资质查询 企业工程资质名下关联企业 公户开户行身份信息核验 银行卡信息核验银行卡类型归属地 运营商查询婚姻状态匹配 社保评估个税评估 车辆五项名下车辆 车牌查车五项法院案件详情 劳动仲裁查询利息计算器 迟延履行利息组合查询 批量查询被执行人查询 限制高消费终本案件查询 裁判文书检索
📌 最新模块：双人婚姻状态匹配（支持输入男女双方姓名及身份证号查询是否存在婚姻关系）、名下关联企业查询（通过身份证号查询名下担任法人、股东、高管的企业列表）。

📋 完整配置模板

将下方整个模板复制后发送给你的 AI 助手，AI 会自动识别并执行配置。
模板从服务器动态加载，内容始终为最新版本。

正在加载模板... 

            

            

                
                
复制后手动将模板中的 {{API_KEY}} 替换为你的实际 API Key

            

        

    


    

        

            
❓ 常见问题

            

                

                    
Q: 如何获取 API Key？

                    
下载析芒全迹 APP，登录后进入「我的 → AI 智能查询」，点击开启即可生成专属 API Key。每个账号可以生成多个 Key 用于不同场景。

                

                

                    
Q: API Key 的格式是什么？

                    
格式为 xmqj_u{用户ID}_{48位十六进制随机字符串}，每个 Key 绑定唯一用户，不可跨账号使用。

                

                

                    
Q: 查询如何计费？

                    
每次成功查询消耗 1 次额度，按用户账号的免费/付费额度和价格计算。每个 API Key 独立统计月度用量，默认每月上限 500 次。

                

                

                    
Q: 如何查看剩余额度？

                    
调用 POST /api/claw/v1/quota 接口获取最新额度信息，也可以在 APP 内查看。

                

                

                    
Q: 如何管理多个 Key？

                    
在 APP「我的 → AI 智能查询」页面可以查看所有 Key 列表、为 Key 命名、撤销单个 Key 或重置生成新 Key。

                

                

                    
Q: Key 丢了怎么办？

                    
在 APP 中撤销丢失的 Key，然后创建新 Key。系统不存明文 Key，丢失后无法找回。

                

                

                    
Q: 数据来源可靠吗？

                    
数据来源于多个官方权威数据源，确保数据真实可靠。查询结果与 APP 内一致。

                

                

                    
Q: OpenAI / Claude 等大模型可以直接调用吗？

                    
可以！利用 Function Calling 功能，将 API 端点注册为 Function/Tool，大模型即可在对话中自动判断何时需要查询外部数据。