mcpField
X
xborder-logistics

xborder-logistics

github.com/asgard-ai-platformOther243152 installsUpdated 21w ago
Repository

About xborder-logistics

xborder-logistics is a skill for teams planning cross-border e-commerce fulfillment. It compares direct mail, bonded warehouses, and overseas warehouses while emphasizing return costs and customs considerations.

Key features

  1. 01Compare three cross-border logistics models
  2. 02Choose fulfillment by monthly order volume
  3. 03Account for duties and landed costs
  4. 04Assess returns and inventory risks

Use cases

  1. 01Choose delivery for a new market test
  2. 02Assess when to move to an overseas warehouse
  3. 03Estimate duties and landed costs

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/asgard-ai-platform/skills --skill xborder-logistics

After installing, type/xborder-logisticsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

examples/
sample_scenario.md
references/
3pl-comparison.md
customs-by-country.md

Details

From the project README

Cross-Border Logistics

Framework

IRON LAW: Return Logistics Costs 3-5× More Than Outbound — Budget for It or Die

Agents plan outbound shipping costs but systematically ignore returns.
Cross-border return rates run 15-30% for apparel, and each return costs
3-5× the outbound shipment (reverse customs, restocking, re-export duties,
currency loss). If your margin can't absorb a 20% return rate at 4× cost,
the overseas warehouse model is a cash trap regardless of forward volume.
Calculate the break-even return rate BEFORE committing to a fulfillment model.
Three Logistics Models
ModelHow It WorksDelivery TimeCost per OrderMin. VolumeBest For
Direct Mail (直郵)Ship each order from Taiwan to customer7-21 daysHigh ($8-25)1 orderTesting market, low volume, high-value items
Overseas Warehouse (海外倉)Pre-stock inventory in destination country, ship locally1-5 daysLow ($2-5 local) + warehousing100+ units/monthProven demand, competitive delivery needed
Bonded Warehouse (保稅倉)Store in bonded zone, clear customs per-order3-7 daysMedium ($5-10)50+ units/monthDuty deferral, uncertain demand
Decision Framework
Monthly orders to one country < 50 → Direct Mail
Monthly orders 50-500 → Consider Bonded Warehouse
Monthly orders > 500 → Overseas Warehouse justified
Customs & Duties Considerations
FactorWhat to Know
De minimis thresholdBelow this value, no import duty (varies: $75 in most SEA, $400 in US)
HS CodeProduct classification code determines duty rate. Get this RIGHT — wrong HS code = penalties
Landed costProduct cost + shipping + insurance + duties + taxes = what customer actually pays
DocumentationCommercial invoice, packing list, certificate of origin, product-specific certificates
Restricted itemsFood, cosmetics, electronics, medical devices often need import permits
Fulfillment Partner Types
TypeServiceCostControl
3PL (e.g., ShipBob, Boxme)Full service: storage, pick-pack, ship$$-$$$Low (outsourced)
Marketplace fulfillment (Shopee/Lazada warehouse)Platform handles logisticsCommission-includedVery low
Self-operated warehouseYour own warehouse + staff$$$$ upfrontFull
Drop-shippingSupplier ships directlyLowestNone
Implementation Steps

Phase 1: Direct Mail (Market Testing)

  1. Partner with international courier (DHL, FedEx, SF Express)
  2. Research destination country customs requirements
  3. Prepare documentation templates
  4. Test with first 50 orders

Phase 2: Transition to Overseas Warehouse (Scaling) 5. Select 3PL or marketplace fulfillment in target market 6. Ship initial inventory batch 7. Integrate order management: your system → warehouse WMS 8. Monitor: fill rate, delivery time, return rate

Phase 3: Optimize 9. Analyze SKU-level demand to optimize pre-stocking 10. Negotiate volume rates with logistics partners 11. Evaluate bonded warehouse for duty optimization

Output Format

# Cross-Border Logistics Plan: {Product} → {Destination}

## Current State
- Monthly orders: {N}
- Current model: {direct mail / none}
- Avg delivery time: {days}

## Recommended Model
- Model: {Direct Mail / Bonded / Overseas Warehouse}
- Rationale: {volume, speed requirement, cost}

## Cost Comparison
| Model | Per-Order Cost | Monthly Fixed | Total (at {N} orders) |
|-------|---------------|-------------|---------------------|
| Direct Mail | ${X} | $0 | ${X} |
| Overseas Warehouse | ${X} | ${X} | ${X} |

## Implementation Plan
| Phase | Action | Timeline |
|-------|--------|----------|
| 1 | {step} | {weeks} |

Gotchas

  • Returns are the hidden cost: Cross-border returns are expensive and logistically complex. Build return rate assumptions (5-15% for e-commerce) into your cost model. Offer local returns if using overseas warehouse.
  • Customs delays are unpredictable: Allow buffer in delivery estimates. "7-14 business days" is more honest than "7 days" for direct mail.
  • Product compliance varies by country: Electronics need local certification (e.g., SIRIM in Malaysia, NCC in Taiwan). Food products need import permits. Check BEFORE shipping.
  • Currency and duty changes: Exchange rates and duty rates change. Build 5-10% margin buffer into landed cost calculations.
  • Inventory risk in overseas warehouse: Pre-stocked inventory that doesn't sell ties up capital and may become obsolete. Start with proven bestsellers only.

References

  • For country-specific customs requirements, see references/customs-by-country.md
  • For 3PL provider comparison, see references/3pl-comparison.md

Comments

Markdown supported