surfaceapi 0.1.0__tar.gz → 0.1.1__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,40 @@
1
+ Metadata-Version: 2.4
2
+ Name: surfaceapi
3
+ Version: 0.1.1
4
+ Summary: Check a short link before your agent opens it. Surface client: unwrap t.co/bit.ly/lnkd.in/youtu.be and get fetch or skip. 1M requests/month free.
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,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: check a short link before you open it
16
+
17
+ [![links checked | Surface](https://nova-otter-delta-cloud.grok.me/badge/surface.svg)](https://nova-otter-delta-cloud.grok.me)
18
+
19
+ [Surface](https://nova-otter-delta-cloud.grok.me) follows the hops on t.co, bit.ly, lnkd.in and youtu.be links (or any https URL) and says **fetch** or **skip**. It never returns the page, so it's one quick round trip.
20
+
21
+ Free for the first 1,000,000 requests every month, no card needed. After that: Preflight $0.25, Hop $0.40, Pixel $0.15, Inspect $0.20 per 1,000 requests (USD). Production plan with your own key and meter: $50 CAD/month ([billing](https://nova-otter-delta-cloud.grok.me/billing)).
22
+
23
+ [Get started](https://nova-otter-delta-cloud.grok.me/start) · [Docs](https://nova-otter-delta-cloud.grok.me/docs) · Free API key in 10 seconds: `curl -s -X POST https://nova-otter-delta-cloud.grok.me/v1/keys`
24
+
25
+ ## One install for Cursor or Claude (MCP)
26
+ Paste this into your MCP settings. The agent then calls `preflight_url` before it opens a short link.
27
+ ```json
28
+ { "mcpServers": { "surface": { "type": "http", "url": "https://nova-otter-delta-cloud.grok.me/mcp" } } }
29
+ ```
30
+
31
+ ## Python
32
+ `pip install surfaceapi`
33
+ ```python
34
+ from surfaceapi import Surface
35
+ key = Surface().create_key().get("key") # free key
36
+ s = Surface(api_key=key)
37
+ print(s.preflight("https://youtu.be/jNQXAC9IVRw")) # next: fetch or skip
38
+ print(s.inspect()) # bot, browser, or script
39
+ ```
40
+ JavaScript: `npm install @surfaceapi/surface`
@@ -0,0 +1,26 @@
1
+ # Surface: check a short link before you open it
2
+
3
+ [![links checked | Surface](https://nova-otter-delta-cloud.grok.me/badge/surface.svg)](https://nova-otter-delta-cloud.grok.me)
4
+
5
+ [Surface](https://nova-otter-delta-cloud.grok.me) follows the hops on t.co, bit.ly, lnkd.in and youtu.be links (or any https URL) and says **fetch** or **skip**. It never returns the page, so it's one quick round trip.
6
+
7
+ Free for the first 1,000,000 requests every month, no card needed. After that: Preflight $0.25, Hop $0.40, Pixel $0.15, Inspect $0.20 per 1,000 requests (USD). Production plan with your own key and meter: $50 CAD/month ([billing](https://nova-otter-delta-cloud.grok.me/billing)).
8
+
9
+ [Get started](https://nova-otter-delta-cloud.grok.me/start) · [Docs](https://nova-otter-delta-cloud.grok.me/docs) · Free API key in 10 seconds: `curl -s -X POST https://nova-otter-delta-cloud.grok.me/v1/keys`
10
+
11
+ ## One install for Cursor or Claude (MCP)
12
+ Paste this into your MCP settings. The agent then calls `preflight_url` before it opens a short link.
13
+ ```json
14
+ { "mcpServers": { "surface": { "type": "http", "url": "https://nova-otter-delta-cloud.grok.me/mcp" } } }
15
+ ```
16
+
17
+ ## Python
18
+ `pip install surfaceapi`
19
+ ```python
20
+ from surfaceapi import Surface
21
+ key = Surface().create_key().get("key") # free key
22
+ s = Surface(api_key=key)
23
+ print(s.preflight("https://youtu.be/jNQXAC9IVRw")) # next: fetch or skip
24
+ print(s.inspect()) # bot, browser, or script
25
+ ```
26
+ JavaScript: `npm install @surfaceapi/surface`
@@ -3,13 +3,13 @@ requires = ["setuptools>=61"]
3
3
  build-backend = "setuptools.build_meta"
4
4
  [project]
5
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)."
6
+ version = "0.1.1"
7
+ description = "Check a short link before your agent opens it. Surface client: unwrap t.co/bit.ly/lnkd.in/youtu.be and get fetch or skip. 1M requests/month free."
8
8
  readme = "README.md"
9
9
  requires-python = ">=3.8"
10
10
  license = {text = "MIT"}
11
11
  authors = [{name = "Surface / Canada Site Ops", email = "canada.site.ops@gmail.com"}]
12
- keywords = ["surface", "mcp", "agents", "preflight", "link-check", "api"]
12
+ keywords = ["surface", "short-link", "unwrap", "link-check", "preflight", "mcp", "agents"]
13
13
  [project.urls]
14
14
  Homepage = "https://nova-otter-delta-cloud.grok.me"
15
15
  Source = "https://github.com/Surface-ops/surface"
@@ -0,0 +1,40 @@
1
+ Metadata-Version: 2.4
2
+ Name: surfaceapi
3
+ Version: 0.1.1
4
+ Summary: Check a short link before your agent opens it. Surface client: unwrap t.co/bit.ly/lnkd.in/youtu.be and get fetch or skip. 1M requests/month free.
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,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: check a short link before you open it
16
+
17
+ [![links checked | Surface](https://nova-otter-delta-cloud.grok.me/badge/surface.svg)](https://nova-otter-delta-cloud.grok.me)
18
+
19
+ [Surface](https://nova-otter-delta-cloud.grok.me) follows the hops on t.co, bit.ly, lnkd.in and youtu.be links (or any https URL) and says **fetch** or **skip**. It never returns the page, so it's one quick round trip.
20
+
21
+ Free for the first 1,000,000 requests every month, no card needed. After that: Preflight $0.25, Hop $0.40, Pixel $0.15, Inspect $0.20 per 1,000 requests (USD). Production plan with your own key and meter: $50 CAD/month ([billing](https://nova-otter-delta-cloud.grok.me/billing)).
22
+
23
+ [Get started](https://nova-otter-delta-cloud.grok.me/start) · [Docs](https://nova-otter-delta-cloud.grok.me/docs) · Free API key in 10 seconds: `curl -s -X POST https://nova-otter-delta-cloud.grok.me/v1/keys`
24
+
25
+ ## One install for Cursor or Claude (MCP)
26
+ Paste this into your MCP settings. The agent then calls `preflight_url` before it opens a short link.
27
+ ```json
28
+ { "mcpServers": { "surface": { "type": "http", "url": "https://nova-otter-delta-cloud.grok.me/mcp" } } }
29
+ ```
30
+
31
+ ## Python
32
+ `pip install surfaceapi`
33
+ ```python
34
+ from surfaceapi import Surface
35
+ key = Surface().create_key().get("key") # free key
36
+ s = Surface(api_key=key)
37
+ print(s.preflight("https://youtu.be/jNQXAC9IVRw")) # next: fetch or skip
38
+ print(s.inspect()) # bot, browser, or script
39
+ ```
40
+ JavaScript: `npm install @surfaceapi/surface`
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,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