Agent Skills
返回列表
中国行政区划查询

中国行政区划查询

企业运营 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_81da94ec/china-administrative-division-query。

技能介绍

要解决什么问题

做地址表单、物流路由、合规报表或数据清洗时,你往往需要与民政部口径一致的省市区县(及乡镇)编码与名称,而不是各平台各自维护、容易过期的静态 JSON。本技能把查询方式收敛到民政部地名服务公开接口,用统一的 code + maxLevel 规则做按父级下钻,避免手写层级表或猜行政区划代码格式。

技能如何工作

接口为 GET:https://dmfw.mca.gov.cn/9095/xzqh/getList,参数直接拼在 URL 上:

  • code:父级区划代码;留空表示从全国根节点查询
  • maxLevel:返回数据的层级深度:1 省、2 市、3 区县、4 乡镇

典型用法与 SKILL 一致:全国省级用 maxLevel=1;例如山东省下所有市用 code=37&maxLevel=2;青岛市下区县用 code=3702&maxLevel=3;某区县下乡镇用 code=370211&maxLevel=4。当用户提到「行政区划」「省市区联动」「获取下级区划」时,可按上述传参编写请求或封装客户端。

适用边界与注意点

  • 数据以民政部地名服务为准;若业务要对接国标 GB/T 2260 或其它第三方库,需自行核对字段与更新节奏是否一致。
  • 本技能描述的是查询接口与参数语义,不包含缓存策略、重试、鉴权或 SLA;生产环境应自行处理超时、限流与错误响应。
  • 乡镇级数据量较大,建议只在用户选定区县后再请求 maxLevel=4,避免一次性拉全国乡镇。

使用场景

  • 电商或 SaaS 注册页需要按用户所选省份动态加载下属城市列表,用父级 `code` 与 `maxLevel=2` 请求民政部接口
  • 物流系统在录入始发/目的地址时,需根据已选市级代码拉取区县选项,避免维护过期的本地行政区划表
  • 数据清洗脚本要把历史订单里的模糊地址对齐到标准区县编码,先按省、市逐级下钻再匹配 `maxLevel=3` 结果
  • 政务或合规报表要导出某区县下全部乡镇名称与代码,在选定区县后调用 `maxLevel=4` 获取下级列表

适合人员

  • 负责地址与区域选择组件的前端工程师,需要对接权威数据源实现省市区县联动
  • 做订单与地址主数据治理的后端或数据工程师,要把业务库与民政部口径的区划编码对齐
  • 实施 ERP、CRM 或 OMS 的集成顾问,在客户现场配置多级行政区划下拉与编码映射
  • 编写填报或统计类产品的业务开发,需在用户选定上级区划后动态加载下级选项