CLI
HTS MCP includes a Click-based CLI for data pipeline management and database operations.
Usage
uv run hts <command> [options]Command Summary
Data Loading
| Command | Purpose |
|---|---|
load | Load tariff data from CSV/text file |
load-sections | Load HTS sections and extract headings |
load-chapters | Fetch chapters from USITC API |
load-tariff-resources | Load policy resources from JSON |
Enrichment
| Command | Purpose |
|---|---|
enrich-hts6 | Generate AI descriptions for HTS6 codes |
generate-embeddings | Generate HTS8 embeddings (legacy) |
generate-multilevel-embeddings | Generate multi-level embeddings |
embeddings-status | Show embedding availability |
Search & Graph
| Command | Purpose |
|---|---|
search | Interactive tariff search |
extract-code-references | Extract cross-references from descriptions |
generate-graph-edges | Generate KNN edge candidates |
classify-graph-edges | Classify edges with LLM |
graph-status | Show graph pipeline status |
Status
| Command | Purpose |
|---|---|
status | Database status overview |
Pipeline Order
For a fresh database, run commands in this order:
uv run hts load general_tariff_data.txt
uv run hts load-sections hts_sections.csv
uv run hts load-chapters
uv run hts extract-code-references
uv run hts load-tariff-resources
uv run hts enrich-hts6
uv run hts generate-multilevel-embeddings
uv run hts generate-graph-edges
uv run hts classify-graph-edges