# WebUplink

> A web-actions API for AI agents. Point your agent at any URL and the page comes back as named tools it can call.

WebUplink lets AI agents browse any public page on the web and get back named, callable tools they can use to interact with it. Unlike read-only scrapers, agents can fill forms, click buttons, and complete multi-step workflows — sessions carry cookies and state across calls for the length of a task (~15 minutes). One endpoint, no selectors, no per-site code.

## API

Base URL: https://api.webuplink.ai

### POST /v1/browse
Browse a page or execute tools. The unified endpoint for all interactions.

Request:
- url (string, optional): URL to browse — creates a new session
- session_id (string, optional): Resume an existing session
- tool (string, optional): Single tool to execute
- params (object, optional): Parameters for the tool
- tools (array, optional): Batch of tools to execute sequentially
- include_page_content (boolean, optional): Include detailed page content

Response:
- session_id: Session ID for follow-up requests
- url: Current page URL
- title: Page title
- summary: AI-generated page summary
- tools: Available actions on this page (name, description, params)
- results: Tool execution results (if tools were executed)

### DELETE /v1/session/{id}
Close a browser session.

### GET /v1/usage
Get current usage metrics.

### GET /health
Health check endpoint.

## Authentication
All /v1/* endpoints require: Authorization: Bearer <api-key>

## TypeScript SDK
npm install webuplink

```typescript
import { WebUplink } from 'webuplink';
const client = new WebUplink({ apiKey: '...', baseUrl: 'https://api.webuplink.ai' });
const page = await client.browse('https://example.com');
```

## Python SDK
pip install webuplink

```python
from webuplink import WebUplink
client = WebUplink(api_key="...")
page = client.browse("https://example.com")
```

## MCP Server
npm install @webuplink/mcp

## Pricing

WebUplink uses action-based pricing. One action = one tool call or one PageMap.

| Plan | Price | Included actions | Overage | Concurrent sessions | Requests/min |
|------|-------|------------------|---------|---------------------|--------------|
| Free | $0 | 250 | None — hard cap | 1 | 30 |
| Builder | $29/mo | 1,000 | $0.02/action | 15 | 120 |
| Pro | $79/mo | 5,000 | $0.015/action | 30 | 300 |

250 free actions every month. No credit card. The Free quota resets each calendar month; paid quotas reset on the billing anniversary, with metered overage beyond the included allowance (spend caps on by default, adjustable). Optional 14-day Builder trial — card required, auto-converts to Builder on day 14, cancel anytime. The trial includes 1,000 actions for the 14-day window at Builder limits. Enterprise (from $2,000/mo) adds >30 concurrent sessions, invoicing, SSO, and committed volume: https://webuplink.ai/enterprise

All plans include: named callable tools, any public URL (bot-walled pages return an unbilled SITE_BLOCKED error), managed sessions, MCP server + SDKs. Automating third-party login/SSO domains (e.g. accounts.google.com) is a verification-gated capability on every plan — enable it in the dashboard (card on file + Acceptable Use Policy attestation).

## Use Cases

- AI agent web browsing: point an agent at any URL to read and interact with pages
- Authenticated workflows: agents execute login tools and the session retains auth state for the rest of the task
- Form filling and data entry: agents call named tools to fill forms, click buttons, and submit
- Multi-step workflows: task-scoped sessions let agents navigate across pages
- Content extraction: get structured page summaries and content without scraping

## How WebUplink differs from Firecrawl

Firecrawl extracts page content as markdown — read-only. WebUplink returns callable tools so agents can interact: fill forms, click, navigate, and complete multi-step workflows in task-scoped browser sessions. WebUplink is a web-actions API; Firecrawl is a web-reading API.

## Support

Email support@webuplink.ai — we aim to reply within 1 business day.

## Links
- [Documentation](https://webuplink.ai/docs)
- [Quickstart](https://webuplink.ai/docs/quickstart)
- [API Reference](https://webuplink.ai/docs/api-reference)
- [Error Reference](https://webuplink.ai/docs/errors)
- [Production Traffic Guide](https://webuplink.ai/docs/guides/production-traffic)
- [About](https://webuplink.ai/about)
- [GitHub](https://github.com/webuplink-dev)
- [npm — TypeScript SDK](https://www.npmjs.com/package/webuplink)
- [npm — MCP Server](https://www.npmjs.com/package/@webuplink/mcp)
- [PyPI — Python SDK](https://pypi.org/project/webuplink/)