What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Global customs trade data aggregated across 220+ countries with integrated bulk search functionality for global B2B prospecting. Accelerate discovery ofverified genuine buyers and qualified international suppliers for export businesses. Dig into official

Access global customs trade data from 220+ countries. Search import‑export records via companies, HS codes and products. Find genuine buyers and monitor competitors for your export business. Trigger: global customs trade data, import export records lookup, HS‑code search, find overseas buyers, competitor trade monitoring, bulk trade‑data search

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.9k

Updated

Oct 9, 2026

Version

1.0.10

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.9K downloads reported by the source. Last updated 10/9/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 9, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 9, 2026
Adoption signal: 1.9K downloadsadoption · observed Oct 9, 2026
Latest release: 1.0.10release · observed Aug 24, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17304xrt0p2xssnmr7datqzks83gvsr:upkuajing-customs-trade-company-search

Install using `clawhub skill install s17304xrt0p2xssnmr7datqzks83gvsr:upkuajing-customs-trade-company-search` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/upkuajing/upkuajing-customs-trade-company-search before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-upkuajing-upkuajing-customs-trade-company-search/snapshot"

Documentation

CLAWHUB

119,486 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: upkuajing-customs-trade-company-search
description: "Access global customs trade data from 220+ countries. Search import‑export records via companies, HS codes and products. Find genuine buyers and monitor competitors for your export business.\n\nTrigger: global customs trade data, import export records lookup, HS‑code search, find overseas buyers, competitor trade monitoring, bulk trade‑data search"
metadata: {"version":"1.0.10","homepage":"https://www.upkuajing.com","clawdbot":{"emoji":"🏢","requires":{"bins":["python"],"env":["UPKUAJING_API_KEY"]},"primaryEnv":"UPKUAJING_API_KEY"}}
---

# UpKuaJing Customs Trade Company Search

Search for companies through customs trade data using the UpKuaJing Open Platform API. This skill uses a **data-driven approach**: finding companies by analyzing trade records and transaction patterns.

## Overview

This skill provides access to UpKuaJing's customs trade data API through four scripts: two search methods (trade list, company list) and two enhancement interfaces (company details, contact information).
API key generation and top-up are provided through the `auth.py` script.

## Running Scripts

### Environment Setup

1. **Check Python**: `python --version`
2. **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/trade_list_search.py`. **Do NOT use** shell compound commands like `cd scripts && python trade_list_search.py`.

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

### Two Search Methods

**Trade List Search** (`trade_list_search.py`)
- **Return granularity**: Each trade order as one record
- **Use cases**: Focus on "what transactions occurred"
- **Examples**:
   - "Show all orders where Company A purchased LED"
   - "Find soybean trade records imported/exported to US"
   - "View specific transaction details within a time period"
- **Parameters**: See [Trade List](references/trade-list-api.md)


**Company List Search** (`company_list_search.py`)
- **Return granularity**: Trade orders aggregated by company, each company as one row
- **Use cases**: Focus on "which companies exist"
- **Examples**:
  - "Find companies that purchased LED"
  - "Find US companies with electronics import/export business with China"
  - "Find companies with China-US trade" (logistics industry customer development)
- **Parameters**: See [Company List](references/company-list-api.md)


### Two Enhancement Features

After obtaining trade list or company list, use these interfaces to enrich company IDs in the results when necessary:
**Company Details** (`company_get_details.py --companyIds *`)
- Get company information (excluding contact information)
- **Parameters**: `--companyIds` List of company IDs (space-separated), max 20 at a time

_meta.json

{
  "ownerId": "kn76ywjzma121r2rh959ejsf49834c6x",
  "slug": "upkuajing-customs-trade-company-search",
  "version": "1.0.10",
  "publishedAt": 1787562509260
}

references/company-detail-api.md

# 公司详情 API 参考

## python脚本参数
- `--companyIds`：公司ID列表（空格分隔，必需，最多20个）

## 请求参数

### 必需参数
- companyIds（整数数组）：公司编号列表（最多20个）

## 响应参数

### 基本信息
- companyId：公司编号
- name：公司名
- logo：公司logo
- introduce：公司介绍
- industry：行业
- scope：经营范围

### 位置信息
- location：公司位置
- country：国家
- province：省、州
- city：城市
- address：地址
- postcode：邮编

### 注册信息
- registerPerson：注册法人
- registerNumber：注册编号
- registerDate：注册日期
- registerType：注册类型
- registerCapital：注册资金
- registerState：注册状态

### 贸易信息
- companyType：公司贸易类型
  - 0：未知
  - 1：供应商
  - 2：采购商
  - 3：采购商和供应商

### 国家信息
- country.id：国家编号
- country.name_cn：国家中文名
- country.name_en：国家英文名
- country.code_iso2：国家二字码
- country.icon：国旗链接

references/company-list-api.md

# 公司列表 API 参考

## python脚本参数
- `--params`: API业务参数
- `--task_id`：任务ID；指定task_id时，脚本会找到task_id的执行参数，从最后一条数据继续游标查询；一般用于大数据量查询、异常中断后继续查询；
- `--query_count`：期望获取的总记录数，脚本据此自动计算次数并轮询调用API；非必填；默认值20；取值范围 20~1000；
params、task_id 必须指定其一，不能同时指定时

## params API业务参数
### 必需参数
- companyType（整数）：公司类型`1`：供应商，`2`：采购商
### 贸易时间
- dateStart（整数）：贸易开始时间（毫秒级时间戳）
- dateEnd（整数）：贸易截止时间（毫秒级时间戳）
### 产品筛选
- products（数组）：产品名称列表
- hscodes（数组）：HS海关编码（超过6位，只取前6位）
- productSuperordinate（数组）：产品的上游产品名称列表
- productDownstream（数组）：产品的下游产品名称列表
### 公司筛选
- sellerIds（数组）：供应商公司ID列表
- buyerIds（数组）：采购商公司ID列表
- seller（字符串）：供应商公司名称
- buyer（字符串）：采购商公司名称
### 地理筛选
- sellerCountryCodes（数组）：供应商国家代码
- buyerCountryCodes（数组）：采购商国家代码
- originCountryCodes（数组）：起运国国家代码
- arrivalCountryCodes（数组）：抵运国国家代码
- sellerPort（字符串）：装运港
- buyerPort（字符串）：卸货港
### 联系方式筛选
- existPhone：1（有电话），2（无电话），0（全部）
- existEmail：1（有邮箱），2（无邮箱），0（全部）
- existWhatsApp：1（有WhatsApp），2（无WhatsApp），0（全部）
- existWebsite：1（有网站），2（无网站），0（全部）
- existSocial：1（有社媒），2（无社媒），0（全部）
### 其他参数
- tradeCode（字符串）：提关单号
- minTradeCount（整数）：最小贸易频次数量
- createTimeStart/createTimeEnd（整数）：数据创建日期范围
- isExact（布尔值）：true=精确匹配，false=模糊匹配（默认true）

### 排序
- sorting_field：tradeCount（默认）、latestTradeDate
- sorting_direction：asc、desc（默认：desc）

## 响应

### 公司标识
- companyId：公司ID
- companyType：1（供应商），2（采购商）
- name：公司名称
### 贸易统计
- tradeTotal：贸易总量
- tradeMatchTotal：匹配贸易量
- tradeMatchPercent：匹配贸易占比（%）
- latestTradeDate：最后贸易日期（毫秒时间戳）
### 公司信息
- countryInfo：所属国信息
- scope：公司主营
- address：公司地址
### 产品信息
- productDesc：产品描述
- productTag：产品标签列表
- productNames：标准化产品名称
- productAlias：产品别名
- productSuperordinate：产品的上游产品名称列表
- productDownstream：产品的下游产品名称列表

references/contact-fetch-api.md

# 联系方式获取 API 参考

## python脚本参数
- `--companyIds`：公司ID列表（空格分隔，必需，最多20个）

## 请求参数

### 必需参数
- companyIds（整数数组）：公司编号列表（最多20个）

## 响应参数
- companyId：公司编号

### 邮箱信息 emails
- val：邮箱地址
- is_valid：是否有效
  - 0：未检测
  - 1：是
  - 2：否
  - 3：不确定
- reason：原因

### 电话信息 phones
- val：电话号码
- is_valid：是否有效（0未检测，1是，2否，3不确定）
- is_ws：是否WhatsApp
  - 0：未检测
  - 1：是
  - 2：否
  - 3：不确定
- phone_type：号码类型
  - 0：未检测
  - 1：固定电话
  - 2：移动电话
  - 3：已检测但未知
- country_code：电话所属国家二字码
- dialing_code：电话所属国际冠码
- area_code：电话所属地区码
- international_number：国际格式号码
- telephone：号码(去除冠码与区码)
- national_number：号码属国格式

### 社交媒体信息 socials
- val：社媒完整链接
- social_url：社媒链接路径
- social_type：社媒链接类型
  - linkedin、facebook、twitter、youtube、instagram、pinterest、github、tiktok
- is_valid：是否有效（0未检测，1是，2否，3不确定）
- reason：原因

### 网站信息 websites
- val：网址
- is_valid：是否有效（0未检测，1是，2否，3不确定）
- is_sensitive：是否敏感
  - 0：未检测
  - 1：是（如电子商务网站）
  - 2：否
  - 3：不确定
- reason：原因

Github ReposUpdated 12h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.