ipok 0.1.0__tar.gz

ipok-0.1.0/.gitignore

@@ -0,0 +1,19 @@
+# secrets — NEVER commit
+.env
+.env.*
+*.token
+
+# python build
+dist/
+build/
+*.egg-info/
+__pycache__/
+*.pyc
+.venv/
+
+# node
+node_modules/
+*.tgz
+
+# misc
+.DS_Store

ipok-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 IPOK (ipok.io)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ipok-0.1.0/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: ipok
+Version: 0.1.0
+Summary: Terminal IP purity / risk / AI-availability check — powered by ipok.io
+Project-URL: Homepage, https://ipok.io
+Project-URL: Repository, https://github.com/szp2005/ipok-cli
+Author: ipok.io
+License: MIT
+License-File: LICENSE
+Keywords: cli,fraud,geoip,ip,ip-purity,ip-quality,ip-reputation,proxy-detection,risk-score,vpn-detection
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Internet
+Classifier: Topic :: Security
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# IPOK CLI
+
+[![IP risk](https://ipok.io/api/badge?ip=1.1.1.1&label=demo%20IP)](https://ipok.io/?ip=1.1.1.1)
+
+> Terminal IP **purity / risk / AI-availability** check — powered by [ipok.io](https://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](https://ipok.io) 提供数据。
+
+> 🧩 Prefer a browser? Get the **[IPOK Chrome extension](https://chromewebstore.google.com/detail/jnbkfmgldcchpdgnegafakbcnmkdhiai)** — one click to check your current IP's purity. ·
+> 想用浏览器？装 **[IPOK Chrome 插件](https://chromewebstore.google.com/detail/jnbkfmgldcchpdgnegafakbcnmkdhiai)**，一键查当前 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:
+
+```bash
+# 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
+
+```bash
+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
+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
+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:
+
+```bash
+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)
+
+```jsonc
+{
+  "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](./LICENSE). Not affiliated with any provider; data is best-effort and for diagnostics only.

ipok-0.1.0/README.md

@@ -0,0 +1,110 @@
+# IPOK CLI
+
+[![IP risk](https://ipok.io/api/badge?ip=1.1.1.1&label=demo%20IP)](https://ipok.io/?ip=1.1.1.1)
+
+> Terminal IP **purity / risk / AI-availability** check — powered by [ipok.io](https://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](https://ipok.io) 提供数据。
+
+> 🧩 Prefer a browser? Get the **[IPOK Chrome extension](https://chromewebstore.google.com/detail/jnbkfmgldcchpdgnegafakbcnmkdhiai)** — one click to check your current IP's purity. ·
+> 想用浏览器？装 **[IPOK Chrome 插件](https://chromewebstore.google.com/detail/jnbkfmgldcchpdgnegafakbcnmkdhiai)**，一键查当前 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:
+
+```bash
+# 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
+
+```bash
+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
+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
+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:
+
+```bash
+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)
+
+```jsonc
+{
+  "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](./LICENSE). Not affiliated with any provider; data is best-effort and for diagnostics only.

ipok-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "ipok"
+version = "0.1.0"
+description = "Terminal IP purity / risk / AI-availability check — powered by ipok.io"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "ipok.io" }]
+keywords = [
+    "ip", "ip-reputation", "ip-quality", "fraud", "risk-score",
+    "proxy-detection", "vpn-detection", "ip-purity", "geoip", "cli",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Internet",
+    "Topic :: Security",
+    "Topic :: System :: Networking",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://ipok.io"
+Repository = "https://github.com/szp2005/ipok-cli"
+
+[project.scripts]
+ipok = "ipok.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ipok"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/ipok", "README.md", "LICENSE"]

ipok-0.1.0/src/ipok/__init__.py

@@ -0,0 +1,3 @@
+from .cli import __version__, main
+
+__all__ = ["__version__", "main"]

ipok-0.1.0/src/ipok/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

ipok-0.1.0/src/ipok/cli.py

@@ -0,0 +1,167 @@
+"""IPOK CLI — terminal IP purity / risk / AI-availability check.
+
+Powered by https://ipok.io  (free, no-auth API). Zero third-party deps.
+"""
+from __future__ import annotations
+
+import json
+import os
+import sys
+import urllib.error
+import urllib.parse
+import urllib.request
+
+__version__ = "0.1.0"
+
+API_DEFAULT = "https://ipok.io"
+TIMEOUT = 25
+
+# ---- ANSI helpers -----------------------------------------------------------
+_NO_COLOR = bool(os.environ.get("NO_COLOR")) or not sys.stdout.isatty()
+
+
+class C:
+    R = "" if _NO_COLOR else "\033[0m"
+    DIM = "" if _NO_COLOR else "\033[2m"
+    B = "" if _NO_COLOR else "\033[1m"
+    GREEN = "" if _NO_COLOR else "\033[32m"
+    YEL = "" if _NO_COLOR else "\033[33m"
+    RED = "" if _NO_COLOR else "\033[31m"
+    CYAN = "" if _NO_COLOR else "\033[36m"
+    GRAY = "" if _NO_COLOR else "\033[90m"
+
+
+HELP = f"""IPOK CLI v{__version__} — IP purity / risk / AI-availability check (ipok.io)
+
+USAGE:
+  ipok                 check this machine's egress IP
+  ipok <ip>            check a specific IP (e.g. ipok 1.1.1.1)
+  ipok --json [ip]     print raw JSON from the API
+  ipok -h, --help      show this help
+  ipok -v, --version   show version
+
+ENV:
+  IPOK_API   override API base (default https://ipok.io)
+  NO_COLOR   disable colored output
+
+Data by https://ipok.io — free, no API key required.
+"""
+
+
+def fetch(ip: str | None, api: str) -> dict:
+    url = api.rstrip("/") + "/api/ip"
+    if ip:
+        url += "?" + urllib.parse.urlencode({"ip": ip})
+    req = urllib.request.Request(url, headers={"User-Agent": f"ipok-cli/{__version__}"})
+    with urllib.request.urlopen(req, timeout=TIMEOUT) as resp:  # noqa: S310 (trusted host)
+        return json.load(resp)
+
+
+def _band(risk: int) -> tuple[str, str]:
+    if risk < 15:
+        return C.GREEN, "Pristine"
+    if risk < 50:
+        return C.GREEN, "Clean"
+    if risk < 70:
+        return C.YEL, "Caution"
+    return C.RED, "High risk"
+
+
+def render(d: dict) -> str:
+    g = d.get("geo", {}) or {}
+    risk = int(d.get("risk", 0) or 0)
+    bc, band = _band(risk)
+    out: list[str] = []
+
+    def row(k: str, v: str) -> None:
+        out.append("  " + C.GRAY + k.ljust(14) + C.R + " " + v)
+
+    out.append("")
+    out.append("  " + C.CYAN + "IPOK" + C.R + C.GRAY + "  ip check  " + C.R + C.DIM + "ipok.io" + C.R)
+    out.append("  " + C.GRAY + ("-" * 46) + C.R)
+    row("IP", C.B + str(g.get("ip", "-")) + C.R + C.GRAY + "  IPv" + str(g.get("version", "?")) + C.R)
+    loc = " / ".join([x for x in [g.get("country"), g.get("city")] if x]) or "-"
+    row("Location", loc)
+    row("ASN", str(g.get("asn", "-")) + "  " + str(g.get("asName") or g.get("isp") or ""))
+    row("Type", str(d.get("ipType", "-")) + C.GRAY + "   native: " + str(d.get("nativeType", "-")) + C.R)
+    row("Risk", bc + str(risk) + "/100  " + band + C.R)
+
+    sig = d.get("signals") or []
+    if sig:
+        row("Signals", C.YEL + ", ".join(map(str, sig)) + C.R)
+
+    svc = d.get("services") or []
+    if svc:
+        parts = []
+        for s in svc:
+            st = s.get("status")
+            mark = (
+                C.GREEN + "OK" + C.R if st == "available"
+                else (C.RED + "NO" + C.R if st == "blocked" else C.GRAY + "?" + C.R)
+            )
+            parts.append(str(s.get("name")) + ":" + mark)
+        row("AI", "  ".join(parts))
+
+    sc = d.get("scenarios") or []
+    if sc:
+        parts = []
+        for s in sc[:6]:
+            stars = "*" * int(s.get("stars", 0) or 0)
+            parts.append(str(s.get("key")) + " " + C.YEL + stars.ljust(5) + C.R)
+        row("Use-case", "  ".join(parts))
+
+    srcs = [s for s in (d.get("sources") or []) if s.get("ok")]
+    if srcs:
+        row("Sources", C.DIM + ", ".join(
+            str(s.get("source")) + "=" + str(s.get("risk", "-")) for s in srcs) + C.R)
+
+    out.append("  " + C.GRAY + ("-" * 46) + C.R)
+    ipv = g.get("ip", "")
+    link = ("https://ipok.io/?ip=" + str(ipv)) if ipv else "https://ipok.io"
+    out.append("  " + C.CYAN + "full report:  " + link + C.R)
+    out.append("")
+    return "\n".join(out)
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = list(sys.argv[1:] if argv is None else argv)
+    as_json = False
+    ip: str | None = None
+
+    for a in args:
+        if a in ("-h", "--help"):
+            print(HELP)
+            return 0
+        if a in ("-v", "--version"):
+            print(f"ipok {__version__}")
+            return 0
+        if a == "--json":
+            as_json = True
+        elif a.startswith("-"):
+            sys.stderr.write(f"ipok: unknown option {a}\n")
+            return 2
+        else:
+            ip = a
+
+    api = os.environ.get("IPOK_API", API_DEFAULT)
+    try:
+        data = fetch(ip, api)
+    except urllib.error.HTTPError as e:
+        sys.stderr.write(f"IPOK: request failed (HTTP {e.code})\n")
+        return 1
+    except (urllib.error.URLError, TimeoutError) as e:
+        sys.stderr.write(f"IPOK: request failed ({e})\n")
+        return 1
+    except Exception as e:  # noqa: BLE001
+        sys.stderr.write(f"IPOK: {e}\n")
+        return 1
+
+    if as_json:
+        print(json.dumps(data, ensure_ascii=False, indent=2))
+    else:
+        print(render(data))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())