HTS Classifier for Openclaw

A high-performance tool for identifying HTS codes and calculating current US import duty rates for 2026 trade compliance.

inasens
v1.0.1
Mar 5, 2026
0
146
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install hts-classifier

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install hts-classifier using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is HTS Classifier?

The HTS Classifier is a specialized utility designed for importers, trade professionals, and developers who need to navigate the complexities of US customs duties. By integrating the latest 2026 HTS schedule, this skill provides instant access to harmonized tariff codes and detailed duty breakdowns, including specialized overlays like Section 301 (China), Section 232 (Steel/Aluminum), and IEEPA Section 122 universal tariffs.

As part of the ecosystem of Openclaw Skills, it bridges the gap between raw trade data and actionable intelligence, allowing for programmatic product classification. It is designed to be lightweight, requiring no API keys for standard public searches, making it an essential component for any automated logistics or procurement workflow.

HTS Classifier Use Cases

  • Determining the correct HTS code for specific product descriptions like solar panels or lithium batteries.
  • Calculating estimated import taxes for goods originating from China affected by Section 301 duties.
  • Researching historical and current duty rates for specific tariff codes to assist in logistics planning.
  • Automating trade compliance checks within internal procurement workflows using Openclaw Skills.

How HTS Classifier Works

  1. The user provides a product description or a specific HTS code through the CLI or agent interface.
  2. The skill queries the ustariffrates.com public API to retrieve the most up-to-date 2026 HTS data.
  3. Optionally, if LLM ranking is enabled, the skill uses a local Ollama instance to refine and rank the most relevant classifications based on the query context.
  4. The system calculates the total estimated duty by aggregating the base rate (MFN) with active tariff overlays such as Sections 301, 232, and 122.
  5. A structured JSON response is returned containing the HTS code, official descriptions, and detailed tax warnings for the user.

HTS Classifier Setup

This skill requires Python 3. To set up the HTS Classifier within your environment, ensure you have the necessary dependencies installed.

To search by product description:

python3 ~/.openclaw/skills/hts-classifier/scripts/classify.py --query "solar panels"

To look up a specific HTS code:

python3 ~/.openclaw/skills/hts-classifier/scripts/classify.py --hts "8541.40"

To enable optional LLM ranking via Ollama:

python3 ~/.openclaw/skills/hts-classifier/scripts/classify.py --query "solar panels" --rank

HTS Classifier Data Schema & Taxonomy

The skill returns a structured JSON object containing the following key attributes:

Field Description
hts_code The primary harmonized tariff code identifier.
description The official US HTS textual description for the code.
base_duty General (MFN) duty rate applicable to the item.
section_301_china Additional duty percentage for goods of Chinese origin.
section_232 Specific duty percentage for steel or aluminum products.
section_122 IEEPA/Section 122 universal tariff percentage.
total_estimated The aggregate effective duty rate calculation.
warnings Contextual notes regarding active tariff overlays or trade restrictions.

HTS Classifier Advanced Features

  • Local LLM Ranking: Integration with Ollama for smarter product matching using models like qwen3:8b for improved accuracy in Openclaw Skills.
  • Custom Database Fallback: Support for Cloudflare D1 API for high-availability database access if you operate a private database instance.
  • Comprehensive Tariff Overlays: Automatically calculates complex duties including Section 301 (China), Section 232, and IEEPA Section 122.
  • Flexible Logging: Configuration via HTS_LOG to track and audit all classification queries or disable logging for sensitive product descriptions.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins python3
Github Stars: 0
forks: 0

Featured*