---
name: guanjin-trade
description: 用关津工具处理中国外贸业务。适用于混装或单品装柜、打托、FOB/CFR/CIF 报价、体积和计费重、ISO 6346 箱号校验、发票金额大写，以及查询 HS 编码、退税率、人民币汇率和报关参数代码。装箱单、报价和箱号等业务数据在本机计算，公开数据可通过关津远程 MCP 查询。
---

# 关津外贸工具

用计算工具返回的结果作答。先核对影响结果的单位和条件，缺少关键数据时向用户索取。计算或查询出错时报告原错误，或按明确提示修正输入再试。

## 本地计算

优先调用同名 stdio 工具。在 WorkBuddy、Claude Code、Codex 或 OpenClaw 中，按客户端支持的方式安装本目录的技能。配置本地 MCP 时用 Node.js 22+ 启动 `node /实际路径/guanjin-local.mjs --mcp-stdio`。也可从技能目录运行 `node scripts/guanjin-local.mjs <命令>`。该脚本自带依赖，运行 `<命令> --help` 可查看 JSON 字段。把文件路径写成 `@文件路径` 或用 `-` 从标准输入读取，可避免把订单内容放进命令行参数。

| 用户要做什么 | 本地 MCP 工具 | 命令 |
| --- | --- | --- |
| 规划单品或多 SKU 装柜，比较柜型 | `plan_container_loading` | `load <JSON>` |
| 计算每层箱数、每托箱数及托数 | `plan_pallet_stacking` | `pallet <JSON>` |
| 核算外币报价或按目标价逆算利润 | `calculate_fob_cif_quote` | `quote <JSON>` |
| 计算体积、计费重、海运运费吨 | `calculate_cbm_chargeable_weight` | `cbm <JSON>` |
| 批量校验集装箱号 | `check_container_numbers` | `cntr <CSV\|JSON>` |
| 转换发票英文和人民币大写 | `convert_amount_in_words` | `say <金额> [币种]` |

### 装柜和打托

- 收集外箱长宽高（cm）、单箱毛重（kg）、箱数和摆放约束，用真实排布计算装柜。不得用柜容除外箱体积冒充装得下的箱数。汇报柜型、每柜箱数、容积利用率、余货和警告，临近箱门尺寸或载重时核对实际柜的规格。
- `load` 默认允许堆叠和水平转向，侧放需明确允许。`maxLayers` 含本箱。提供 `group` 时按批次首次出现的顺序卸货，未分组的货最后卸。用 `reserve_cm` 指定箱门侧净预留。
- `palletize_all` 使用网站默认的 120×100 cm 托盘、180 cm 限高和 1,000 kg 限重，默认整托不可叠。遇到无法打托或有指定摆放方向的外箱时，按警告注明哪些仍按散箱装。需指定托盘尺寸、托盘皮重、限高或限重时用 `pallet` 单独计算。

```sh
node scripts/guanjin-local.mjs load '{"items":[{"name":"A","l":60,"w":40,"h":40,"kg":10,"qty":40},{"name":"B","l":40,"w":30,"h":20,"kg":8,"qty":10,"stack":false}],"containers":["20GP","40HC"],"reserve_cm":10}'
node scripts/guanjin-local.mjs pallet '{"l":40,"w":30,"h":25,"kg":8,"total":120,"pl":120,"pw":100,"ph":15,"pkg":20,"maxh":180,"maxkg":1000}'
```

### 报价、计费重、箱号和金额

- 报价使用已核实的汇率和退税率。费率按百分数输入，例如 `13` 表示 13%。`freight_basis` 默认 `cost`，运保费按成本转嫁。CIF 保险按 CIF 金额的 110% 投保，让工具核算。交付时写明外币币种、汇率及来源、费率和使用的利润口径。逆算利润同时提供 `target_price_fx` 和 `target_term`。
- 体积和计费重用 `cbm`。按用户给出的运输方式选择 `sea`（海运拼箱）、`air`（空运）、`exp`（快递）或 `custom`，自定义时填 `customDiv`。核对承运人实际计费口径。
- 箱号保留前导零，缺失或错误的校验位以 `cntr` 返回的 `fix` 为准。金额用 `say` 生成对应英文币种的大写，人民币大写表示同一数值，涉及换汇时先按已确认的汇率换算。

```sh
node scripts/guanjin-local.mjs quote '{"taxed_price_cny":113,"quantity":10,"rebate_rate":13,"exchange_rate":7,"currency":"USD","domestic_fees_cny":50,"sea_freight_fx":20}'
node scripts/guanjin-local.mjs cbm '{"rows":[{"l":60,"w":40,"h":40,"kg":10,"q":40}],"mode":"air"}'
node scripts/guanjin-local.mjs cntr '["COSU6400005","TGHU123456"]'
node scripts/guanjin-local.mjs say 36580.40 USD
```

## 查询公开数据

用远程 MCP 端点 `https://guanjin.app/api/mcp` 查询。客户端只有本地命令时，用 `node scripts/guanjin-local.mjs mcp-call <工具名> '<JSON>'`。[关津 MCP 接入说明](https://guanjin.app/mcp/)

- `search_hs_code` 用商品关键词或编码前缀检索候选。依据商品材质、用途、结构等信息筛选，再用 `get_hs_detail` 查询给定的 8 位税则号列或 10 位商品编号。不得凭模型记忆补齐 10 位号或猜退税率。返回候选、证据来源和仍需确认的要素，缺字段时明示。
- `get_exchange_rates` 查询人民币中间价或海关计征汇率。注明数值、类型和适用日期。报价采用用户确认的汇率口径。
- `search_customs_codes` 按参数表和关键词查询代码。在 [报关参数代码表](https://guanjin.app/customs-codes/) 核对表的用途和数据。

只把查询所需的公开关键词、代码或币种发送到远程端点。报价、SKU 明细、箱号和原始文件留在本机。将资料放进对话时，仍按所用 AI 客户端的数据规则处理。

## 企业支持

批量 PDF 识别（含 OCR）、公司模板、ERP 对接、团队流程和私有部署按需用脱敏样本沟通。[企业定制](https://guanjin.app/enterprise/)

海外产品展示、询盘收集、多语言网站与 GEO（生成式搜索优化）参考案例。[外贸建站](https://guanjin.app/website/)
