Metadata-Version: 2.4
Name: surfaceapi
Version: 0.1.1
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.
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,short-link,unwrap,link-check,preflight,mcp,agents
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Surface: check a short link before you open it

[![links checked | Surface](https://nova-otter-delta-cloud.grok.me/badge/surface.svg)](https://nova-otter-delta-cloud.grok.me)

[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.

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)).

[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`

## One install for Cursor or Claude (MCP)
Paste this into your MCP settings. The agent then calls `preflight_url` before it opens a short link.
```json
{ "mcpServers": { "surface": { "type": "http", "url": "https://nova-otter-delta-cloud.grok.me/mcp" } } }
```

## Python
`pip install surfaceapi`
```python
from surfaceapi import Surface
key = Surface().create_key().get("key")   # free key
s = Surface(api_key=key)
print(s.preflight("https://youtu.be/jNQXAC9IVRw"))  # next: fetch or skip
print(s.inspect())                                  # bot, browser, or script
```
JavaScript: `npm install @surfaceapi/surface`
