Agent Skills
返回列表
📚

海关分析 · HS 编码搜索

知识管理 更新于 2026.08.30

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

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

技能介绍

要解决什么问题

进出口报表、关税测算或合规核对时,往往先要确定商品对应的 HS 编码。单纯靠经验或零散表格很难快速锁定「奶粉」「以 0402 开头」这类条件下的完整候选列表,也不便于把编码交给后续的趋势、区域或明细类分析。

技能如何工作

本技能通过 跨境魔方开放平台 API 执行 HS 编码搜索。你提供 产品名称 与 HS 编码关键字/前缀(product、hscode 均为必填),脚本 customs_analysis_hscode_search.py 返回一页或多条匹配的 HS 编码字符串列表。

典型用法包括:

  • 按品类名称检索,例如「搜索奶粉的 HS 编码」
  • 按编码前缀缩小范围,例如「查找以 0402 开头的 HS 编码」
  • 将结果交给 customs-analysis-hscode-detail 查描述,或 customs-analysis-trends / customs-analysis-area 做贸易分析

执行前需配置 UPKUAJING_API_KEY(~/.upkuajing/.env),并按文档 references/customs-analysis-hscode-search-api.md 核对参数,勿猜测字段名。

适用边界与注意点

  • 按次计费:每次调用返回一页搜索结果都会产生费用;应在单独确认后再执行,勿在同一条回复里未确认就调 API。
  • 密钥无效或余额不足时需按技能说明处理充值与账户信息(auth.py 相关流程)。
  • 本技能只负责 列出匹配的 HS 编码,编码含义与贸易统计需用关联技能或 API 文档继续查询。

使用场景

  • 报关前要根据「奶粉」等产品名拉出可落地的 HS 编码候选,再挑一个进明细或趋势分析
  • 合规同事给出 0402 等前缀,需要在开放平台里枚举该段下的全部编码条目
  • 做某公司贸易画像前,先按品名关键字搜 HS,再交给区域或占比类技能继续查
  • 写内部分析简报时,要把口头品名映射成可复用的标准 HS 编码列表

适合人员

  • 负责进出口单证填写的关务,经常要先查品名对应的 HS 再核对税则条文
  • 做关税或贸易数据产品的分析师,需要把用户说的品类转成可查询的编码前缀组合
  • 合规与风控人员收到 HS 片段或商品描述,要核验平台侧是否存在一致编码集合
  • 集成跨境魔方 API 的工程师,在编排多技能工作流时把本搜索作为 HS 解析的第一步