Agent Skills
返回列表
聚合 IP 归属地查询

聚合 IP 归属地查询

IT 运维与安全 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_15292d5a/yjkj-juhe-ip-query。

技能介绍

要解决什么问题

运维排障、安全审计或日志分析里，经常需要从 IPv4 反查归属：国家、省份、城市、运营商。手工打开第三方网页效率低，也不方便在对话里批量汇总。本技能把 聚合数据 的 IP 归属地 API 封装成可脚本化、可给 Agent 调用的流程，输出结构化 JSON 或表格。

技能如何工作

  1. 识别地址：从用户输入里提取 IPv4；遇到 192.168.x.x、10.x.x.x、127.x.x.x 等 私有 IP 直接说明是内网，不发起外网查询。
  2. 调用查询：通过 scripts/ip_lookup.py 或直接请求 API，返回字段包括 Country / Province / City / Isp（国家、省、市、运营商）。
  3. 展示结果：单个 IP 用自然语言说明；多个 IP 用表格汇总，便于对照日志或资产清单。

使用前需在聚合数据官网申请 AppKey（免费档约 每天 50 次），并按 SKILL 说明配置到环境或项目里。

适用边界与注意点

  • API 仅支持 IPv4；IPv6 需明确告知无法查询。
  • error_code 10001/10002 多为 Key 无效，需重新申请或核对配置；10012 表示当日免费额度用尽。
  • 网络超时可重试一次；归属地数据以聚合数据返回为准，精度受 IP 库更新与分配方式影响，不宜作为唯一法律或合规依据。

使用场景

  • 分析 Web 或 Nginx 访问日志时，将异常请求的客户端 IPv4 批量查成国家、省、市与运营商，便于对照攻击或刷量来源。
  • 处理登录或 VPN 安全告警时，需确认可疑源 IP 的省市及电信/联通/移动归属，再决定是否封禁或加白。
  • 从防火墙或 IDS 导出一批外联 IPv4，在对话里用表格汇总归属地，写入 incident 或审计记录。
  • 用户报障称网络或地域异常时，核对其提供的公网 IPv4 是否与自述省份、运营商一致。

适合人员

  • 负责 WAF、防火墙告警分诊的安全运维，需要把 alert 中的公网 IP 快速 enrich 成可读的省市与运营商信息。
  • 维护线上 Web 服务、定期审访问与 CDN 日志的后端工程师，要按地域和 ISP 对照异常流量来源。
  • 在工单系统处理网络类投诉的一线 IT 支持，需根据用户提供的 IPv4 核实归属地是否与现象描述一致。
  • 搭建 Agent 工作流的平台开发者，希望模型能识别私有 IP、跳过无效查询并调用聚合 API 返回结构化结果。