Agent Skills
返回列表
📊

海关公司贸易趋势查询

数据分析 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/upkuajing-customs-company-trends-zh-101。

技能介绍

要解决什么问题

做外贸尽调、竞品供应链分析或客户画像时,往往不满足于「某公司去年出口多少」,而需要按月拆开的走势:季节性是否明显、某段 HS 编码品类是否在收缩、与特定贸易伙伴的节奏是否对齐。海关侧的企业粒度数据如果只有年度汇总,很难支撑这类时间序列问题。

本技能面向的就是:已知公司 ID 与角色(供应商 / 采购商)时,拉取该公司的月度贸易趋势记录,每条对应一个自然月,可附带交易次数、数量、重量、金额等字段,并可用日期范围、产品、HS 编码、国家、贸易伙伴、港口等条件收窄查询范围。

技能如何工作

数据来自跨境魔方开放平台的公司贸易趋势接口。执行前需在 ~/.upkuajing/.env 配置 UPKUAJING_API_KEY;调用应按技能要求走直接脚本(如 python scripts/customs_company_trends.py),并在执行产生费用的 API 调用前向用户说明计费方式、等待明确确认。

典型参数逻辑(以 references/customs-company-trends-api.md 为准,勿猜字段名):

  • companyType:1 表示供应商,2 表示采购商
  • 时间范围常用 dateStart / dateEnd(毫秒级时间戳)
  • 国家筛选使用 ISO 代码(如 US、KR)

返回粒度固定为每月一条;可读月份常出现在 monthText(如 2024-01),month 为对应的时间戳。公司 ID 可结合同系列的统计或企业搜索技能先行解析。

边界与注意点

  • 按次计费:一次调用对应一家公司的一次趋势查询,费用以平台定价为准(可用 auth.py --price_info 查询),不要口头估费。
  • 密钥与余额:密钥无效或余额不足时需按 SKILL 流程处理充值或补密钥,勿在未授权时代用户付款。
  • 参数纪律:筛选条件与必填项以 API 文档为准;产品维度优先 HS 编码比纯名称更稳。
  • 回复呈现:面向用户说明请求与结果时用自然语言,避免把内部参数表原样贴成「技术参数墙」。

使用场景

  • 已拿到目标企业的海关公司 ID,需要按月看其作为供应商的出口金额与重量变化
  • 对比某采购商在 2024 年与 2025 年各月的进口次数,判断是否存在明显季节性采购
  • 在限定贸易伙伴国家与 HS 编码的前提下,拉取单家公司的月度贸易序列做竞品供应链复盘
  • 尽调报告中要把「年度总额」展开成月度曲线,并核对某几个月是否与港口/伙伴筛选一致

适合人员

  • 外贸 BD 在签约前需用海关月度数据验证客户采购节奏是否与客户自述一致
  • 供应链分析师要把竞品关联企业的出口品类按 HS 编码做月度走势对比
  • 投资/信用尽调人员将企业贸易流水按自然月拆解,写入风控或研报附录
  • 使用跨境魔方 API 的数据工程师,为企业画像流水线接入公司级趋势查询节点