IPOK CLI

Terminal IP purity / risk / AI-availability check — powered by ipok.io

Check any IP's quality from your VPS or terminal in one line: risk score, residential vs datacenter, native IP, whether it can use ChatGPT / Claude / Gemini, use-case fit for TikTok / e-commerce / social / AI, and more.

一行命令测 IP 纯净度 / 风险值 / 能不能用 AI —— 由 ipok.io 提供数据。

🧩 Prefer a browser? Get the IPOK Chrome extension — one click to check your current IP's purity. · 想用浏览器？装 IPOK Chrome 插件，一键查当前 IP 纯净度。

  IPOK  ip check  ipok.io
  ----------------------------------------------
  IP             1.1.1.1  IPv4
  Location       Australia / South Brisbane
  ASN            AS13335  CLOUDFLARENET
  Type           business   native: broadcast
  Risk           11/100  Pristine
  Signals        hosting
  AI             ChatGPT:OK  Claude:OK  Gemini:OK
  Use-case       tiktok **     ecommerce **     social **     ai *****
  Sources        ip-api=55, Scamalytics=0, proxycheck=0, AbuseIPDB=0, ipapi.is=30, StopForumSpam=0
  ----------------------------------------------
  full report:  https://ipok.io/?ip=1.1.1.1

Install

Pick whichever fits your stack — all give you the same ipok command:

# Node (no install, run once)
npx ipok-cli                 # check this machine's egress IP
npx ipok-cli 1.1.1.1         # check a specific IP

# Python
pip install ipok             # then:  ipok  /  ipok 1.1.1.1
pipx run ipok 1.1.1.1        # zero-install one-off

# Homebrew (macOS / Linux)
brew install szp2005/ipok/ipok

Usage

ipok                 # check this machine's egress IP
ipok 1.1.1.1         # check a specific IP
ipok --json 1.1.1.1  # raw JSON
ipok --help

Set IPOK_API to point at a self-hosted endpoint; set NO_COLOR=1 to disable colors.

No-install one-liner (servers / CI)

Just curl + python3, nothing to install — ideal on a bare VPS:

bash <(curl -sL https://raw.githubusercontent.com/szp2005/ipok-cli/main/ipok.sh)          # this server's IP
bash <(curl -sL https://raw.githubusercontent.com/szp2005/ipok-cli/main/ipok.sh) 1.1.1.1   # a specific IP

Streaming / AI unlock (run on the server)

Test what this server's exit IP can unlock — Netflix (full / originals-only / blocked + region), ChatGPT region support, YouTube Premium, TikTok:

bash <(curl -sL https://raw.githubusercontent.com/szp2005/ipok-cli/main/media.sh)

Results reflect the server's outbound IP (the proxy/VPS use-case). Streaming providers change endpoints often, so treat results as best-effort.

Why

Most IP-purity tools give a single black-box score. IPOK aggregates multiple risk sources and shows why an IP is flagged, plus AI-service availability and use-case fit — the stuff that actually matters for proxies, cross-border, and AI accounts.

Free API (no auth, CORS-enabled)

The CLI just calls IPOK's public API. You can too:

curl "https://ipok.io/api/ip?ip=1.1.1.1"            # full IP report (JSON)
curl "https://ipok.io/api/bgp?asn=AS13335&ip=1.1.1.1"  # BGP upstreams/downstreams (RIPEstat)
curl "https://ipok.io/api/reverse-ip?ip=1.1.1.1"    # domains hosted on the IP

Docs: https://ipok.io/developers

Response shape (/api/ip, excerpt)

{
  "geo":   { "ip", "version", "country", "city", "asn", "asName", "isp", "lat", "lon" },
  "ipType": "residential | hosting | mobile",
  "risk": 0,
  "nativeType": "native | broadcast | unknown",
  "scenarios": [{ "key": "tiktok", "stars": 3, "verdict": "try" }],
  "services":  [{ "key": "chatgpt", "status": "available" }],
  "sources":   [{ "source": "ip-api", "risk": 10, "flags": {} }],
  "rdap":      { "registry", "country", "registered", "org" }
}

License

MIT — see LICENSE. Not affiliated with any provider; data is best-effort and for diagnostics only.