技能：Tariff Watch

ClawHub 技能 · v3.2.0 · Python 3.11+ · 需要 FastAPI 后端

概述

Tariff Watch 回答一个关键问题：“该产品实际落地美国的成本是多少？”

它将以下要素整合为单一的单位到岸成本（landed cost per unit）计算结果：关税（USITC 基础税率 + Section 232/301 + 反倾销/反补贴税 AD/CVD）、汇率（覆盖 18 种货币，含 30 日趋势）、海运运费（全球主要港口至美国东西海岸的 25+ 条航线）、合规要求（CPSC/FDA/FCC/UFLPA）以及清关费用（报关代理费、ISF 申报费、担保金、MPF、HMF）。

本技能面向向美国出口的全球贸易商——不仅限于中国供应商。

功能特性（v3.2）

Claude 如何使用此技能

当被调用时，Claude 应执行以下步骤：

1. 从用户提供的产品描述中识别 HTS 编码：

   • 利用 Claude 内置的 HTS 知识库，推荐最精确的 10 位编码。
   • 若不确定，可先使用 4 位或 6 位前缀启动查询。

2. 调用有效关税接口：

   GET http://localhost:8000/tariff/{hts_code}/effective?origin={ISO2}
   

   默认原产国：CN（中国）。支持自然语言输入原产国（如“越南” → VN）。

3. 清晰呈现结果：

   • 逐层列出各项税费（MFN 基础税率、Section 232、Section 301），注明对应税率及法律依据。
   • 明确标出 effective_total_pct 作为确认后的最终合计税率。
   • 若返回中含 adcvd 字段，需高亮 AD/CVD 风险及最坏情形下的合计税率。
   • 若返回中含 compliance_flags 字段，需列出相关监管机构。
   • 只要 advisory 字段非空，必须展示其内容——用户需知悉 Section 122 的存在。
   • 始终提醒用户：最终应由持牌清关代理进行核实。

4. 获取完整到岸成本（最强大的接口），调用：

   GET http://localhost:8000/landed-cost?hts_code={code}&origin={ISO2}&cog_local=32&units=500&cbm=5&destination=USWC
   

   该接口一次性整合关税、汇率、运输与清关费用，返回综合结果。

5. 评估汇率影响，调用：

   GET http://localhost:8000/fx/{currency}/impact?cog_local=32&units=500
   

6. 查询运输费率，调用：

   GET http://localhost:8000/shipping/{origin}?destination=USWC
   

7. 查询 AD/CVD、合规性或利润分析，请调用下方对应接口。

API 接口参考

数据来源与自动刷新机制

ECB 汇率覆盖缺口

免费 ECB 数据流不包含以下 4 种货币：VND、BDT、PKR、TWD。这些货币采用校准模拟值，并在响应中以 source: "simulated" 标识。设置环境变量 EXCHANGERATE_API_KEY 可获取全部 18 种货币的真实汇率。

可选高级 API 密钥

如需更精准的数据，用户可注册付费 API。本技能将自动检测并启用相应服务：

即使未配置任何 API 密钥，本技能仍可完全运行，依赖免费 ECB 数据 + 校准模拟值，无需注册。

数据刷新时间表

• 汇率：每日更新（ECB 发布后）
• 运输费率：每日更新（模拟或 Freightos）
• USITC 关税：每周更新（周一）
• 首次启动：自动补全过去 30 天的历史数据

关税逻辑（截至 2026-02-26 有效）

已确认生效的关税

AD/CVD 征收令（企业特有——仅显示“其他所有”税率）

已被撤销 — 不予适用

咨询提示 — 显示但不计入计算总额

限制条件与免责声明

• 数据来源： USITC 发布官方 HTS 税则；本技能直接读取其数据。税率数据时效性与最新 USITC 修订版一致。
• Section 122 已确认生效，但因其临时性与政治敏感性，**刻意排除在 effective_total_pct 计算之外**——用户务必查阅 advisory 字段确认。
• AD/CVD 税率 具有企业特异性。“其他所有”税率适用于未获美国商务部行政复审单独裁定税率的出口商。您的实际税率可能更低。
• 合规数据 覆盖主要监管机构，但非穷尽式。部分产品还需满足州级或行业特定要求。
• 本工具仅供信息参考。 在做出进口决策前，请务必通过 CBP 具约束力的裁定、持牌清关代理或合格贸易法律顾问核实关税义务。