海关公司贸易伙伴趋势查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/upkuajing-customs-company-partner-stats-zh-101。
技能介绍
要解决什么问题
做外贸背调或供应链分析时,你往往已经锁定一家公司 ID,但还需要看清:和谁发生贸易、各伙伴占多少份额、按月有没有断档、主力 HS 编码和产品长什么样。这类问题单靠企业搜索列表很难一次讲清楚,需要接口返回公司维度的伙伴分布,而不是零散的单笔报关摘要。
技能如何工作
本技能通过跨境魔方海关开放 API,调用 customs_company_partner_stats.py 查询公司贸易伙伴趋势。核心输入是 公司 ID 与 公司类型(companyType:1 为供应商、2 为采购商),并可叠加日期范围等筛选。
返回粒度是单家公司的综合分布,典型字段包括:
- 总金额 / 数量 / 重量 等汇总口径
tradeDates:哪些月份有贸易活动hscodes:各 HS 编码的贡献占比(percentTrade为百分比数值)products:产品级分布,并关联对应 HS 编码列表
工作流上,Agent 应先对照 references/customs-company-partner-stats-api.md 核对参数名与格式,再通过 ~/.upkuajing/.env 中的 UPKUAJING_API_KEY 发起调用。每次查询按调用次数计费,须在单独确认后再执行脚本。公司 ID 可来自 customs-company-stats 或 upkuajing-customs-trade-company-search 等关联技能。
适用边界与注意点
- 分析的是贸易伙伴构成与分布,不是替代企业名录全文检索。
- 角色由
companyType决定;同一 ID 以供应商或采购商视角查询,结果含义不同。 - 密钥无效、余额不足或参数错误时,应走文档与
auth.py账户/定价流程,不要猜测参数。 - 回复给用户时应把技术参数转成自然语言,避免直接堆代码式参数字段。
使用场景
- 已拿到海关公司 ID,需要列出其主要贸易伙伴及金额占比用于尽调备忘录
- 要把某采购商近一年的月度贸易活跃月份补齐,判断是否存在季节性断档
- 分析指定供应商的 HS 编码分布,为同类产品海关企业搜索定关键词
- 对照产品维度分布与关联 HS 列表,核对报关品类是否与公开产品线一致
适合人员
- 外贸风控同事:锁定目标企业后需量化贸易伙伴集中度与品类结构
- 海关数据分析师:按公司角色切换供应商/采购商视角做伙伴与编码分布报表
- BD 在拓客前:用海关侧伙伴与产品分布验证潜在客户供应链画像
- 合规调研顾问:将 tradeDates 与 HS/产品分布写入客户背景调查附件