ipjudge 0.1.0__tar.gz

ipjudge-0.1.0/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: ipjudge
+Version: 0.1.0
+Summary: Check whether an IP is residential, datacenter or proxy, and whether ChatGPT / Claude / Gemini / Muse support its region.
+Author-email: IP Judge <hi@ipjudge.org>
+License-Expression: MIT
+Project-URL: Homepage, https://ipjudge.org
+Project-URL: Documentation, https://ipjudge.org/tools/api/
+Project-URL: Repository, https://github.com/ipjudge/ipjudge
+Keywords: ip,residential-ip,datacenter,chatgpt,claude,gemini,muse,network
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Internet
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# ipjudge
+
+Check whether an IP is **residential, datacenter or proxy**, and whether
+**ChatGPT / Claude / Gemini / Meta Muse** officially support its region — from the terminal.
+
+```bash
+pip install ipjudge
+ipjudge 8.8.8.8
+```
+
+```
+8.8.8.8  机房 IP  score 75 (B)  美国
+  Muse     bad  地区已开放，但机房 IP 注册 Muse 常被拒（进等候名单）
+  Claude   warn 地区可用；机房 IP 能用，但更容易被要求验证、触发风控
+  ChatGPT  warn 地区可用；机房 IP 能用，但更容易被要求验证、触发风控
+  Gemini   warn 地区可用；机房 IP 能用，但更容易被要求验证、触发风控
+  Gemini API good 地区在 Google 公布的 Gemini API / AI Studio 可用名单里（这份名单和网页版分开）
+  detail: https://ipjudge.org/ip/8.8.8.8
+```
+
+## What it answers
+
+- Is this IP **residential / ISP / mobile / datacenter / proxy**?
+- Is it **native** to its country or announced elsewhere (broadcast)?
+- Would **ChatGPT, Claude, Gemini or Muse** accept it — by official region list and IP type?
+- A **purity score (0–100)** with the deductions listed.
+
+Useful when you are about to sign up for an AI account, run an agent, or debug why
+"the site opens but the account gets flagged".
+
+## How it works
+
+It calls the free public API at <https://ipjudge.org/api/ip/{ip}> — **no key required**,
+no data stored about you. Same data source as the website. JSON only, one argument.
+
+For bulk use, a key raises the quota: <https://ipjudge.org/tools/api/>
+
+## MCP
+
+If you are wiring this into an AI agent instead of a shell, the same checks are exposed as
+an MCP server: `https://ipjudge.org/mcp` (Streamable HTTP, no auth for light use).
+
+```bash
+claude mcp add --transport http ipjudge https://ipjudge.org/mcp
+```
+
+## Limits
+
+- Rate limited per visitor (40 new lookups / 10 min without a key).
+- Judgements follow each platform's **officially published** region lists; they are not a
+  guarantee that an account will or will not be flagged.
+- Not affiliated with OpenAI, Anthropic, Google or Meta.
+
+## License
+
+MIT

ipjudge-0.1.0/README.md

@@ -0,0 +1,56 @@
+# ipjudge
+
+Check whether an IP is **residential, datacenter or proxy**, and whether
+**ChatGPT / Claude / Gemini / Meta Muse** officially support its region — from the terminal.
+
+```bash
+pip install ipjudge
+ipjudge 8.8.8.8
+```
+
+```
+8.8.8.8  机房 IP  score 75 (B)  美国
+  Muse     bad  地区已开放，但机房 IP 注册 Muse 常被拒（进等候名单）
+  Claude   warn 地区可用；机房 IP 能用，但更容易被要求验证、触发风控
+  ChatGPT  warn 地区可用；机房 IP 能用，但更容易被要求验证、触发风控
+  Gemini   warn 地区可用；机房 IP 能用，但更容易被要求验证、触发风控
+  Gemini API good 地区在 Google 公布的 Gemini API / AI Studio 可用名单里（这份名单和网页版分开）
+  detail: https://ipjudge.org/ip/8.8.8.8
+```
+
+## What it answers
+
+- Is this IP **residential / ISP / mobile / datacenter / proxy**?
+- Is it **native** to its country or announced elsewhere (broadcast)?
+- Would **ChatGPT, Claude, Gemini or Muse** accept it — by official region list and IP type?
+- A **purity score (0–100)** with the deductions listed.
+
+Useful when you are about to sign up for an AI account, run an agent, or debug why
+"the site opens but the account gets flagged".
+
+## How it works
+
+It calls the free public API at <https://ipjudge.org/api/ip/{ip}> — **no key required**,
+no data stored about you. Same data source as the website. JSON only, one argument.
+
+For bulk use, a key raises the quota: <https://ipjudge.org/tools/api/>
+
+## MCP
+
+If you are wiring this into an AI agent instead of a shell, the same checks are exposed as
+an MCP server: `https://ipjudge.org/mcp` (Streamable HTTP, no auth for light use).
+
+```bash
+claude mcp add --transport http ipjudge https://ipjudge.org/mcp
+```
+
+## Limits
+
+- Rate limited per visitor (40 new lookups / 10 min without a key).
+- Judgements follow each platform's **officially published** region lists; they are not a
+  guarantee that an account will or will not be flagged.
+- Not affiliated with OpenAI, Anthropic, Google or Meta.
+
+## License
+
+MIT

ipjudge-0.1.0/ipjudge/__init__.py

@@ -0,0 +1,5 @@
+"""ipjudge — IP 出口检测（住宅 / 机房 / 代理 + 平台可用性）。
+
+数据来自 https://ipjudge.org 的公开 API，免费、无需 key。
+"""
+__version__ = "0.1.0"

ipjudge-0.1.0/ipjudge/cli.py

@@ -0,0 +1,42 @@
+"""命令行入口：ipjudge <ip>"""
+import json
+import sys
+import urllib.error
+import urllib.request
+
+API = "https://ipjudge.org/api/ip/"
+
+
+def lookup(ip: str) -> dict:
+    req = urllib.request.Request(API + ip, headers={"User-Agent": "ipjudge-cli/0.1"})
+    with urllib.request.urlopen(req, timeout=20) as r:
+        return json.load(r)
+
+
+def main() -> int:
+    if len(sys.argv) != 2 or sys.argv[1] in ("-h", "--help"):
+        print("usage: ipjudge <ip>\n\nexample: ipjudge 8.8.8.8", file=sys.stderr)
+        return 2
+    ip = sys.argv[1]
+    try:
+        d = lookup(ip)
+    except urllib.error.HTTPError as e:
+        print(f"error: HTTP {e.code} for {ip}", file=sys.stderr)
+        return 1
+    except Exception as e:                                     # noqa: BLE001
+        print(f"error: {type(e).__name__}: {e}", file=sys.stderr)
+        return 1
+
+    print(f"{d.get('ip')}  {d.get('kind_label') or d.get('kind')}  "
+          f"score {d.get('score')} ({d.get('grade')})  {d.get('country') or d.get('country_code')}")
+    if d.get("native") is not None:
+        print(f"  native: {d.get('native')}")
+    for p in d.get("platforms") or []:
+        if isinstance(p, dict):
+            print(f"  {str(p.get('name', '')):8} {p.get('level', '?')}  {p.get('text', '')}".rstrip())
+    print(f"  detail: https://ipjudge.org/ip/{d.get('ip')}")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

ipjudge-0.1.0/ipjudge.egg-info/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: ipjudge
+Version: 0.1.0
+Summary: Check whether an IP is residential, datacenter or proxy, and whether ChatGPT / Claude / Gemini / Muse support its region.
+Author-email: IP Judge <hi@ipjudge.org>
+License-Expression: MIT
+Project-URL: Homepage, https://ipjudge.org
+Project-URL: Documentation, https://ipjudge.org/tools/api/
+Project-URL: Repository, https://github.com/ipjudge/ipjudge
+Keywords: ip,residential-ip,datacenter,chatgpt,claude,gemini,muse,network
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Internet
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# ipjudge
+
+Check whether an IP is **residential, datacenter or proxy**, and whether
+**ChatGPT / Claude / Gemini / Meta Muse** officially support its region — from the terminal.
+
+```bash
+pip install ipjudge
+ipjudge 8.8.8.8
+```
+
+```
+8.8.8.8  机房 IP  score 75 (B)  美国
+  Muse     bad  地区已开放，但机房 IP 注册 Muse 常被拒（进等候名单）
+  Claude   warn 地区可用；机房 IP 能用，但更容易被要求验证、触发风控
+  ChatGPT  warn 地区可用；机房 IP 能用，但更容易被要求验证、触发风控
+  Gemini   warn 地区可用；机房 IP 能用，但更容易被要求验证、触发风控
+  Gemini API good 地区在 Google 公布的 Gemini API / AI Studio 可用名单里（这份名单和网页版分开）
+  detail: https://ipjudge.org/ip/8.8.8.8
+```
+
+## What it answers
+
+- Is this IP **residential / ISP / mobile / datacenter / proxy**?
+- Is it **native** to its country or announced elsewhere (broadcast)?
+- Would **ChatGPT, Claude, Gemini or Muse** accept it — by official region list and IP type?
+- A **purity score (0–100)** with the deductions listed.
+
+Useful when you are about to sign up for an AI account, run an agent, or debug why
+"the site opens but the account gets flagged".
+
+## How it works
+
+It calls the free public API at <https://ipjudge.org/api/ip/{ip}> — **no key required**,
+no data stored about you. Same data source as the website. JSON only, one argument.
+
+For bulk use, a key raises the quota: <https://ipjudge.org/tools/api/>
+
+## MCP
+
+If you are wiring this into an AI agent instead of a shell, the same checks are exposed as
+an MCP server: `https://ipjudge.org/mcp` (Streamable HTTP, no auth for light use).
+
+```bash
+claude mcp add --transport http ipjudge https://ipjudge.org/mcp
+```
+
+## Limits
+
+- Rate limited per visitor (40 new lookups / 10 min without a key).
+- Judgements follow each platform's **officially published** region lists; they are not a
+  guarantee that an account will or will not be flagged.
+- Not affiliated with OpenAI, Anthropic, Google or Meta.
+
+## License
+
+MIT

ipjudge-0.1.0/ipjudge.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+ipjudge/__init__.py
+ipjudge/cli.py
+ipjudge.egg-info/PKG-INFO
+ipjudge.egg-info/SOURCES.txt
+ipjudge.egg-info/dependency_links.txt
+ipjudge.egg-info/entry_points.txt
+ipjudge.egg-info/top_level.txt

ipjudge-0.1.0/ipjudge.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ipjudge-0.1.0/ipjudge.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ipjudge = ipjudge.cli:main

ipjudge-0.1.0/ipjudge.egg-info/top_level.txt

@@ -0,0 +1 @@
+ipjudge

ipjudge-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ipjudge"
+version = "0.1.0"
+description = "Check whether an IP is residential, datacenter or proxy, and whether ChatGPT / Claude / Gemini / Muse support its region."
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+authors = [{ name = "IP Judge", email = "hi@ipjudge.org" }]
+keywords = ["ip", "residential-ip", "datacenter", "chatgpt", "claude", "gemini", "muse", "network"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Operating System :: OS Independent",
+  "Topic :: Internet",
+  "Topic :: System :: Networking",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://ipjudge.org"
+Documentation = "https://ipjudge.org/tools/api/"
+Repository = "https://github.com/ipjudge/ipjudge"
+
+[project.scripts]
+ipjudge = "ipjudge.cli:main"

ipjudge-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+