跨境魔方海关贸易公司搜索
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/upkuajing-upkuajing-customs-trade-company-search-zh-108。
技能介绍
要解决什么问题
做跨境 B2B 获客或供应链调研时,光凭产品名或行业标签往往不够准:谁真的下过同类货的订单、和谁有稳定的进出口关系,通常要看海关侧留下的贸易轨迹。手工翻第三方报表既慢,也很难把「订单明细」和「公司名录」对齐到同一条业务问题上。
技能如何工作
本技能把 跨境魔方 开放平台的海关贸易 API 封装成可直接调用的 Python 脚本(scripts/*.py),采用数据驱动思路:用贸易记录与交易模式反查公司,而不是先猜公司再对账单。
核心能力分两层:
- 列表搜索(二选一)
- trade_list_search.py:一条贸易订单一行,适合回答「这段时间里发生了什么交易」(例如某公司产品对美出口的订单明细)。
- company_list_search.py:按公司聚合,适合回答「有哪些公司做过某类贸易」(例如采购过 LED、且与中国有电子产品往来的美国公司)。
- 结果增强(按需)
- company_get_details.py:用 --companyIds(空格分隔,单次最多 20 个)拉公司档案(不含联系方式)。
- company_get_contact.py:同样用公司 ID 拉邮箱、电话、网站、社交媒体等联系方式。
鉴权与账号通过 auth.py 处理:API 密钥写在 ~/.upkuajing/.env 的 UPKUAJING_API_KEY;可 --new_key 申请、--account_info 查账户、--new_rec_order 走充值流程。执行前应先读 references/trade-list-api.md / references/company-list-api.md,禁止猜测参数名。
大批量查询时,列表接口按「每次最多 20 条」折算调用次数(ceil(query_count / 20));详情/联系接口按传入 ID 数量计费。凡会产生费用的操作,须先告知次数/ID 数量,并在用户单独确认后再跑脚本。
适用边界与注意点
- 产品名、行业名等筛选项需用英文;国家用 ISO 3166-1 alpha-2(如
CN、US)。时间戳为毫秒级;大查询建议timeout:120。 - 超大结果常以 jsonl +
task_id分页续查,注意文件体积;若只需少数公司,不要对整表公司 ID 批量打详情/联系接口。 - 回复用户时用自然语言描述条件,不要在对话里堆砌 API 参数格式;定价以
python scripts/auth.py --price_info为准,不要口头估费。
使用场景
- 需要根据 HS 编码或产品英文名列出 2024 年对美出口 LED 灯具的订单明细,用于核对品类与量级
- 要从「采购过 LED」的公司名单里筛出有邮箱的美国进口商,再导出少量 ID 做触达名单
- 物流销售要锁定与中国有电子产品进出口往来的美国公司,用公司列表聚合结果做客户池初筛
- 已拿到贸易列表 jsonl,只需对其中 5 家供应商补全公司档案与电话邮箱,避免对全量 ID 批量计费
适合人员
- 跨境硬件或元器件商务,想用海关订单记录验证某海外市场是否真有持续采购而非网传名单
- 市场分析顾问,要把大豆等大宗商品在某时段内的进出口轨迹拆成可复用的贸易明细数据集
- 外贸 SaaS 或数据产品的实施同学,需按文档参数帮客户跑公司列表并控制单次 20 条以上的 API 费用确认流程
- 国际货代或供应链销售,目标是按双边贸易关系找潜在客户,并只在必要时追加联系方式接口