Skip to main content

crewai-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 crewai agents that check as one ready-made tool: surface_preflight.

pip install crewai-surface
from crewai import Agent
from crewai_surface import surface_preflight

researcher = Agent(role="Researcher", goal="...", backstory="...", tools=[surface_preflight])

The tool returns:

{"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:

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

Made by Canada Site Ops. MIT licensed.

Metadata

Release files for crewai-surface 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for crewai-surface 0.1.0
File Size Uploaded Provenance Actions
crewai_surface-0.1.0.tar.gz 3.2 kB Without provenance Details for crewai_surface-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for crewai-surface 0.1.0
File Interpreter ABI Platform Actions
crewai_surface-0.1.0-py3-none-any.whl Python 3 none any Details for crewai_surface-0.1.0-py3-none-any.whl

Total release size: 7.5 kB

Release files / crewai_surface-0.1.0.tar.gz

Download URL crewai_surface-0.1.0.tar.gz
Size 3.2 kB
Tags Source
SHA-256 checksum
How to use checksums
e64580e0ae36b8c05d9c6761c81744506cc7cb426baf0d8bc8deec86ab744ccf
BLAKE2b-256 checksum
How to use checksums
cd87a60ca38a0d4bb7f2c23fb67ddf02ec5df9ebf918e17eb5432c1f816e1ac1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.5

Release files / crewai_surface-0.1.0-py3-none-any.whl

Download URL crewai_surface-0.1.0-py3-none-any.whl
Size 4.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
244d542f4f0c69d0d3524fcb3a2b96693064fde7cb6f59d0bba4b25fbc9458c1
BLAKE2b-256 checksum
How to use checksums
95743d280fd8eec26a7d409cb60a81f99d22479101e7ab91c12dd65e4598900e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.5

Security for crewai-surface 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page