海关国家贸易概览-采供商TopN
将以下提示词粘贴到你的 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 交给下游统计技能的法务或风控
- 写行业研究月报、要把国家维度汇总换成公司维度榜单的内容研究员