📡 ipip.si API 文档 v1

免费开放，合理使用。归属地/ASN 数据：This product includes GeoLite2 data created by MaxMind；威胁情报名单来自 FireHOL；AI 爬虫 IP 段来自各家官方公布。仅供参考。

查询 IP

GET /api/v1/ip?ip=8.8.8.8
也支持域名：/api/v1/ip?ip=google.com
不带参数则返回请求者本人的 IP 信息。
{
  "ip": "8.8.8.8",
  "country": "美国", "region": "", "city": "",
  "asn": 15169, "org": "Google LLC",
  "net_type": "dc", "net_type_label": "数据中心",
  "datacenter": true, "ip_version": "v4",
  "threat_listed": false,
  "ai_agent": null,
  "api_version": "v1"
}

字段说明

net_type：dc 数据中心 / isp 家庭宽带 / mobile 移动网络 / edu 教育网 / vpn VPN代理出口 / unknown 未知
threat_listed：是否命中 FireHOL 威胁情报名单
ai_agent：命中 AI 爬虫名录时返回 {"name","org"}，如 {"name":"GPTBot","org":"OpenAI"}；未命中为 null

其他接口

GET /api/myip — 请求者本人的 IP 信息
GET /api/lookup?q=1.1.1.1 — 网页版查询同款接口
GET /agents — AI 爬虫 IP 名录公示页
GET /api/stats — 首页浏览聚合统计（人类/AI爬虫/其他bot计数，不含访客 IP）
GET /api/health — 服务健康检查

ai_agent 名录每周与官方源同步；命中表示"该 IP 在官方公布的 AI 爬虫段内"，不代表本次访问一定是爬虫。

MCP Server（给 AI 助手用）

工具：ip_lookup（查 IP/域名完整身份）· ip_reputation（纯净度专项检查）

在你的 MCP 客户端配置里加： 
{
  "mcpServers": {
    "ipip-si": {
      "command": "ssh",
      "args": ["mcp@[2607:8140:212:d2c::]",
               "/opt/ipip/venv/bin/python /opt/ipip/mcp_server.py"]
    }
  }
}
需要 IPv6 网络连 VPS。连上后直接问 AI："查一下 8.8.8.8 是不是 AI 爬虫"。

安全说明：请使用专用低权限账户 mcp（无 sudo），不要用 root。 该账户登录即被强制只运行 MCP server（传任意命令也不会执行），且无 pty、无端口转发。 SSH 为公钥白名单制：把你的 SSH 公钥发给站长加入后即可使用。
← 返回 ipip.si