Agent Skills
返回列表
📊

海关公司贸易伙伴趋势查询

数据分析 更新于 2026.08.30

将以下提示词粘贴到你的 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/产品分布写入客户背景调查附件