Agent Skills
返回列表
📊

海关国家贸易概览-采供商TopN

数据分析 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/upkuajing-customs-overview-top-n-zh-100。

技能介绍

要解决什么问题

在分析某条进出口路线时,你往往需要先知道「谁在跑量」:是哪些供应商在出口,或哪些采购商在进口,而不是从汇总数字里猜市场结构。海关侧的贸易数据体量很大,自己拼库、清洗、按公司聚合既费时,又很难和平台口径对齐。

技能如何工作

本技能通过跨境魔方开放平台 API,从海关贸易库中拉取供应商或采购商 TopN 排名。你指定起运国、抵运国、年份以及公司类型(companyType=1 为供应商/出口方,companyType=2 为采购商/进口方),返回按贸易量排序的公司列表;粒度是每家公司一条记录,并可配合响应中的季度、月度贸易统计做进一步分析。

典型用法包括:查看「某年从 A 国到 B 国的前 N 大供应商」,或「从 A 国进口到 B 国的前 N 大采购商」。结果中的公司内部 ID 可与同系列的公司统计、趋势、伙伴分布等技能衔接;若已知公司名,也可交给海关贸易公司搜索技能做对齐。

分页通过响应里的 cursor 获取下一页;没有 cursor 即无更多数据。执行查询前应查阅 references/customs-overview-top-n-api.md,不要凭感觉猜参数名;year 与 companyType 为必填。

适用边界与注意点

  • 每次 API 调用按次计费,执行前需用 auth.py --price_info 了解定价,并在产生费用前征得用户确认。
  • 需有效的 UPKUAJING_API_KEY(~/.upkuajing/.env);余额不足时需走充值流程。
  • 更适合「路线 + 年度 + TopN 榜单」类问题;若先要国家贸易概览或列表分页,可先用 customs-overview-summary、customs-overview-trade-list 再下钻到本技能。

使用场景

  • 调研中美某年航线时,要列出按贸易量排序的前十大出口供应商名单
  • 写竞品/供应链报告,需要确认某国对另一国进口侧的前 N 大采购商是谁
  • 做完国家贸易概览后,要下钻到具体公司层级看市场集中度
  • 分页拉全 Top 榜单,把 cursor 翻页结果整理进内部分析备忘录

适合人员

  • 做跨境品类立项、要先锁定某航线头部出口商的贸易分析师
  • 帮客户做海关数据尽调、需列明进口商 Top 清单的外贸咨询顾问
  • 在合规调研里核对「谁在跑量」、要把公司 ID 交给下游统计技能的法务或风控
  • 写行业研究月报、要把国家维度汇总换成公司维度榜单的内容研究员