海关公司贸易趋势查询
将以下提示词粘贴到你的 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 的数据工程师,为企业画像流水线接入公司级趋势查询节点