Agent Skills
返回列表
📊

海关分析报告·概览

数据分析 更新于 2026.08.30

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

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

技能介绍

要解决的问题

做跨境贸易或海关数据研究时,往往先要判断哪些国家的进出口主体更活跃、供应商与采购商规模如何分布,再决定是否下钻到 HS 编码或单一企业。手工在平台里逐国翻页既慢,也不便于交给 Agent 按自然语言发起查询。

技能如何工作

本技能通过跨境魔方开放平台 API拉取「分析报告-概览」数据集,返回粒度为国家:每个国家一条记录,字段体现不同供应商数量(countSeller)与不同采购商数量(countBuyer)。典型入口是运行 scripts/customs_analysis_overview.py 做概览查询;若响应带分页游标,可用其继续取下一页,没有游标即表示没有更多数据。

面向 Agent 的使用流程可以概括为:

  • 将用户意图对齐到概览查询(例如「按国家看供应商和采购商数量」「贸易活动分布概览」)
  • 执行前查阅 references/customs-analysis-overview-api.md,按文档填写参数,避免猜参数名
  • 国家字段采用 ISO 3166-1 alpha-2 二字码(如 US)
  • 与 customs-analysis-hscode-search、customs-overview-summary 等技能串联:先概览选国,再查编码或国家间汇总

适用边界与注意点

  • 所有 API 调用按次计费;产生费用前应说明并等用户单独确认,勿在同一条消息里既通知又执行。
  • 密钥保存在 ~/.upkuajing/.env 的 UPKUAJING_API_KEY;无效密钥或余额不足需按技能说明处理充值与账户信息。
  • 本技能提供的是各国主体数量层面的概览,不能替代企业明细、HS 编码检索或月度趋势;那些需用关联的 customs 系列技能。
  • 回复中宜用自然语言描述查询条件,避免向终端用户裸露内部参数格式。

使用场景

  • 市场调研前,需要先按国家对比活跃供应商与采购商规模,再决定重点跟进哪些市场
  • 写贸易分布简报时,要一次性拉取各国主体数量概览作为章节的量化底座
  • 用户问「哪些国家贸易主体更多」,需用概览接口按国汇总后再推荐下钻路径
  • 选定目标国列表后,用概览结果与 HS 编码搜索技能衔接做二级分析

适合人员

  • 做海外市场扫描的贸易分析师,需要先把各国进出口主体规模排个序再写结论
  • 跨境合规或情报顾问,客户追问某区域是否「贸易活跃」时要给出可核对的概览数据
  • 对接跨境魔方数据源的集成工程师,要把「按国概览」封装进 Agent 的对话式查询
  • 供应链管理岗,评估备选 sourcing 国家前想快速看各国供应商与采购商覆盖面