Upkuajing 跨境海关贸易公司搜索

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install upkuajing-customs-trade-company-search-zh
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 upkuajing-customs-trade-company-search-zh。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Upkuajing 跨境海关贸易公司搜索连接到 Upkuajing 开放平台 API，以搜索海关进出口数据。它帮助贸易团队根据产品、原产国或目的地国以及观察到的贸易活动发现公司——将交易记录转化为可操作的潜在客户。作为用于数据驱动研究的 Openclaw 技能之一，它支持公司发现和详细的贸易分析。
选择贸易列表搜索以检查单个订单，或选择公司列表搜索以查找从贸易记录中聚合的组织。必要时，用公司详细信息或联系信息丰富结果。API 调用是收费的，因此该技能在进行任何收费操作之前需要明确的用户确认。
选择贸易列表搜索以检查单个订单，或选择公司列表搜索以查找从贸易记录中聚合的组织。必要时，用公司详细信息或联系信息丰富结果。API 调用是收费的，因此该技能在进行任何收费操作之前需要明确的用户确认。
Upkuajing 跨境海关贸易公司搜索 应用场景
查找购买过特定产品（例如 LED 灯）的公司。
审查产品、国家或日期范围的单个进出口交易。
从海关记录中识别海外买家、进口商、出口商或潜在供应商。
发现选定国家之间具有贸易关系的公司。
筛选具有可用电子邮件联系信息的潜在公司。
用公司详细信息或联系渠道丰富选定的搜索结果。
通过分页搜索和可恢复任务分析更大的贸易数据集。
Upkuajing 跨境海关贸易公司搜索 工作原理
解释请求并选择合适的端点：用于交易记录的贸易列表搜索或用于从这些记录中聚合的公司的公司列表搜索。
在构建参数之前查阅匹配的 API 参考。根据需要应用产品或 HS 编码筛选器、日期范围以及 ISO 3166-1 alpha-2 国家代码。
检查是否已配置 Python 环境和 UPKUAJING_API_KEY。如果缺少密钥，请询问用户是提供密钥还是通过身份验证脚本请求密钥。
估算收费调用的数量。列表搜索每次调用最多返回 20 条记录；详情和联系人查询每次调用最多接受 20 个公司 ID。在运行付费操作之前，请说明预期的使用情况并等待明确的确认。
直接运行相关的 Python 脚本，然后查看其结果。对于大型搜索，请使用返回的任务 ID 从先前的光标继续并附加额外数据。
如果需要更多信息，请有选择地使用详细信息或联系信息丰富公司 ID，并遵守相同的确认要求。
向用户解释 API 错误。仅在用户确认后才报告意外的服务或响应错误；通过正常流程处理诸如无效凭据、参数或余额不足等普通问题。
Upkuajing 跨境海关贸易公司搜索 配置指南
要求：Python 和有效的 Upkuajing API 密钥。从技能目录安装脚本依赖项：
python --version
pip install -r requirements.txt
将密钥存储在 ~/.upkuajing/.env 中：
mkdir -p ~/.upkuajing
printf '%s\n' 'UPKUAJING_API_KEY=your_api_key_here' >> ~/.upkuajing/.env
或者，通过身份验证脚本请求新密钥；技能文档称生成的密钥会自动保存：
python scripts/auth.py --new_key
新密钥可能需要通过 Upkuajing 开发者平台进行账户注册和绑定。要检查账户信息或当前定价，请运行：
python scripts/auth.py --account_info
python scripts/auth.py --price_info
直接从技能环境中调用脚本，例如 python scripts/trade_list_search.py；不要使用诸如先切换到脚本目录之类的 shell 复合命令。在搜索之前查看 references/ 下的相关文件以获取准确的端点参数。产品和行业名称应使用英文，时间戳为毫秒，国家筛选器使用 ISO alpha-2 代码。所有 API 调用都可能产生费用，因此请在执行前披露预期使用情况并等待明确的用户确认。
Upkuajing 跨境海关贸易公司搜索 数据架构与分类体系
该技能围绕 Python 脚本、API 参考文档、凭据和搜索结果组织：
领域 文件或字段 用途
搜索脚本 scripts/trade_list_search.py, scripts/company_list_search.py 返回单个贸易记录或从贸易记录中聚合的公司。
丰富脚本 scripts/company_get_details.py, scripts/company_get_contact.py 检索公司 ID 的公司详细信息或联系信息。每个请求最多接受 20 个 ID。
账户和支持脚本 scripts/auth.py, scripts/error_report.py 管理 API 密钥和账户操作，检查价格，并报告确认的意外错误。
API 参考 references/trade-list-api.md, references/company-list-api.md, references/company-detail-api.md, references/contact-fetch-api.md, references/skill-error-report-api.md 记录端点参数和报告要求。
凭据 带有 UPKUAJING_API_KEY 的 ~/.upkuajing/.env 提供用于验证请求的 API 密钥。
搜索参数 产品或 HS 编码、日期范围、国家代码、公司筛选器和 query_count 定义搜索范围和请求的结果量。国家代码遵循 ISO alpha-2；时间戳为毫秒。
大查询延续 task_id、光标和返回的 file_url 恢复分页任务并附加其他结果。大查询结果可能存储为 JSONL；小心处理大文件。
贸易列表结果面向记录，而公司列表结果面向公司。任一列表中的公司 ID 都可用于详情或联系人丰富。技能文档并未规定每个端点的通用输出模式。
Upkuajing 跨境海关贸易公司搜索 高级特性
两种结果粒度：
搜索订单级贸易记录或公司级聚合，具体取决于目标是交易分析还是潜在客户发现。
定向丰富：
与联系渠道分开检索公司详细信息，并且仅丰富选定的公司而不是每个搜索结果。
可恢复的大型搜索：
使用其
task_id
继续任务，允许脚本从先前的光标继续并将数据追加到输出文件中。
明确的成本控制：
列表搜索每次调用最多返回 20 条记录，估算调用计算为
ceil(query_count / 20)
。详情和联系人请求最多接受 20 个 ID，使用量基于提交的 ID 数量。必须告知用户并必须在收费操作前明确确认。

工作原理

请求 API 密钥、检查账户信息、检索当前定价并在账户余额不足时创建充值订单。
错误报告保障：
首先解释意外的 API 或响应错误，仅在用户确认后提交报告。请勿报告常规业务错误，例如参数无效、密钥无效或余额不足。
搜索质量指导：
使用记录的参数名，在适当时优先使用 HS 编码进行更精确的产品筛选，按国家和日期缩小搜索范围，并在联系人性重要时使用电子邮件可用性筛选器。

name: upkuajing-customs-trade-company-search-zh description: 调取真实可靠的全球海关进出口记录，挖掘各行各业的进口商、出口商与采购商；可依托产品品类及原产国筛选目标企业、海外采购客户和优质供应商，助力外贸人员精准开发全球合作伙伴。