接口说明

标准 MCP 端点（推荐）

• 端点地址：POST https://www.hsciq.com/mcp/rpc，遵循标准 Model Context Protocol（Streamable HTTP，Stateless，JSON-RPC 2.0）。
• 鉴权方式与 REST 端点相同：X-API-Key 请求头，或 Authorization: Bearer <key>。
• 共提供 15 个工具：其中 9 个（search_instance / search_code / search_unified / get_code_detail / create_guilei_form / get_guilei_form / list_my_guilei_forms / add_guilei_dialog_message / list_guilei_categories）与 REST 端点完全相同，参数与返回结构一致；另有 3 个海关公告工具（search_gonggao / get_gonggao_detail / get_gonggao_by_code）与 3 个船公司公告工具（list_ocean_carriers / search_ocean_carrier_notice / get_ocean_carrier_notice_detail）仅标准 MCP 端点提供。
• 错误语义差异：REST 端点超限/失败返回 HTTP 429/400；标准 MCP 端点按协议返回 HTTP 200，结果中 isError=true，错误文本以错误码开头（如 daily_quota_exceeded: 每日调用次数已达上限（150次））。
• 下方 REST 端点继续可用；新接入建议使用标准 MCP 端点。

{
  "mcpServers": {
    "hsciq": {
      "type": "http",
      "url": "https://www.hsciq.com/mcp/rpc",
      "headers": { "X-API-Key": "your_api_key" }
    }
  }
}

curl -X POST "https://www.hsciq.com/mcp/rpc" ^
  -H "Content-Type: application/json" ^
  -H "Accept: application/json, text/event-stream" ^
  -H "X-API-Key: your_api_key" ^
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\",\"params\":{}}"

curl -X POST "https://www.hsciq.com/mcp/rpc" ^
  -H "Content-Type: application/json" ^
  -H "Accept: application/json, text/event-stream" ^
  -H "X-API-Key: your_api_key" ^
  -d "{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"search_code\",\"arguments\":{\"keywords\":\"自行车\",\"country\":\"CN\"}}}"

接入说明

• 本站提供两种接入方式：标准 MCP 端点 POST /mcp/rpc（推荐），以及旧版 REST 端点（已废弃，仅兼容存量调用，见页面底部）。
• 基础地址按站点域名拼接，所有请求使用 HTTPS。
• 地址完整性示例：https://www.hsciq.com/mcp/rpc（正确），不要写成 https://www.hsciq.com/MCP/mcp/rpc。
• 标准 MCP 端点共提供 15 个工具，其中 9 个与 REST 端点完全相同（见下方"工具说明"），3 个海关公告工具与 3 个船公司公告工具仅标准 MCP 端点提供。
• 分页类工具统一返回 pageIndex/pageSize/totalPageCount/totalItemCount/isPreviousPage/isNextPage/items。

鉴权方式

X-API-Key: your_api_key

ClawHub 技能安装

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

openclaw skills install @toucao/hsciq-mcp

本地 CLI（stdio）安装

• 适用场景：AI 客户端仅支持 stdio 本地进程接入时，使用本 CLI 作为本地桥接（内部仍走上方 /mcp/rpc 端点，认证与配额完全一致）。客户端支持 HTTP 直连时建议直接使用标准端点。
• 下载地址、配置示例与安装说明已迁移至独立页面：CLI 下载。

search_instance 参数与返回值说明

search_code 返回参数字段说明

search_unified 返回参数字段说明

get_code_detail 参数与返回字段说明

create_guilei_form 参数与返回值说明

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

{
  "formId": "a1b2c3d4-...",
  "url": "https://www.hsciq.com/GuiLei/a1b2c3d4-...",
  "status": "已创建",
  "imageCount": 1,
  "imageUrls": [ "https://www.hsciq.com/uploads/guilei/..." ]
}

get_guilei_form 参数与返回值说明

curl -X POST "https://www.hsciq.com/mcp/rpc" ^
  -H "Content-Type: application/json" ^
  -H "Accept: application/json, text/event-stream" ^
  -H "X-API-Key: your_api_key" ^
  -d "{
    ""jsonrpc"": ""2.0"",
    ""id"": 1,
    ""method"": ""tools/call"",
    ""params"": {
      ""name"": ""get_guilei_form"",
      ""arguments"": {
        ""formId"": ""a1b2c3d4-...""
      }
    }
  }"

list_my_guilei_forms 参数与返回值说明

curl -X POST "https://www.hsciq.com/mcp/rpc" ^
  -H "Content-Type: application/json" ^
  -H "Accept: application/json, text/event-stream" ^
  -H "X-API-Key: your_api_key" ^
  -d "{
    ""jsonrpc"": ""2.0"",
    ""id"": 1,
    ""method"": ""tools/call"",
    ""params"": {
      ""name"": ""list_my_guilei_forms"",
      ""arguments"": {
        ""pageIndex"": 1,
        ""pageSize"": 10
      }
    }
  }"

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

add_guilei_dialog_message 参数与返回值说明

curl -X POST "https://www.hsciq.com/mcp/rpc" ^
  -H "Content-Type: application/json" ^
  -H "Accept: application/json, text/event-stream" ^
  -H "X-API-Key: your_api_key" ^
  -d "{
    ""jsonrpc"": ""2.0"",
    ""id"": 1,
    ""method"": ""tools/call"",
    ""params"": {
      ""name"": ""add_guilei_dialog_message"",
      ""arguments"": {
        ""formId"": ""a1b2c3d4-..."",
        ""fieldKey"": ""Ingredients"",
        ""content"": ""主要成分是聚乙烯，不含阻燃剂""
      }
    }
  }"

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

{
  "dialogId": "d5e6f7a8-...",
  "messageId": "b9c0d1e2-...",
  "action": "reply"
}

list_guilei_categories 参数与返回值说明

curl -X POST "https://www.hsciq.com/mcp/rpc" ^
  -H "Content-Type: application/json" ^
  -H "Accept: application/json, text/event-stream" ^
  -H "X-API-Key: your_api_key" ^
  -d "{
    ""jsonrpc"": ""2.0"",
    ""id"": 1,
    ""method"": ""tools/call"",
    ""params"": {
      ""name"": ""list_guilei_categories"",
      ""arguments"": {}
    }
  }"

[
  { "id": 1, "name": "活动物；动物产品" },
  { "id": 2, "name": "植物产品" },
  { "id": 3, "name": "动、植物油脂" }
]

search_gonggao 参数与返回值说明 仅标准 MCP 端点

get_gonggao_detail 参数与返回值说明 仅标准 MCP 端点

get_gonggao_by_code 参数与返回值说明 仅标准 MCP 端点

list_ocean_carriers 参数与返回值说明 仅标准 MCP 端点

search_ocean_carrier_notice 参数与返回值说明 仅标准 MCP 端点

get_ocean_carrier_notice_detail 参数与返回值说明 仅标准 MCP 端点

GET /mcp 已废弃

{
  "name": "HSCIQ2 MCP",
  "version": "1.0",
  "standardMCPEndpoint": "/mcp/rpc",
  "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" },
    { "name": "list_guilei_categories" }
  ]
}

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 → MCPInstanceItem[]，search_code → MCPCodeSearchItem[]，search_unified → MCPCiqItem[]/MCPHazardousItem[]/MCPPortItem[]。

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