Query HS code detail information for analysis reports — retrieve Chinese and English descriptions for a given HS (Harmonized System) code from customs data. Provides comprehensive product classification details to help trade professionals, analysts and import-export practitioners understand what products a specific HS code represents. Essential for tariff code lookup, product classification verification, customs code interpretation and trade data analysis preparation across global customs trade data.

Query HS code detail information — retrieve Chinese and English descriptions for a given HS code. Trigger: HS code detail, tariff code description, customs code lookup, HS code meaning, product classification

upkuajing openapi skills@upkuajing

Install

openclaw skills install @upkuajing/customs-analysis-hscode-detail

Customs Analysis HS Code Detail

Query HS code detail information from customs data using the UpKuaJing Open Platform API.

Overview

This skill retrieves detailed description information for a given HS (Harmonized System) code, including both Chinese and English descriptions. This helps you understand what products a specific HS code represents.

Running Scripts

Environment Setup

Check Python: python --version
Install dependencies: pip install -r requirements.txt

Script directory: scripts/*.py Run example: python scripts/*.py

Important: Always use direct script invocation like python scripts/customs_analysis_hscode_detail.py. Do NOT use shell compound commands like cd scripts && python customs_analysis_hscode_detail.py

HS Code Detail Query (`customs_analysis_hscode_detail.py`)

Return granularity: One record per query
Use cases: Look up product classification for an HS code, get Chinese/English descriptions of tariff codes
Examples:
- "What does HS code 04021000 mean?"
- "Get the description for HS code 04021000"
Parameters: See HS Code Detail API

API Key and Top-up

This skill requires an API key. The API key is stored in the ~/.upkuajing/.env file:

bash

cat ~/.upkuajing/.env

Example file content:

text

UPKUAJING_API_KEY=your_api_key_here

API Key Not Set

First check if the ~/.upkuajing/.env file has UPKUAJING_API_KEY; If UPKUAJING_API_KEY is not set, prompt the user to choose:

User has one: User provides it (manually add to ~/.upkuajing/.env file)
User doesn't have one: You can apply using the interface (auth.py --new_key), the new key will be automatically saved to ~/.upkuajing/.env Wait for user selection;

Account Top-up

When API response indicates insufficient balance, explain and guide user to top up:

Create top-up order (auth.py --new_rec_order)
Based on order response, send payment page URL to user, guide user to open URL and pay, user confirms after successful payment;

Get Account Information

Use this script to get account information for UPKUAJING_API_KEY: auth.py --account_info

API Key and UpKuaJing Account

Newly applied API key: Register and login at UpKuaJing Open Platform, then bind account

Fees

All API calls incur fees, different interfaces have different billing methods.

Latest pricing: Users can visit Detailed Price Description Or use: python scripts/auth.py --price_info (returns complete pricing for all interfaces)

Query Billing Rules

Billed by number of calls, each call returns one HS code detail:

Each API call incurs a fee
Before execution:
1. Inform user that this query will incur a fee
2. Stop, wait for explicit user confirmation in a separate message, then execute script

Fee Confirmation Principle

Any operation that incurs fees must first inform and wait for explicit user confirmation. Do not execute in the same message as the notification.

Workflow

Decision Guide

User Intent	Use API
"What does HS code 04021000 mean?"	HS Code Detail Query
"Get description of tariff code 04021000"	HS Code Detail Query
"Explain product classification for 04021000"	HS Code Detail Query

Usage Examples