{"skill":{"slug":"hsciq-mcp","displayName":"HSCIQ MCP - 海关编码查询","summary":"HS Code Lookup for Chinese Products. Query customs codes, tariff rates, declaration elements, and regulatory requirements via HSCIQ MCP API. Create classific...","description":"---\nname: hsciq-mcp\ndescription: HS Code Lookup for Chinese Products. Query customs codes, tariff rates, declaration elements, and regulatory requirements via HSCIQ MCP API. Create classification consultation requests with image upload for expert review.\nlicense: MIT\ntags:\n  - HS Code Lookup for Chinese Products\n  - Tariff Classification\n  - Customs\n  - Trade\n  - China\n  - MCP\nenv:\n  HSCIQ_API_KEY:\n    description: \"HSCIQ API key for accessing the customs code lookup service\"\n    required: true\n  HSCIQ_BASE_URL:\n    description: \"HSCIQ API base URL (default: https://www.hsciq.com)\"\n    required: false\n    default: \"https://www.hsciq.com\"\ncredentials:\n  - name: HSCIQ API Key\n    description: \"Free API key from https://www.hsciq.com\"\n    required: true\n    url: https://www.hsciq.com\n---\n\n# ⚠️ 使用前必读：需要 API 密钥\n\n**本技能需要 HSCIQ API 密钥才能正常工作。**\n\n## 获取 API 密钥\n\n1. 访问 [https://www.hsciq.com](https://www.hsciq.com)\n2. 注册账号并登录\n3. 在控制台申请 API 密钥\n4. 将密钥配置到本地（见下方\"配置\"章节）\n\n**没有 API 密钥将无法查询海关编码。**\n\n---\n\n\n\n# HSCIQ MCP - 海关编码查询服务\n\n专业的中国商品海关编码查询与归类服务，基于 HSCIQ MCP API。\n\n## 功能\n\n- **search_code** - 按关键词搜索海关编码（支持中国/日本/美国）\n- **get_code_detail** - 获取海关编码详情（税率、申报要素、监管条件等）\n- **search_instance** - 按商品名称检索归类实例（输入具体商品名如\"自行车\"、\"手机壳\"，非描述性短语）\n- **search_unified** - 统一搜索（CIQ 项目/危化品/港口信息）\n- **create_guilei_form** - 创建 HS 归类咨询单（支持产品信息与图片上传，提交给平台专业归类师人工审核）\n- **get_guilei_form** - 获取归类咨询单详情（含字段对话、归类结论、修改历史）\n- **list_my_guilei_forms** - 获取当前用户的归类咨询单分页列表\n- **add_guilei_dialog_message** - 在归类单字段上创建新讨论或回复已有讨论\n\n## 触发条件\n\n用户提到以下关键词时自动触发：\n- \"海关编码\"、\"HS 编码\"、\"税号\"、\"商品编码\"\n- \"查询税率\"、\"申报要素\"、\"监管条件\"\n- \"CIQ\"、\"危化品\"、\"港口代码\"\n- \"归类实例\"、\"商品归类\"\n- \"归类咨询\"、\"人工复核\"、\"提交审核\"、\"专家确认\"、\"帮我提交归类\"\n- \"我的咨询单\"、\"咨询详情\"、\"咨询回复\"、\"归类结果\"\n\n## 配置\n\n配置文件位于 `~/.openclaw/workspace/hsciq-mcp-config.json`：\n```json\n{\n  \"baseUrl\": \"https://www.hsciq.com\",\n  \"apiKey\": \"your_api_key\",\n  \"authHeader\": \"X-API-Key\"\n}\n```\n\n**注意**：API Key 也可以通过环境变量设置：\n```bash\nexport HSCIQ_API_KEY=your_api_key\nexport HSCIQ_BASE_URL=https://www.hsciq.com\n```\n\n## 命令\n\n```bash\n# 搜索海关编码\nnode ~/.openclaw/skills/hsciq-mcp/hsciq-client.js search-code --keywords \"塑料软管\" --country CN\n\n# 获取编码详情\nnode ~/.openclaw/skills/hsciq-mcp/hsciq-client.js get-detail --code \"3926909090\" --country CN\n\n# 搜索归类实例\nnode ~/.openclaw/skills/hsciq-mcp/hsciq-client.js search-instance --keywords \"自行车\" --country CN\n\n# 统一搜索（CIQ/危化品/港口）\nnode ~/.openclaw/skills/hsciq-mcp/hsciq-client.js search-unified --keywords \"食品\" --type ciq\n\n# 创建归类咨询单（AI 自动提交人工复核）\nnode ~/.openclaw/skills/hsciq-mcp/hsciq-client.js create-guilei-form \\\n  --productNameCn \"智能手机壳\" \\\n  --uses \"手机保护\" \\\n  --ingredients \"硅胶\" \\\n  --images ./front.jpg ./back.jpg\n\n# 获取归类咨询单详情\nnode ~/.openclaw/skills/hsciq-mcp/hsciq-client.js get-guilei-form --formId \"abc123...\"\n\n# 查看我的归类咨询单列表\nnode ~/.openclaw/skills/hsciq-mcp/hsciq-client.js list-my-guilei-forms --pageIndex 1 --pageSize 20\n\n# 在归类单上发起讨论或回复\nnode ~/.openclaw/skills/hsciq-mcp/hsciq-client.js add-guilei-dialog-message \\\n  --formId \"abc123...\" \\\n  --fieldKey \"ProductNameCn\" \\\n  --content \"请问这个产品的材质是什么？\"\n```\n\n## 使用示例\n\n### 示例 1: 查询商品的海关编码\n```\n用户：帮我查一下\"塑料软管\"的海关编码\n→ 调用 search_code，返回编码列表和税率信息\n```\n\n### 示例 2: 获取编码详情\n```\n用户：3926909090 这个编码的税率是多少\n→ 调用 get_code_detail，返回完整税率、申报要素、监管条件\n```\n\n### 示例 3: 搜索归类实例\n```\n用户：看看别人是怎么归类\"蓝牙耳机\"的\n→ 调用 search_instance，输入商品名称关键词\"蓝牙耳机\"（非短语），返回历史归类案例\n```\n\n### 示例 4: AI 拿不准时提交人工复核\n```\n用户：帮我查一下这个产品的 HS 编码，我不太确定 AI 给的结果对不对\n→ AI 在用 search_code 查询后，如果用户对结果有疑问\n→ 调用 create_guilei_form，自动提交产品信息与图片，生成归类咨询单\n→ 平台专业归类师审核后给出权威结论\n```\n\n### 示例 5: 查看归类咨询单结果\n```\n用户：我之前提交的归类咨询有结果了吗？\n→ 调用 list_my_guilei_forms 获取用户的归类咨询单列表\n→ 找到目标单后调用 get_guilei_form 获取详情（含归类结论、字段对话）\n```\n\n### 示例 6: 在归类单上追问\n```\n用户：之前在归类单上问过的问题，我想补充信息\n→ 调用 add_guilei_dialog_message\n→ 传入 formId + fieldKey + content，在指定字段上发起新讨论或回复已有讨论\n```\n\n## API 端点说明\n\n所有工具调用统一使用以下端点：\n\n| 端点 | 说明 |\n|------|------|\n| `POST https://www.hsciq.com/mcp/tools/list` | 列出可用工具 |\n| `POST https://www.hsciq.com/mcp/tools/call` | 调用任意工具（通过 `toolName` 参数区分） |\n\n**调用格式示例**：\n```json\n{\n  \"toolName\": \"search_code\",\n  \"arguments\": {\n    \"keywords\": \"塑料软管\",\n    \"country\": \"CN\",\n    \"pageIndex\": 1,\n    \"pageSize\": 10\n  }\n}\n```\n\n### create_guilei_form 调用示例\n```json\n{\n  \"toolName\": \"create_guilei_form\",\n  \"arguments\": {\n    \"productNameCn\": \"智能手机壳\",\n    \"productNameEn\": \"Smartphone Case\",\n    \"uses\": \"手机保护\",\n    \"ingredients\": \"硅胶\",\n    \"brand\": \"某品牌\",\n    \"model\": \"X1\",\n    \"images\": [\n      { \"fileName\": \"front.jpg\", \"data\": \"base64编码的图片数据...\" }\n    ]\n  }\n}\n```\n\n**图片限制**：最多 3 张，每张 ≤ 1MB，支持 JPG/PNG/GIF/WebP。每人每天最多创建 5 次（可配置）。\n\n### get_guilei_form 调用示例\n```json\n{\n  \"toolName\": \"get_guilei_form\",\n  \"arguments\": {\n    \"formId\": \"00000000-0000-0000-0000-000000000001\"\n  }\n}\n```\n\n返回完整的归类咨询单详情，包含产品字段、字段对话、归类结论（如有）等信息。\n\n### list_my_guilei_forms 调用示例\n```json\n{\n  \"toolName\": \"list_my_guilei_forms\",\n  \"arguments\": {\n    \"pageIndex\": 1,\n    \"pageSize\": 20\n  }\n}\n```\n\n返回当前用户的归类咨询单分页列表，包含表单状态、创建时间等摘要信息。\n\n### add_guilei_dialog_message 调用示例\n```json\n{\n  \"toolName\": \"add_guilei_dialog_message\",\n  \"arguments\": {\n    \"formId\": \"00000000-0000-0000-0000-000000000001\",\n    \"fieldKey\": \"ProductNameCn\",\n    \"content\": \"这个产品的准确材质是什么？\",\n    \"dialogId\": null,\n    \"messageType\": null\n  }\n}\n```\n\n- `formId` / `fieldKey` / `content` 为必填\n- `dialogId`：不为空时回复已有对话；为空时新建对话\n- `messageType`：可选的消息类型\n\n## API 文档\n\n完整 API 说明：https://www.hsciq.com/MCP/Docs\n\n## Python 客户端\n\n也可以使用 Python 脚本直接调用：\n\n```bash\n# 搜索海关编码\npython3 ~/.openclaw/skills/hsciq-mcp/hsciq_client.py search-code --keywords \"塑料软管\" --country CN\n\n# 获取编码详情\npython3 ~/.openclaw/skills/hsciq-mcp/hsciq_client.py get-detail --code \"3926909090\"\n\n# 搜索归类实例\npython3 ~/.openclaw/skills/hsciq-mcp/hsciq_client.py search-instance --keywords \"自行车\"\n\n# 统一搜索\npython3 ~/.openclaw/skills/hsciq-mcp/hsciq_client.py search-unified --keywords \"食品\" --type ciq\n\n# 创建归类咨询单\npython3 ~/.openclaw/skills/hsciq-mcp/hsciq_client.py create-guilei-form \\\n  --productNameCn \"智能手机壳\" --uses \"手机保护\" --ingredients \"硅胶\" \\\n  --images ./front.jpg ./back.jpg\n\n# 获取归类咨询单详情\npython3 ~/.openclaw/skills/hsciq-mcp/hsciq_client.py get-guilei-form --formId \"abc123...\"\n\n# 查看归类咨询单列表\npython3 ~/.openclaw/skills/hsciq-mcp/hsciq_client.py list-my-guilei-forms --pageIndex 1\n\n# 归类单讨论\npython3 ~/.openclaw/skills/hsciq-mcp/hsciq_client.py add-guilei-dialog-message \\\n  --formId \"abc123...\" --fieldKey \"ProductNameCn\" --content \"追问内容\"\n\n# 列出可用工具\npython3 ~/.openclaw/skills/hsciq-mcp/hsciq_client.py list-tools\n\n# JSON 输出（便于程序处理）\npython3 ~/.openclaw/skills/hsciq-mcp/hsciq_client.py search-code --keywords \"软管\" --json\n```\n\n### Python 代码集成\n\n```python\nfrom hsciq_client import HSCIQClient\n\nclient = HSCIQClient()\n\n# 搜索编码\nresult = client.search_code(\"塑料软管\", country=\"CN\")\nprint(result)\n\n# 获取详情\ndetail = client.get_code_detail(\"3926909090\")\nprint(detail)\n\n# 创建归类咨询（图片为文件路径，客户端自动 base64 编码）\nresult = client.create_guilei_form(\n    productNameCn=\"智能手机壳\",\n    uses=\"手机保护\",\n    ingredients=\"硅胶\",\n    images=[\"./front.jpg\", \"./back.jpg\"]\n)\nprint(result)\n\n# 获取归类咨询单详情\nform = client.get_guilei_form(\"00000000-0000-0000-0000-000000000001\")\nprint(form)\n\n# 查看归类咨询单列表\nforms = client.list_my_guilei_forms(pageIndex=1, pageSize=20)\nprint(forms)\n\n# 在归类单上追问\nreply = client.add_guilei_dialog_message(\n    formId=\"00000000-0000-0000-0000-000000000001\",\n    fieldKey=\"ProductNameCn\",\n    content=\"请确认这个产品的材质\"\n)\nprint(reply)\n```\n","tags":{"latest":"2.0.7","China":"1.3.0","Customs":"1.3.0","HS Code Lookup for Chinese Products":"1.3.0","MCP":"1.3.0","Tariff Classification":"1.3.0","Trade":"1.3.0","classification":"1.0.0","customs":"1.0.0","hs-code":"1.0.0","mcp":"1.0.0","trade":"1.0.0"},"stats":{"comments":0,"downloads":915,"installsAllTime":35,"installsCurrent":0,"stars":0,"versions":13},"createdAt":1773651182943,"updatedAt":1778600434571},"latestVersion":{"version":"2.0.7","createdAt":1778600331532,"changelog":"新增 get_guilei_form / list_my_guilei_forms / add_guilei_dialog_message 三个归类咨询单管理工具，SKILL.md 和客户端同步更新","license":"MIT-0"},"metadata":null,"owner":{"handle":"toucao","userId":"s176t6kkw20eybaqj6fs7h4p1983h4p9","displayName":"TouCao","image":"https://avatars.githubusercontent.com/u/39644881?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780090788757}}