surfaceapi 0.1.0__tar.gz → 0.1.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,76 @@
1
+ Metadata-Version: 2.4
2
+ Name: surfaceapi
3
+ Version: 0.1.2
4
+ Summary: Surface checks a short link before your agent opens it. The answer is fetch or skip. It never returns the page. Free for the first million requests a month.
5
+ Author-email: Surface / Canada Site Ops <canada.site.ops@gmail.com>
6
+ License: MIT
7
+ Project-URL: Homepage, https://nova-otter-delta-cloud.grok.me
8
+ Project-URL: Documentation, https://nova-otter-delta-cloud.grok.me/docs
9
+ Keywords: surface,short-link,unwrap,link-check,preflight,mcp,agents
10
+ Requires-Python: >=3.8
11
+ Description-Content-Type: text/markdown
12
+ License-File: LICENSE
13
+ Dynamic: license-file
14
+
15
+ # Surface
16
+
17
+ Surface checks a short link before your agent opens it. The answer is fetch or skip. It never returns the page. A hop or a 1×1 pixel counts the same way, with no install. Free for the first million requests a month. https://nova-otter-delta-cloud.grok.me
18
+
19
+ Surface by Canada Site Ops. Ontario, Canada.
20
+
21
+ ## Get a free API key in about 10 seconds
22
+
23
+ No email, no card. Then set it on every call as `Authorization: Bearer <key>` or `X-Surface-Key: <key>`.
24
+
25
+ ```bash
26
+ curl -s -X POST https://nova-otter-delta-cloud.grok.me/v1/keys
27
+ # returns {"key","created_at","free_monthly":1000000,"usage_url"}
28
+ export SURFACE_API_KEY=... # paste the key value
29
+ ```
30
+
31
+ A key gets its own million free requests a month. Anonymous calls still work on a shared demo limit.
32
+
33
+ ## One install for Cursor or Claude (MCP)
34
+
35
+ Tool: `preflight_url`. Mint a key first, then paste this into your MCP settings:
36
+
37
+ ```json
38
+ {
39
+ "mcpServers": {
40
+ "surface": {
41
+ "type": "http",
42
+ "url": "https://nova-otter-delta-cloud.grok.me/mcp",
43
+ "headers": {
44
+ "Authorization": "Bearer REPLACE_WITH_YOUR_KEY"
45
+ }
46
+ }
47
+ }
48
+ }
49
+ ```
50
+
51
+ ## Python
52
+
53
+ `pip install surfaceapi`
54
+
55
+ ```python
56
+ from surfaceapi import Surface
57
+ key = Surface().create_key().get("key") # free key in ~10 seconds
58
+ s = Surface(api_key=key)
59
+ print(s.preflight("https://youtu.be/jNQXAC9IVRw")) # next: fetch or skip
60
+ print(s.inspect())
61
+ ```
62
+
63
+ Or set `SURFACE_API_KEY` after the curl above.
64
+
65
+ JavaScript: `npm install @surfaceapi/surface`
66
+
67
+ ## Also listed
68
+
69
+ - Official MCP Registry: `me.grok.nova-otter-delta-cloud/surface`
70
+ - https://smithery.ai/servers/canada-site-ops/surface
71
+ - https://www.curatedmcp.com/marketplace/surface
72
+ - https://www.npmjs.com/package/@surfaceapi/surface
73
+ - https://pypi.org/project/surfaceapi/
74
+ - https://huggingface.co/spaces/surfaceapi/surface-preflight
75
+
76
+ MCP at `/mcp` (tool `preflight_url`). CLI and GitHub Action are coming soon.
@@ -0,0 +1,62 @@
1
+ # Surface
2
+
3
+ Surface checks a short link before your agent opens it. The answer is fetch or skip. It never returns the page. A hop or a 1×1 pixel counts the same way, with no install. Free for the first million requests a month. https://nova-otter-delta-cloud.grok.me
4
+
5
+ Surface by Canada Site Ops. Ontario, Canada.
6
+
7
+ ## Get a free API key in about 10 seconds
8
+
9
+ No email, no card. Then set it on every call as `Authorization: Bearer <key>` or `X-Surface-Key: <key>`.
10
+
11
+ ```bash
12
+ curl -s -X POST https://nova-otter-delta-cloud.grok.me/v1/keys
13
+ # returns {"key","created_at","free_monthly":1000000,"usage_url"}
14
+ export SURFACE_API_KEY=... # paste the key value
15
+ ```
16
+
17
+ A key gets its own million free requests a month. Anonymous calls still work on a shared demo limit.
18
+
19
+ ## One install for Cursor or Claude (MCP)
20
+
21
+ Tool: `preflight_url`. Mint a key first, then paste this into your MCP settings:
22
+
23
+ ```json
24
+ {
25
+ "mcpServers": {
26
+ "surface": {
27
+ "type": "http",
28
+ "url": "https://nova-otter-delta-cloud.grok.me/mcp",
29
+ "headers": {
30
+ "Authorization": "Bearer REPLACE_WITH_YOUR_KEY"
31
+ }
32
+ }
33
+ }
34
+ }
35
+ ```
36
+
37
+ ## Python
38
+
39
+ `pip install surfaceapi`
40
+
41
+ ```python
42
+ from surfaceapi import Surface
43
+ key = Surface().create_key().get("key") # free key in ~10 seconds
44
+ s = Surface(api_key=key)
45
+ print(s.preflight("https://youtu.be/jNQXAC9IVRw")) # next: fetch or skip
46
+ print(s.inspect())
47
+ ```
48
+
49
+ Or set `SURFACE_API_KEY` after the curl above.
50
+
51
+ JavaScript: `npm install @surfaceapi/surface`
52
+
53
+ ## Also listed
54
+
55
+ - Official MCP Registry: `me.grok.nova-otter-delta-cloud/surface`
56
+ - https://smithery.ai/servers/canada-site-ops/surface
57
+ - https://www.curatedmcp.com/marketplace/surface
58
+ - https://www.npmjs.com/package/@surfaceapi/surface
59
+ - https://pypi.org/project/surfaceapi/
60
+ - https://huggingface.co/spaces/surfaceapi/surface-preflight
61
+
62
+ MCP at `/mcp` (tool `preflight_url`). CLI and GitHub Action are coming soon.
@@ -0,0 +1,15 @@
1
+ [build-system]
2
+ requires = ["setuptools>=61"]
3
+ build-backend = "setuptools.build_meta"
4
+ [project]
5
+ name = "surfaceapi"
6
+ version = "0.1.2"
7
+ description = "Surface checks a short link before your agent opens it. The answer is fetch or skip. It never returns the page. Free for the first million requests a month."
8
+ readme = "README.md"
9
+ requires-python = ">=3.8"
10
+ license = {text = "MIT"}
11
+ authors = [{name = "Surface / Canada Site Ops", email = "canada.site.ops@gmail.com"}]
12
+ keywords = ["surface", "short-link", "unwrap", "link-check", "preflight", "mcp", "agents"]
13
+ [project.urls]
14
+ Homepage = "https://nova-otter-delta-cloud.grok.me"
15
+ Documentation = "https://nova-otter-delta-cloud.grok.me/docs"
@@ -0,0 +1,76 @@
1
+ Metadata-Version: 2.4
2
+ Name: surfaceapi
3
+ Version: 0.1.2
4
+ Summary: Surface checks a short link before your agent opens it. The answer is fetch or skip. It never returns the page. Free for the first million requests a month.
5
+ Author-email: Surface / Canada Site Ops <canada.site.ops@gmail.com>
6
+ License: MIT
7
+ Project-URL: Homepage, https://nova-otter-delta-cloud.grok.me
8
+ Project-URL: Documentation, https://nova-otter-delta-cloud.grok.me/docs
9
+ Keywords: surface,short-link,unwrap,link-check,preflight,mcp,agents
10
+ Requires-Python: >=3.8
11
+ Description-Content-Type: text/markdown
12
+ License-File: LICENSE
13
+ Dynamic: license-file
14
+
15
+ # Surface
16
+
17
+ Surface checks a short link before your agent opens it. The answer is fetch or skip. It never returns the page. A hop or a 1×1 pixel counts the same way, with no install. Free for the first million requests a month. https://nova-otter-delta-cloud.grok.me
18
+
19
+ Surface by Canada Site Ops. Ontario, Canada.
20
+
21
+ ## Get a free API key in about 10 seconds
22
+
23
+ No email, no card. Then set it on every call as `Authorization: Bearer <key>` or `X-Surface-Key: <key>`.
24
+
25
+ ```bash
26
+ curl -s -X POST https://nova-otter-delta-cloud.grok.me/v1/keys
27
+ # returns {"key","created_at","free_monthly":1000000,"usage_url"}
28
+ export SURFACE_API_KEY=... # paste the key value
29
+ ```
30
+
31
+ A key gets its own million free requests a month. Anonymous calls still work on a shared demo limit.
32
+
33
+ ## One install for Cursor or Claude (MCP)
34
+
35
+ Tool: `preflight_url`. Mint a key first, then paste this into your MCP settings:
36
+
37
+ ```json
38
+ {
39
+ "mcpServers": {
40
+ "surface": {
41
+ "type": "http",
42
+ "url": "https://nova-otter-delta-cloud.grok.me/mcp",
43
+ "headers": {
44
+ "Authorization": "Bearer REPLACE_WITH_YOUR_KEY"
45
+ }
46
+ }
47
+ }
48
+ }
49
+ ```
50
+
51
+ ## Python
52
+
53
+ `pip install surfaceapi`
54
+
55
+ ```python
56
+ from surfaceapi import Surface
57
+ key = Surface().create_key().get("key") # free key in ~10 seconds
58
+ s = Surface(api_key=key)
59
+ print(s.preflight("https://youtu.be/jNQXAC9IVRw")) # next: fetch or skip
60
+ print(s.inspect())
61
+ ```
62
+
63
+ Or set `SURFACE_API_KEY` after the curl above.
64
+
65
+ JavaScript: `npm install @surfaceapi/surface`
66
+
67
+ ## Also listed
68
+
69
+ - Official MCP Registry: `me.grok.nova-otter-delta-cloud/surface`
70
+ - https://smithery.ai/servers/canada-site-ops/surface
71
+ - https://www.curatedmcp.com/marketplace/surface
72
+ - https://www.npmjs.com/package/@surfaceapi/surface
73
+ - https://pypi.org/project/surfaceapi/
74
+ - https://huggingface.co/spaces/surfaceapi/surface-preflight
75
+
76
+ MCP at `/mcp` (tool `preflight_url`). CLI and GitHub Action are coming soon.
surfaceapi-0.1.0/PKG-INFO DELETED
@@ -1,37 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: surfaceapi
3
- Version: 0.1.0
4
- Summary: Tiny client for Surface: usage-priced infrastructure for machine traffic (preflight, hop, pixel, inspect, MCP).
5
- Author-email: Surface / Canada Site Ops <canada.site.ops@gmail.com>
6
- License: MIT
7
- Project-URL: Homepage, https://nova-otter-delta-cloud.grok.me
8
- Project-URL: Source, https://github.com/Surface-ops/surface
9
- Keywords: surface,mcp,agents,preflight,link-check,api
10
- Requires-Python: >=3.8
11
- Description-Content-Type: text/markdown
12
- License-File: LICENSE
13
- Dynamic: license-file
14
-
15
- # Surface clients
16
-
17
- [![Surface](https://nova-otter-delta-cloud.grok.me/badge/surface.svg)](https://nova-otter-delta-cloud.grok.me)
18
-
19
- 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.
20
-
21
- - JavaScript: `npm install surfaceapi` ([clients/js](js))
22
- - Python: `pip install surfaceapi` ([clients/python](python))
23
-
24
- ## MCP
25
- Add Surface to any MCP client:
26
- ```json
27
- { "mcpServers": { "surface": { "url": "https://nova-otter-delta-cloud.grok.me/mcp" } } }
28
- ```
29
-
30
- ## Python
31
- ```python
32
- from surfaceapi import Surface
33
- key = Surface().create_key().get("key") # free key
34
- s = Surface(api_key=key)
35
- print(s.preflight("https://example.com"))
36
- print(s.inspect())
37
- ```
@@ -1,23 +0,0 @@
1
- # Surface clients
2
-
3
- [![Surface](https://nova-otter-delta-cloud.grok.me/badge/surface.svg)](https://nova-otter-delta-cloud.grok.me)
4
-
5
- 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.
6
-
7
- - JavaScript: `npm install surfaceapi` ([clients/js](js))
8
- - Python: `pip install surfaceapi` ([clients/python](python))
9
-
10
- ## MCP
11
- Add Surface to any MCP client:
12
- ```json
13
- { "mcpServers": { "surface": { "url": "https://nova-otter-delta-cloud.grok.me/mcp" } } }
14
- ```
15
-
16
- ## Python
17
- ```python
18
- from surfaceapi import Surface
19
- key = Surface().create_key().get("key") # free key
20
- s = Surface(api_key=key)
21
- print(s.preflight("https://example.com"))
22
- print(s.inspect())
23
- ```
@@ -1,15 +0,0 @@
1
- [build-system]
2
- requires = ["setuptools>=61"]
3
- build-backend = "setuptools.build_meta"
4
- [project]
5
- name = "surfaceapi"
6
- version = "0.1.0"
7
- description = "Tiny client for Surface: usage-priced infrastructure for machine traffic (preflight, hop, pixel, inspect, MCP)."
8
- readme = "README.md"
9
- requires-python = ">=3.8"
10
- license = {text = "MIT"}
11
- authors = [{name = "Surface / Canada Site Ops", email = "canada.site.ops@gmail.com"}]
12
- keywords = ["surface", "mcp", "agents", "preflight", "link-check", "api"]
13
- [project.urls]
14
- Homepage = "https://nova-otter-delta-cloud.grok.me"
15
- Source = "https://github.com/Surface-ops/surface"
@@ -1,37 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: surfaceapi
3
- Version: 0.1.0
4
- Summary: Tiny client for Surface: usage-priced infrastructure for machine traffic (preflight, hop, pixel, inspect, MCP).
5
- Author-email: Surface / Canada Site Ops <canada.site.ops@gmail.com>
6
- License: MIT
7
- Project-URL: Homepage, https://nova-otter-delta-cloud.grok.me
8
- Project-URL: Source, https://github.com/Surface-ops/surface
9
- Keywords: surface,mcp,agents,preflight,link-check,api
10
- Requires-Python: >=3.8
11
- Description-Content-Type: text/markdown
12
- License-File: LICENSE
13
- Dynamic: license-file
14
-
15
- # Surface clients
16
-
17
- [![Surface](https://nova-otter-delta-cloud.grok.me/badge/surface.svg)](https://nova-otter-delta-cloud.grok.me)
18
-
19
- 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.
20
-
21
- - JavaScript: `npm install surfaceapi` ([clients/js](js))
22
- - Python: `pip install surfaceapi` ([clients/python](python))
23
-
24
- ## MCP
25
- Add Surface to any MCP client:
26
- ```json
27
- { "mcpServers": { "surface": { "url": "https://nova-otter-delta-cloud.grok.me/mcp" } } }
28
- ```
29
-
30
- ## Python
31
- ```python
32
- from surfaceapi import Surface
33
- key = Surface().create_key().get("key") # free key
34
- s = Surface(api_key=key)
35
- print(s.preflight("https://example.com"))
36
- print(s.inspect())
37
- ```
File without changes
File without changes