API 与 MCP
给程序和 AI Agent 用的接口。免费,不需要信用卡;请注明数据来自 ipjudge.org。不带 key(少量使用)
curl ipjudge.org/api/ip/8.8.8.8
返回 JSON。每个访客 10 分钟内最多 40 次新查询,已经查过的 IP 不计入。纯文本版:curl ipjudge.org/ip/8.8.8.8。
带 API key
curl -H "Authorization: Bearer ipj_你的key" https://ipjudge.org/api/v1/ip/8.8.8.8
在 我的账户 → API 生成 key(需要登录)。免费版每天 20 个不同 IP,同一个 IP 重复查不限次数。key 无效返回 401,超出当日额度返回 429。
主要字段:kind(res / isp / mobile / biz / dc / proxy / unknown)、score(0–100)、grade、native、country_code、asn、hits、relay(iCloud 专用代理)、platforms(ChatGPT / Claude / Gemini / Muse 各自的 level 和说明)、scenes、evidence。判定规则见 判定方法。
MCP(给 AI Agent)
地址:https://ipjudge.org/mcp(Streamable HTTP)。在 Claude Code 里一行加上:
claude mcp add --transport http ipjudge https://ipjudge.org/mcp
之后可以直接问「我这台机器的出口能用 Claude 吗」。工具:
my_exit:Agent 所在机器的出口判定(跑在服务器、终端里的 Agent 最需要这个)check_ip:查任意 IPai_availability:某个国家 / 地区 ChatGPT、Claude、Gemini、Muse 是否官方支持service_status:Claude、OpenAI 等官方服务状态
不带 key 按上面的访客限额;带 key 加 --header "Authorization: Bearer ipj_你的key",按 key 的额度计。
命令行脚本
curl -sL ipjudge.org/cc | bash(Claude Code / Codex 终端出口)· bash <(curl -Ls ipjudge.org/sh)(服务器体检)。见 命令行。
使用约定
- 展示结果时请注明「数据来自 ipjudge.org」并链接回来。
- 不要用于批量扫描;需要更大额度请联系我们(见 关于)。