# Surf Web

> Pay-per-use web search and crawl API with x402 micropayments.

Base URL: https://web.surf.cascade.fyi
Payment: USDC on Base, Solana, or Tempo via x402/MPP. No API keys needed.
Marketplace: https://surf.cascade.fyi

## Overview

POST /v1/crawl to extract web page content as markdown, HTML, or text. Accepts { url } for single pages or { urls } for bulk. POST /v1/search for web search with { query, num_results? }. All requests require x402 or MPP payment (USDC on Solana, Base, or Tempo).

## Payment Flow

All paid endpoints return HTTP 402 with payment instructions on first request.
Use `npx x402-proxy` to handle payment automatically:

1. Install: `npm i -g x402-proxy` (or use `npx` directly)
2. Check wallet: `npx x402-proxy wallet`
3. Make requests - payment is handled transparently on 402 responses

Supported networks: Base (EVM), Solana, Tempo (MPP).
Force a specific network: `npx x402-proxy --network base ...` or `--network solana`.

## Try It

    npx x402-proxy -X POST -H "Content-Type: application/json" -d '{"url":"https://x402.org","format":"markdown"}' https://web.surf.cascade.fyi/v1/crawl

    npx x402-proxy -X POST -H "Content-Type: application/json" -d '{"query":"x402 protocol","num_results":5}' https://web.surf.cascade.fyi/v1/search

## Endpoints

| Method | Path | Price | Description |
| --- | --- | --- | --- |
| POST | /v1/crawl | $0.002 | Crawl web pages and extract content as markdown, HTML, or text |
| POST | /v1/search | $0.01 | Web search powered by Exa |

## MCP (Model Context Protocol)

This service is available as an MCP server for AI agents:

    npx x402-proxy mcp https://web.surf.cascade.fyi/mcp

List available tools:

    npx @modelcontextprotocol/inspector --cli npx x402-proxy mcp https://web.surf.cascade.fyi/mcp --method tools/list

## Links

- [OpenAPI Spec](https://web.surf.cascade.fyi/openapi.json)
- [API Reference](https://web.surf.cascade.fyi/docs)
- [Surf Marketplace](https://surf.cascade.fyi)
- [x402 Protocol](https://x402.org)