surfaceapi 0.1.0__tar.gz

surfaceapi-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Canada Site Ops
+
+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.

surfaceapi-0.1.0/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: surfaceapi
+Version: 0.1.0
+Summary: Tiny client for Surface: usage-priced infrastructure for machine traffic (preflight, hop, pixel, inspect, MCP).
+Author-email: Surface / Canada Site Ops <canada.site.ops@gmail.com>
+License: MIT
+Project-URL: Homepage, https://nova-otter-delta-cloud.grok.me
+Project-URL: Source, https://github.com/Surface-ops/surface
+Keywords: surface,mcp,agents,preflight,link-check,api
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Surface clients
+
+[![Surface](https://nova-otter-delta-cloud.grok.me/badge/surface.svg)](https://nova-otter-delta-cloud.grok.me)
+
+Tiny clients for [Surface](https://nova-otter-delta-cloud.grok.me): usage-priced infrastructure for machine traffic (preflight, hop, pixel, inspect, MCP, badge). First 1M requests/month free.
+
+- JavaScript: `npm install surfaceapi` ([clients/js](js))
+- Python: `pip install surfaceapi` ([clients/python](python))
+
+## MCP
+Add Surface to any MCP client:
+```json
+{ "mcpServers": { "surface": { "url": "https://nova-otter-delta-cloud.grok.me/mcp" } } }
+```
+
+## Python
+```python
+from surfaceapi import Surface
+key = Surface().create_key().get("key")   # free key
+s = Surface(api_key=key)
+print(s.preflight("https://example.com"))
+print(s.inspect())
+```

surfaceapi-0.1.0/README.md

@@ -0,0 +1,23 @@
+# Surface clients
+
+[![Surface](https://nova-otter-delta-cloud.grok.me/badge/surface.svg)](https://nova-otter-delta-cloud.grok.me)
+
+Tiny clients for [Surface](https://nova-otter-delta-cloud.grok.me): usage-priced infrastructure for machine traffic (preflight, hop, pixel, inspect, MCP, badge). First 1M requests/month free.
+
+- JavaScript: `npm install surfaceapi` ([clients/js](js))
+- Python: `pip install surfaceapi` ([clients/python](python))
+
+## MCP
+Add Surface to any MCP client:
+```json
+{ "mcpServers": { "surface": { "url": "https://nova-otter-delta-cloud.grok.me/mcp" } } }
+```
+
+## Python
+```python
+from surfaceapi import Surface
+key = Surface().create_key().get("key")   # free key
+s = Surface(api_key=key)
+print(s.preflight("https://example.com"))
+print(s.inspect())
+```

surfaceapi-0.1.0/pyproject.toml

@@ -0,0 +1,15 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+[project]
+name = "surfaceapi"
+version = "0.1.0"
+description = "Tiny client for Surface: usage-priced infrastructure for machine traffic (preflight, hop, pixel, inspect, MCP)."
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [{name = "Surface / Canada Site Ops", email = "canada.site.ops@gmail.com"}]
+keywords = ["surface", "mcp", "agents", "preflight", "link-check", "api"]
+[project.urls]
+Homepage = "https://nova-otter-delta-cloud.grok.me"
+Source = "https://github.com/Surface-ops/surface"

surfaceapi-0.1.0/setup.cfg

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

surfaceapi-0.1.0/surfaceapi/__init__.py

@@ -0,0 +1,43 @@
+"""Tiny client for Surface (https://nova-otter-delta-cloud.grok.me)."""
+import json, urllib.request, urllib.error
+__version__ = "0.1.0"
+DEFAULT_BASE = "https://nova-otter-delta-cloud.grok.me"
+
+class _NoRedirect(urllib.request.HTTPRedirectHandler):
+    def redirect_request(self, *a, **k): return None
+
+class SurfaceError(Exception):
+    def __init__(self, status, data): super().__init__(f"Surface {status}"); self.status, self.data = status, data
+
+class Surface:
+    def __init__(self, api_key=None, base_url=DEFAULT_BASE, headers=None):
+        self.api_key, self.base_url, self.headers = api_key, base_url.rstrip("/"), headers or {}
+    def _req(self, method, path, body=None):
+        h = {"User-Agent": f"surfaceapi-py/{__version__}", **self.headers}
+        if self.api_key: h["Authorization"] = "Bearer " + self.api_key
+        data = None
+        if body is not None: data = json.dumps(body).encode(); h["Content-Type"] = "application/json"
+        req = urllib.request.Request(self.base_url + path, data=data, headers=h, method=method)
+        opener = urllib.request.build_opener(_NoRedirect)
+        try: r = opener.open(req, timeout=30); status, hdrs, raw = r.status, r.headers, r.read()
+        except urllib.error.HTTPError as e:
+            status, hdrs, raw = e.code, e.headers, e.read()
+            if status >= 400:
+                try: d = json.loads(raw)
+                except Exception: d = raw.decode(errors="replace")
+                raise SurfaceError(status, d)
+        try: d = json.loads(raw)
+        except Exception: d = raw.decode(errors="replace")
+        return status, hdrs, d
+    def create_key(self, **opts):
+        """Get a free API key (first 1M requests/month free)."""
+        return self._req("POST", "/v1/keys", opts)[2]
+    def preflight(self, url): return self._req("POST", "/v1/preflight", {"url": url})[2]
+    def inspect(self): return self._req("GET", "/v1/inspect")[2]
+    def hop(self, code):
+        s, h, _ = self._req("GET", "/h/" + urllib.parse.quote(code)); return {"status": s, "location": h.get("Location")}
+    def pixel_url(self, code): return f"{self.base_url}/px/{urllib.parse.quote(code)}"
+    def usage(self): return self._req("GET", "/v1/usage")[2]
+
+import urllib.parse  # noqa: E402
+__all__ = ["Surface", "SurfaceError", "DEFAULT_BASE"]

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

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: surfaceapi
+Version: 0.1.0
+Summary: Tiny client for Surface: usage-priced infrastructure for machine traffic (preflight, hop, pixel, inspect, MCP).
+Author-email: Surface / Canada Site Ops <canada.site.ops@gmail.com>
+License: MIT
+Project-URL: Homepage, https://nova-otter-delta-cloud.grok.me
+Project-URL: Source, https://github.com/Surface-ops/surface
+Keywords: surface,mcp,agents,preflight,link-check,api
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Surface clients
+
+[![Surface](https://nova-otter-delta-cloud.grok.me/badge/surface.svg)](https://nova-otter-delta-cloud.grok.me)
+
+Tiny clients for [Surface](https://nova-otter-delta-cloud.grok.me): usage-priced infrastructure for machine traffic (preflight, hop, pixel, inspect, MCP, badge). First 1M requests/month free.
+
+- JavaScript: `npm install surfaceapi` ([clients/js](js))
+- Python: `pip install surfaceapi` ([clients/python](python))
+
+## MCP
+Add Surface to any MCP client:
+```json
+{ "mcpServers": { "surface": { "url": "https://nova-otter-delta-cloud.grok.me/mcp" } } }
+```
+
+## Python
+```python
+from surfaceapi import Surface
+key = Surface().create_key().get("key")   # free key
+s = Surface(api_key=key)
+print(s.preflight("https://example.com"))
+print(s.inspect())
+```

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

@@ -0,0 +1,8 @@
+LICENSE
+README.md
+pyproject.toml
+surfaceapi/__init__.py
+surfaceapi.egg-info/PKG-INFO
+surfaceapi.egg-info/SOURCES.txt
+surfaceapi.egg-info/dependency_links.txt
+surfaceapi.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+surfaceapi