接口说明

接入说明

• 基础地址按站点域名拼接，所有请求使用 HTTPS。
• 地址完整性示例：https://www.hsciq.com/mcp/tools/list（正确），不要写成 https://www.hsciq.com/MCP/mcp/tools/list。
• 接口统一返回 JSON，成功结构为 { "ok": true, "toolName": "...", "data": ... }。
• 分页类工具统一返回 pageIndex/pageSize/totalPageCount/totalItemCount/isPreviousPage/isNextPage/items。

鉴权方式

X-API-Key: your_api_key

ClawHub 技能安装

• 技能页面：https://clawhub.com/skills/hsciq-mcp

clawhub install hsciq-mcp

GET /mcp

{
  "name": "HSCIQ2 MCP",
  "version": "1.0",
  "toolsEndpoint": "/mcp/tools/list",
  "callEndpoint": "/mcp/tools/call"
}

POST /mcp/tools/list

curl -X POST "https://www.hsciq.com/mcp/tools/list" ^
  -H "Content-Type: application/json" ^
  -H "X-API-Key: your_api_key"

{
  "version": "1.0",
  "tools": [
    { "name": "search_instance" },
    { "name": "search_code" },
    { "name": "search_unified" },
    { "name": "get_code_detail" },
    { "name": "create_guilei_form" },
    { "name": "get_guilei_form" },
    { "name": "list_my_guilei_forms" },
    { "name": "add_guilei_dialog_message" }
  ]
}

POST /mcp/tools/call（search_instance / search_code / search_unified）

curl -X POST "https://www.hsciq.com/mcp/tools/call" ^
  -H "Content-Type: application/json" ^
  -H "X-API-Key: your_api_key" ^
  -d "{
    ""toolName"": ""search_code"",
    ""arguments"": {
      ""keywords"": ""塑料软管"",
      ""country"": ""CN"",
      ""pageIndex"": 1,
      ""pageSize"": 10,
      ""filterFailureCode"": true
    }
  }"

• 分页外层字段：pageIndex、pageSize、totalPageCount、totalItemCount、isPreviousPage、isNextPage、items。
• items 类型：search_instance → InstanceSearchResult[]，search_code → CNCode[]/JPCode[]/USCode[]，search_unified → CIQ[]/HazardousChemicals[]/PortSearchResult[]。

POST /mcp/tools/call（get_code_detail）

{
  "toolName": "get_code_detail",
  "arguments": {
    "country": "CN",
    "code": "3926909090"
  }
}

search_instance 参数与返回值说明

search_code 返回参数字段说明

search_unified 返回参数字段说明

get_code_detail 返回参数字段说明

create_guilei_form 参数与返回值说明

curl -X POST "https://www.hsciq.com/mcp/tools/call" ^
  -H "Content-Type: application/json" ^
  -H "X-API-Key: your_api_key" ^
  -d "{
    ""toolName"": ""create_guilei_form"",
    ""arguments"": {
      ""productNameCn"": ""智能手机壳"",
      ""productNameEn"": ""Smartphone Case"",
      ""uses"": ""手机保护套"",
      ""ingredients"": ""硅胶"",
      ""brand"": ""某品牌"",
      ""model"": ""X1"",
      ""images"": [
        {
          ""fileName"": ""front.jpg"",
          ""data"": ""base64编码的图片数据""
        }
      ]
    }
  }"

{
  "ok": true,
  "toolName": "create_guilei_form",
  "data": {
    "formId": "a1b2c3d4-...",
    "status": "已创建",
    "imageCount": 1,
    "imageUrls": [ "https://www.hsciq.com/uploads/guilei/..." ]
  }
}

get_guilei_form 参数与返回值说明

curl -X POST "https://www.hsciq.com/mcp/tools/call" ^
  -H "Content-Type: application/json" ^
  -H "X-API-Key: your_api_key" ^
  -d "{
    ""toolName"": ""get_guilei_form"",
    ""arguments"": {
      ""formId"": ""a1b2c3d4-...""
    }
  }"

list_my_guilei_forms 参数与返回值说明

curl -X POST "https://www.hsciq.com/mcp/tools/call" ^
  -H "Content-Type: application/json" ^
  -H "X-API-Key: your_api_key" ^
  -d "{
    ""toolName"": ""list_my_guilei_forms"",
    ""arguments"": {
      ""pageIndex"": 1,
      ""pageSize"": 20
    }
  }"

{
  "ok": true,
  "toolName": "list_my_guilei_forms",
  "data": {
    "items": [
      {
        "id": "a1b2c3d4-...",
        "productNameCn": "智能手机壳",
        "status": 1,
        "isFinalized": false,
        "createTime": "2026-05-08T10:30:00"
      }
    ],
    "pageIndex": 1,
    "pageSize": 20,
    "totalItemCount": 3,
    "totalPageCount": 1
  }
}

add_guilei_dialog_message 参数与返回值说明

curl -X POST "https://www.hsciq.com/mcp/tools/call" ^
  -H "Content-Type: application/json" ^
  -H "X-API-Key: your_api_key" ^
  -d "{
    ""toolName"": ""add_guilei_dialog_message"",
    ""arguments"": {
      ""formId"": ""a1b2c3d4-..."",
      ""fieldKey"": ""Ingredients"",
      ""content"": ""主要成分是聚乙烯，不含阻燃剂""
    }
  }"

{
  "toolName": "add_guilei_dialog_message",
  "arguments": {
    "formId": "a1b2c3d4-...",
    "fieldKey": "Ingredients",
    "content": "已确认，确实不含阻燃剂",
    "dialogId": "d5e6f7a8-..."
  }
}

{
  "ok": true,
  "toolName": "add_guilei_dialog_message",
  "data": {
    "dialogId": "d5e6f7a8-...",
    "messageId": "b9c0d1e2-...",
    "action": "reply"
  }
}