Agent Skills
返回列表
IPv4归属地查询

IPv4归属地查询

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md，安装 @org-1qazsc77/chinaz-ip-location。

技能介绍

问题背景

在开发网络服务、分析访问日志或排查异常流量时，工程师常需要快速判断某个 IPv4 地址的地理来源。手动查 IP 库或拼凑多个接口往往碎片化，而本技能聚焦单一接口，提供街道级归属地查询，让 Agent 能在对话中直接给出结构化结果。

工作原理

核心是一个仅依赖 Python 标准库的脚本。流程清晰：从用户请求中提取 IP，读取环境变量中的 API Key，然后向 https://openapi.chinaz.net/v1/1048/newip 发起 GET 请求，附带 ip、ChinazVer=1.0 与 APIKey，最后解析返回的 JSON。

  • 成功时 code 为 "1"，data 对象包含国家、省份、城市、区县、街道、经纬度、运营商等字段。
  • 失败时按 msg 或错误码处理，例如 missing_api_key 提示环境变量未设置，HTTP 436 表示 Key 无效或额度不足。

适用边界与注意点

  • 仅支持 IPv4 地址，一次查询一个，批量任务须逐条执行。
  • 街道级定位仅供参考，可能存在偏差，不保证 100% 精确。
  • API Key 必须通过环境变量或安全存储管理，切勿写入代码、日志或聊天记录。
  • 不用于域名 Whois、ICP 备案或其他接口。

使用场景

  • 用户反馈某地服务无法打开时，需快速定位访问 IP 的省市及运营商，辅助排查区域网络故障。
  • 排查访问日志时，需提取可疑请求中的单个 IPv4 地址，查询其实际国家与城市判断是否符合预期业务来源。
  • 收到第三方回调来源不明的 IP 时，需查询其街道级位置与运营商，辅助评估来源风险。
  • 分析广告投放数据时，需查询单个样本用户 IP 的地理位置，验证投放区域是否符合预期城市。

适合人员

  • 需要在线上故障和日志中快速定位异常访问 IP 的地理与运营商信息的后端开发者。
  • 需要从用户反馈中提取 IP 归属地并定位区域网络故障的运维工程师。
  • 需要在威胁排查时判断可疑 IP 地理来源是否符合业务的安全工程师。
  • 需要提取少量样本 IP 的街道级位置用于投放验证的数据分析师。