Agent Skills
返回列表
PostGrid 地址校验

PostGrid 地址校验

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md 的指南，在 AI 助手中安装 @user_15292d5a/yjkj-oo-postgrid-verify 技能。

技能介绍

PostGrid 地址校验

地址输入是表单、物流、用户画像系统中最容易出现脏数据的环节。用户可能随意缩写街道名、遗漏省份、或直接填写不存在的门牌号，这些错误会一路传导到后续的配送、计费与风控逻辑。oo-postgrid-verify 技能将 PostGrid 的地址校验能力封装进 oo CLI，让你在命令行或自动化脚本中直接调用，而无需自行管理 API Token。

核心能力

该技能通过 OOMOL 服务端注入凭证，对接 PostGrid Verify 连接器，提供 4 个 Action：

  • verify_address：支持自由文本或结构化输入，验证地址有效性并返回标准化结果
  • parse_address：将单行地址字符串拆解为街道、城市、州/省等独立字段
  • autocomplete_address：针对输入不完整的地址提供智能补全
  • lookup_city_state_from_postal：通过邮编反查对应的城市与行政区域

工作方式

技能遵循「先查契约，再执行」的原则。在构造 Payload 前，先用 oo connector schema 拉取实时输入/输出 Schema，而不是凭经验硬编码字段。执行时通过 --data 传入 JSON 对象，返回结果包含 data 与 meta.executionId，后者可用于追踪本次调用。

设计上，技能默认直接执行 Action，仅在命令返回认证错误（如 Not signed in、scope_missing）时才触发一次性配置流程，避免每次调用都打断用户。

适用边界

  • 仅支持美国与加拿大地址，其他地区不适用
  • 所有 Action 均为只读查询，不会修改外部系统状态
  • 遇到 OOMOL_INSUFFICIENT_CREDIT 说明账户额度耗尽，需充值后重试
  • 批量校验前建议先拿几条样本确认字段映射，避免整批数据格式错误

使用场景

  • 电商物流团队需将用户填写的杂乱收货地址进行标准化与有效性验证，确保包裹准确派送。
  • 数据工程师在清洗客户库时，需要将单行地址字符串拆解为省市、街道等结构化字段存入数据库。
  • 前端开发者在地址输入框中接入自动补全功能，当用户输入部分信息时实时返回候选地址列表。
  • 运营人员拿到一批包含邮编的列表，需要批量反查这些邮编对应的正确城市和州或省名称。

适合人员

  • 电商平台的后端开发工程师，诉求是快速接入可靠的美加地址校验接口，拦截无效订单发货。
  • 负责数据治理的数据工程师，诉求是编写脚本批量清洗脏地址数据，将其转化为规范的结构化记录。
  • 搭建客户管理系统的架构师，诉求是在系统中集成地址自动补全与解析组件，提升录入准确率。
  • 处理跨国物流账单的财务或运营专员，诉求是核对邮编与对应城市州省信息，避免结算错误。