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.
- surfaceapi-0.1.2/PKG-INFO +76 -0
- surfaceapi-0.1.2/README.md +62 -0
- surfaceapi-0.1.2/pyproject.toml +15 -0
- surfaceapi-0.1.2/surfaceapi.egg-info/PKG-INFO +76 -0
- surfaceapi-0.1.0/PKG-INFO +0 -37
- surfaceapi-0.1.0/README.md +0 -23
- surfaceapi-0.1.0/pyproject.toml +0 -15
- surfaceapi-0.1.0/surfaceapi.egg-info/PKG-INFO +0 -37
- {surfaceapi-0.1.0 → surfaceapi-0.1.2}/LICENSE +0 -0
- {surfaceapi-0.1.0 → surfaceapi-0.1.2}/setup.cfg +0 -0
- {surfaceapi-0.1.0 → surfaceapi-0.1.2}/surfaceapi/__init__.py +0 -0
- {surfaceapi-0.1.0 → surfaceapi-0.1.2}/surfaceapi.egg-info/SOURCES.txt +0 -0
- {surfaceapi-0.1.0 → surfaceapi-0.1.2}/surfaceapi.egg-info/dependency_links.txt +0 -0
- {surfaceapi-0.1.0 → surfaceapi-0.1.2}/surfaceapi.egg-info/top_level.txt +0 -0
|
@@ -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
|
-
[](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
|
-
```
|
surfaceapi-0.1.0/README.md
DELETED
|
@@ -1,23 +0,0 @@
|
|
|
1
|
-
# Surface clients
|
|
2
|
-
|
|
3
|
-
[](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
|
-
```
|
surfaceapi-0.1.0/pyproject.toml
DELETED
|
@@ -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
|
-
[](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
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|