Skip to main content
skill CX Codex

tariff-calculator-amazon — Claude Code skill: duties and landed cost

Works out import duties, VAT and the full landed cost of a shipment for Amazon trade routes. Useful when you need the shelf price before buying stock.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add nexscope-ai/Amazon-Skills --skill tariff-calculator-amazon -a claude-code
Open on GitHub

What tariff-calculator-amazon does

The skill totals what a shipment really costs: FOB value, freight, insurance, duty, VAT or GST, customs clearance, port and inland fees, plus a per-unit figure. Routes cover China to the US and EU, the US to the EU and back, and China to the UK, Canada and Australia. Section 301 rates for Chinese imports into the US are built in, along with USMCA, EVFTA, RCEP and UK-Japan preferences.

Two Python scripts do the work. scripts/calculator.py takes a JSON payload with HS code, origin, destination, shipment value, quantity and freight; on an unusual route you supply your own duty and VAT rates. scripts/hs_lookup.py suggests an HS code from a product description. No API key is involved.

Rates sit in the skill files, so a wrong classification gives you a wrong total: the HS code drives the duty. For a route outside the table, leaving out custom_duty_rate and custom_vat_rate leaves the sum unfinished.

What it helps with

  • total a shipment's cost with duty and VAT included
  • find an HS code from a product name
  • add Section 301 duties on imports from China to the US
  • compare landed cost across two shipping routes
  • check the GST rate for a delivery to Canada or Australia

Example prompts for the agent

  • Work out the landed cost for a batch of Bluetooth speakers from China to the US: FOB 5000, 500 units, freight 200.
  • Find the HS code for wireless earbuds and show the duty rate.
  • Run a Vietnam to Germany route with duty 0.047 and VAT 0.19.

How to install tariff-calculator-amazon

1Skills CLI (Vercel)

npx skills add nexscope-ai/Amazon-Skills --skill tariff-calculator-amazon -a claude-code

2Manually: put the files in place

~/.claude/skills/tariff-calculator-amazon/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/tariff-calculator-amazon/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about tariff-calculator-amazon

How do I install tariff-calculator-amazon in Claude Code?

Run npx skills add nexscope-ai/Amazon-Skills --skill tariff-calculator-amazon -a claude-code. The skill lands at ~/.claude/skills/tariff-calculator-amazon/SKILL.md.

What does tariff-calculator-amazon do?

It computes duties, VAT/GST and landed cost for a shipment on a given route, and matches a product description to an HS code.

Does it need an API key?

No. Duty and tax rates live in the skill files, and both scripts/calculator.py and scripts/hs_lookup.py run locally in Python.

Source text

SKILL.md · MIT
---
name: tariff-calculator-amazon
version: 1.0.0
author: Nexscope AI
description: "Universal tariff calculator for Amazon sellers. Calculate import duties, landed costs, and VAT/GST for any trade route. Supports CN→US, CN→EU, US→EU, EU→US, US→CN and custom origin/destination pairs. Includes Section 301 tariffs, trade agreement rates (USMCA, EVFTA), and HS code lookup. No API key required."
metadata: {"nexscope":{"emoji":"💰","category":"ecommerce"}}
---

# Tariff Calculator — Amazon 💰

Universal tariff and landed cost calculator for international Amazon sellers.

## Installation

```bash
npx skills add nexscope-ai/eCommerce-Skills --skill tariff-calculator-amazon -g
```

## Features

- **Universal Trade Routes** — Any origin to any destination
- **Tariff Rate Lookup** — HS code → duty rate
- **Section 301 Tariffs** — US additional duties on China imports
- **VAT/GST Calculation** — EU, UK, CA, AU, CN rates
- **Landed Cost** — Complete cost breakdown
- **HS Code Matcher** — Product description → HS code suggestions
- **Trade Agreements** — USMCA, EVFTA, RCEP preferential rates

## Supported Trade Routes

| Route | Key Tariffs | VAT/GST |
|-------|-------------|---------|
| 🇨🇳 → 🇺🇸 China → USA | Section 301 (7.5-25%) | N/A |
| 🇨🇳 → 🇪🇺 China → EU | Standard duties | 19-22% |
| 🇨🇳 → 🇬🇧 China → UK | Standard duties | 20% |
| 🇺🇸 → 🇪🇺 USA → EU | Standard duties | 19-22% |
| 🇪🇺 → 🇺🇸 EU → USA | Standard duties | N/A |
| 🇺🇸 → 🇨🇳 USA → China | Retaliatory tariffs | 13% VAT |
| 🇨🇳 → 🇨🇦 China → Canada | Standard duties | 5% GST |
| 🇨🇳 → 🇦🇺 China → Australia | Standard duties | 10% GST |
| **Custom** | User-defined | User-defined |

## Section 301 Tariffs (China → USA)

| HS Chapter | Products | Additional Rate |
|------------|----------|-----------------|
| 84xx | Computers, machinery | 25% |
| 85xx | Electronics (some) | 0-25% |
| 94xx | Furniture, lighting | 25% |
| 95xx | Toys | 25% |
| 61/62 | Apparel | 7.5% |
| 64xx | Footwear | 7.5% |
| 42xx | Bags, accessories | 7.5% |

## Landed Cost Formula

```
Landed Cost = 
    FOB Value
  + International Freight
  + Insurance
  + Import Duty
  + VAT/GST (if applicable)
  + Customs Clearance
  + Port Fees
  + Inland Freight
```

## Usage

### Basic Calculation

```bash
python3 scripts/calculator.py
```

### With Parameters

```bash
python3 scripts/calculator.py '{
  "hs_code": "8518300000",
  "origin_country": "CN",
  "destination_country": "US",
  "fob_value": 5000.00,
  "quantity": 500,
  "freight_cost": 200.00
}'
```

### HS Code Lookup

```bash
python3 scripts/hs_lookup.py "wireless earbuds"
python3 scripts/hs_lookup.py "bluetooth speaker"
```

### Custom Trade Route

```bash
python3 scripts/calculator.py '{
  "hs_code": "9503009000",
  "origin_country": "VN",
  "destination_country": "DE",
  "fob_value": 10000.00,
  "quantity": 1000,
  "freight_cost": 500.00,
  "custom_duty_rate": 0.047,
  "custom_vat_rate": 0.19
}'
```

## Output Example

```
💰 Tariff & Landed Cost Report

Product: Wireless Bluetooth Earbuds
HS Code: 8518300000
Route: China 🇨🇳 → USA 🇺🇸

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📦 Cost Breakdown

FOB Value               $  5,000.00
International Freight   $    200.00
Insurance               $     15.00
CIF Value               $  5,215.00

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🏛️ Duties & Taxes

Base Duty (0.0%)        $      0.00
Section 301 (0.0%)      $      0.00
Total Duty              $      0.00
Customs Clearance       $    150.00
Port Fees               $     50.00

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

💵 Landed Cost Summary

Total Landed Cost       $  5,515.00
Per Unit Cost           $     11.03
```

## Trade Agreement Support

| Agreement | Countries | Benefit |
|-----------|-----------|---------|
| USMCA | US, Mexico, Canada | Reduced/zero duties |
| EVFTA | EU, Vietnam | Reduced duties |
| RCEP | Asia-Pacific | Reduced duties |
| UK-Japan | UK, Japan | Reduced duties |

## Custom Configuration

Create a custom config for your routes:

```json
{
  "default_origin": "CN",
  "default_destination": "US",
  "include_insurance": true,
  "insurance_rate": 0.003,
  "customs_fee": 150,
  "port_fee": 50
}
```

---

**Part of [Nexscope AI](https://www.nexscope.ai/?co-from=skill) — AI tools for e-commerce sellers.**

© Nexscope AI · MIT · nexscope-ai/Amazon-Skills

Similar skills

All skills for Finance and business →

From the same set51

amazon-display-ads Plans Amazon Sponsored Display strategies, configures audience targeting, and sets up retargeting funnels. Useful for launching display ads and competing on rival product pages. CX Codex +1 1,100installs amazon-global-selling A skill that helps an Amazon seller compare overseas marketplaces and build a staged expansion plan with verification gates. CX Codex +1 1,100installs amazon-buy-box A skill that breaks down Amazon Buy Box factors — seller metrics, price, fulfillment method — and turns them into an optimization plan. CX Codex +1 1,100installs amazon-rank-tracker Tracks Amazon keyword positions and diagnoses sudden search drops. Built for sellers to monitor organic ranks and benchmark performance against competitors. CX Codex +1 1,100installs amazon-deal-finder Picks the right Amazon promotion type for each product, estimates ROI, and builds a campaign calendar around Lightning Deals, coupons and Best Deals. CX Codex +1 1,100installs amazon-competitor-monitoring A skill that gathers competitor data on Amazon: prices, stock, new launches, reviews and ad signals. Builds the report from the agent's web search. CX Codex +1 997installs amazon-price-tracker Tracks competitor pricing on Amazon, monitors Buy Box status, and helps build dynamic pricing strategies directly in your AI coding agent. CX Codex +1 826installs amazon-keyword-tracker A skill that watches your product positions in Amazon search, flags competitor moves and tracks changes in the results page. Useful when sales dip and you need the reason. CX Codex +1 814installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor