Metadata-Version: 2.5
Name: langchain-surface
Version: 0.1.0
Summary: Surface for langchain: the link-safety layer between an AI agent and the open web. One tool, surface_preflight, that tells your agent whether a link is worth fetching.
Project-URL: Homepage, https://otter-sand-wolf-spring.grok.me
Project-URL: Documentation, https://nova-otter-delta-cloud.grok.me/docs
Project-URL: API reference, https://nova-otter-delta-cloud.grok.me/llms.txt
Project-URL: MCP server, https://nova-otter-delta-cloud.grok.me/mcp
Author-email: Canada Site Ops <canada.site.ops@gmail.com>
Maintainer-email: Canada Site Ops <canada.site.ops@gmail.com>
License: MIT
License-File: LICENSE
Keywords: ai-agents,langchain,link-safety,mcp,preflight,surface,tools,url
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Python: >=3.9
Requires-Dist: langchain-core>=0.2
Description-Content-Type: text/markdown

# langchain-surface

**Surface is the link-safety layer between an AI agent and the open web.** Before your agent opens a link someone pasted, Surface checks it: it unwraps short links (t.co, bit.ly, lnkd.in, youtu.be), follows the redirects, and answers **fetch** or **skip**, along with where the link really goes. It never downloads the page for you, so it's fast and cheap.

This package gives langchain agents that check as one ready-made tool: `surface_preflight`.

```bash
pip install langchain-surface
```

```python
from langchain_surface import surface_preflight

agent_tools = [surface_preflight]
print(surface_preflight.invoke({"url": "https://youtu.be/jNQXAC9IVRw"}))
```

The tool returns:

```json
{"next": "fetch", "fetch": true, "url": "https://youtu.be/jNQXAC9IVRw",
 "final_url": "https://www.youtube.com/watch?v=jNQXAC9IVRw&feature=youtu.be",
 "final_host": "youtube.com", "status": 200, "redirects": 1, "shortener": true,
 "reason": "unwrapped youtu.be → youtube.com · alive, worth a fetch"}
```

## Free to start

The first 1M requests a month are free. It works with no key at all (shared demo limit), or grab your own free key in one call, with no email and no card:

```bash
curl -s -X POST https://nova-otter-delta-cloud.grok.me/v1/keys
export SURFACE_API_KEY=...
```

After the free tier: $0.25 USD per 1,000 preflights.

## Prefer MCP?

Point any MCP client at `https://nova-otter-delta-cloud.grok.me/mcp` (tool `preflight_url`).

- Website: https://otter-sand-wolf-spring.grok.me
- Docs: https://nova-otter-delta-cloud.grok.me/docs
- LLM reference: https://nova-otter-delta-cloud.grok.me/llms.txt

Made by Canada Site Ops. MIT licensed.
