Us Import Duty

面向美国进口关税场景：按 HTS 编码或商品描述查询归类与税率，结合原产国、海关货值与运输方式计算落地关税并列出 Section 301/232 等附加费，同时可查询近期关税变更。免费端点返回预览结果，完整结果经 x402 按次付费；数据随 USITC HTS 版本刷新，声明不构成法律或报关建议。

foomworks

热度 15.99

最近更新 2026-06-19 07:59:09

分类：搜索依赖：代码执行 / 第三方 API / 内部调用大模型应用场景：研究 / 报告撰写

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add us-import-duty

Metadata

name: us-import-duty
description: Look up US HTS classifications and compute landed import duty (incl. Section 301/232 surcharges)
metadata: {"openclaw":{"requires":{"bins":["curl"]}}}
homepage: https://duty-stack.foomworks.workers.dev
license: MIT

US Import Duty & HTS Lookup

Use this skill when a task needs US import tariff information: classifying goods under the Harmonized Tariff Schedule (HTS), looking up a duty rate, or computing the landed duty for a shipment (including ad-valorem rates plus active surcharges such as Section 301 / Section 232). Data is refreshed from the official USITC HTS release on a 30-minute cron, so rates track the current revision.

Base URL: https://duty-stack.foomworks.workers.dev

When to use

"What's the duty on imported to the US?"
"Classify this item under the HTS" / "find the HTS code for "
"Compute the total duty for $X of from by <ocean|air>"
"Have the tariff rules for changed recently?"

Free endpoints (no payment)

Use these first to orient — they return a truncated/preview answer at no cost:

GET /hts/lookup/preview?code=<HTS10> — preview of a code's description + base rate
GET /duty/preview?code=<HTS10>&origin=<ISO2>&value=<USD>&transport=<ocean|air|truck> — preview duty calc
GET /hts/search/preview?q=<keywords> — preview classification search
GET /changes/preview and GET /changes/by-code?code=<HTS> — recent tariff changes (free front door)
GET /health — service status (ok, current revision, chapters loaded)

Paid endpoints (x402 — USDC on Base, auto-settled)

These return the full answer. They respond HTTP 402 Payment Required with an x402 challenge; your x402 auto-handler signs a USDC micropayment on Base and retries automatically (within your configured budget). Prices are small, per-call:

Endpoint	Price	Returns
`GET /hts/lookup?code=<HTS10>`	$0.003	full classification + duty rate detail
`GET /duty?code=<HTS10>&origin=<ISO2>&value=<USD>&transport=<ocean\|air\|truck>`	$0.005	full landed-duty calc incl. surcharges
`GET /hts/search?q=<keywords>`	$0.002	ranked classification candidates
`GET /changes?since=<ISO8601>`	$0.002	full tariff-change diff

If you do not have an x402 wallet/handler configured, fall back to the free */preview and /changes/by-code endpoints above — they answer most orientation questions.

Workflow

Normalize inputs: HTS codes are 10 digits (dotted 0101.21.00.10 or undotted 0101210010 both accepted); origin is an ISO-3166 alpha-2 country code; value is the customs value in USD; transport is one of ocean|air|truck.
If you only have a product description, call GET /hts/search/preview?q= (free) or GET /hts/search?q= (paid, ranked) to find candidate codes, then confirm with the user.
For a rate only, call GET /hts/lookup?code=. For a full landed cost, call GET /duty?....
Report the rate(s) and any surcharge lines the response includes (Section 301/232 etc.), plus the HTS revision the answer is based on (see /health).

Notes

This is reference tooling, not legal/customs advice — flag that final classification and entry filing are the importer's/broker's responsibility.
The service holds no keys and never initiates payments; all payment is buyer-side via x402.

Example

BASE=https://duty-stack.foomworks.workers.dev
# Free preview first
curl -s "$BASE/duty/preview?code=2825.20.00.00&origin=CN&value=10000&transport=ocean"
# Full calc (x402 handler settles the 402 automatically)
curl -s "$BASE/duty?code=2825.20.00.00&origin=CN&value=10000&transport=ocean"