PageSnap

# Pagesnap

**One API that turns any publicly reachable URL into clean Markdown, a screenshot, a PDF, structured data or link metadata — built for AI agents and developers.**

[![Pagesnap status](https://img.shields.io/endpoint?url=https%3A%2F%2Fpagesnap.142-93-197-141.sslip.io%2Fbadge%2Fstatus.json)](https://pagesnap.142-93-197-141.sslip.io/status)
[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-1.2.0-5b5bd6)](https://registry.modelcontextprotocol.io/v0/servers/io.sslip.142-93-197-141.pagesnap%2Fpagesnap/versions/latest)
[![x402scan](https://img.shields.io/badge/x402scan-listed-6f42c1)](https://www.x402scan.com/server/8ae97d33-0dd5-47d2-9306-628c1e4a5509)
[![MCP Servers](https://mcpservers.org/badge.svg)](https://mcpservers.org/servers/pagesnap-142-93-197-141-sslip-io-docs)

[![Pagesnap live demo: enter a URL, receive clean Markdown and a screenshot](docs/demo.gif)](https://pagesnap.142-93-197-141.sslip.io/)

```bash
npx -y github:CalibratedGhosts/PageSnap read <url>
npx -y github:CalibratedGhosts/PageSnap mcp
curl "https://pagesnap.142-93-197-141.sslip.io/v1/read?url=https://example.com"
```

[![Install in Cursor](docs/badges/install-in-cursor.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=pagesnap&config=eyJ1cmwiOiJodHRwczovL3BhZ2VzbmFwLjE0Mi05My0xOTctMTQxLnNzbGlwLmlvL21jcCJ9)
[![Install in VS Code](docs/badges/install-in-vscode.svg)](vscode:mcp/install?%7B%22name%22%3A%22pagesnap%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fpagesnap.142-93-197-141.sslip.io%2Fmcp%22%7D)

**Start free:** eligible new keys include a **7-day Pro trial** (one per creator every 30 days), with no email or card required.

[Live site](https://pagesnap.142-93-197-141.sslip.io/) · [Docs](https://pagesnap.142-93-197-141.sslip.io/docs) · [Source](https://github.com/CalibratedGhosts/PageSnap) · [Live stats](https://pagesnap.142-93-197-141.sslip.io/stats) · [Status](https://pagesnap.142-93-197-141.sslip.io/status) · [Build log](https://pagesnap.142-93-197-141.sslip.io/log)

> This service was designed, built, deployed and is operated **autonomously by an AI agent** (Anthropic's Claude in Claude Code, delegating to OpenAI Codex agents) on a single VPS. A human owner set the goal and provides no day-to-day input. The full build log is public at [/log](https://pagesnap.142-93-197-141.sslip.io/log) and the transparency page at [/trust](https://pagesnap.142-93-197-141.sslip.io/trust).

## Quick start

```bash
# Page → Markdown (no key needed for the first 30 requests/day per IP)
curl "https://pagesnap.142-93-197-141.sslip.io/v1/read?url=https://example.com"

# Page → screenshot / PDF / metadata / structured data
curl -o shot.png "https://pagesnap.142-93-197-141.sslip.io/v1/screenshot?url=https://example.com&full_page=true"
curl -o page.pdf "https://pagesnap.142-93-197-141.sslip.io/v1/pdf?url=https://example.com"
curl "https://pagesnap.142-93-197-141.sslip.io/v1/meta?url=https://example.com"
curl "https://pagesnap.142-93-197-141.sslip.io/v1/extract?url=https://example.com"

# Free key (100/day): POST /v1/keys — then Authorization: Bearer ps_live_…
```

## Command-line client

Run the dependency-free Node 18 CLI directly from this repository. A key is optional; set `PAGESNAP_API_KEY` or store `{"apiKey":"ps_live_..."}` in `~/.config/pagesnap/config.json`.

```bash
npx -y github:CalibratedGhosts/PageSnap read https://example.com
npx -y github:CalibratedGhosts/PageSnap shot https://example.com -o example.png --full-page
npx -y github:CalibratedGhosts/PageSnap crawl https://example.com --limit 5
```

Commands: `read`, `shot`, `pdf`, `meta`, `extract`, `crawl`, `llms-txt`, `diff`, `keys create`, `me`, and `mcp`. The `mcp` command starts the stdio bridge. Binary screenshot/PDF output goes to stdout unless `-o` is supplied. Set `PAGESNAP_BASE_URL` only when targeting a compatible self-hosted server.

Append `#<commit-sha>` to the GitHub spec for a reproducible install. When checking an updated unpinned branch immediately, use a fresh npm cache if necessary; modern npm no longer supports the legacy `npx --ignore-existing` flag.

## Add to your editor

The badges above install Pagesnap's anonymous remote MCP connection in Cursor or VS Code. A Pagesnap API key and `Authorization` header are optional; add them later only for keyed quota and account tools.

- [Install in Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=pagesnap&config=eyJ1cmwiOiJodHRwczovL3BhZ2VzbmFwLjE0Mi05My0xOTctMTQxLnNzbGlwLmlvL21jcCJ9)
- [Install in VS Code](vscode:mcp/install?%7B%22name%22%3A%22pagesnap%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fpagesnap.142-93-197-141.sslip.io%2Fmcp%22%7D)
- [Install in VS Code Insiders](vscode-insiders:mcp/install?%7B%22name%22%3A%22pagesnap%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fpagesnap.142-93-197-141.sslip.io%2Fmcp%22%7D)
- Claude Code: `claude mcp add --transport http pagesnap https://pagesnap.142-93-197-141.sslip.io/mcp`

Claude Desktop supports a custom connector: open Customize → Connectors → Add custom connector and paste `https://pagesnap.142-93-197-141.sslip.io/mcp`. Windsurf, Zed, and JetBrains currently document manual remote-server configuration rather than an MCP install-link scheme; see the live [editor instructions](https://pagesnap.142-93-197-141.sslip.io/docs#editor-install-heading) for copy-ready configuration.

For agents: remote **MCP** server at `/mcp` (`claude mcp add --transport http pagesnap https://pagesnap.142-93-197-141.sslip.io/mcp`), **A2A** agent card at `/.well-known/agent-card.json`, keyless **x402** pay-per-request routes under `/x402/v1/*`, `llms.txt`, and OpenAPI at `/openapi.json`.

Repository-friendly documentation is mirrored in [`docs/`](docs/README.md): [API reference](docs/api-reference.md), [MCP/A2A/x402 setup](docs/protocols.md), [guides](docs/guides.md), [pricing](docs/pricing.md), and [trust](docs/trust.md). These files are generated from the same view functions as the live site.

## Install for agents

No npm account or Pagesnap API key is required to start. Set `PAGESNAP_API_KEY` for higher quota and account tools.

```bash
# Any stdio MCP client (runs directly from this GitHub repository)
npx -y github:CalibratedGhosts/PageSnap mcp

# Claude Code marketplace plugin (remote MCP + skill)
claude plugin marketplace add CalibratedGhosts/PageSnap
claude plugin install pagesnap@pagesnap

# Codex / open Agent Skills convention
npx -y skills add CalibratedGhosts/PageSnap --skill pagesnap -g -a codex -y
```

The `mcp` subcommand exposes the remote content, crawl, llms.txt, usage, upgrade, and monitor tools plus four prompts and four resources. Its only direct dependencies are the MCP SDK and Zod; the other CLI commands use only Node's built-in `fetch` and standard library. The packed install excludes the API server, rendering engine, and payment service.

## What is in this repository

| Directory | Purpose |
|---|---|
| `server/` | Fastify API: read/screenshot/pdf/meta/extract/render/batch/crawl/diff/monitors, keys and plans, checkout and receipts, MCP + A2A + x402 endpoints, docs and 500+ localized pages, admin console |
| `engine/` | Render engine: fast fetch + Readability→Markdown, headless Chromium (Playwright) with SSRF protection, bounded pre-capture actions, automatic (non-interactive) JS-challenge handling, crawl, structured extraction, diff |
| `payments/` | Self-custodied crypto payments (USDC/ETH on Base, Arbitrum, Optimism, Polygon, Ethereum), per-invoice addresses, watcher, receipts; Stripe adapter (disabled until configured) |
| `bin/` | Tiny stdio MCP bridge and zero-dependency CLI installed straight from GitHub with `npx` |
| `plugins/pagesnap/` | Claude Code marketplace plugin with remote MCP and the Pagesnap skill |
| `skills/pagesnap/` | Portable Pagesnap Agent Skill, including Codex display metadata |
| `docs/` | Generated Markdown mirror of the live API, protocol, guide, pricing and trust documentation; also the GitHub Pages landing page |
| `LOG.md` | The agent's public build and operations log |
| `OPERATIONS.md` | Runbook: services, timers, backups, recovery, the unattended operator loop |

Secrets, databases and logs are not in the repository (`.gitignore`).

## Run it yourself

Requires Node 22 and Chromium dependencies (`npx playwright install --with-deps chromium` inside `engine/`). Each of `server/`, `engine/`, `payments/` has its own `package.json`; install each, then `node server/index.js` (listens on 127.0.0.1:3000 behind a TLS-terminating proxy). See `OPERATIONS.md`.

## Status and license

Early, small, honest: no SLA, one region. Plans: Free, Starter $3, Pro $9, Scale $29 per 31 days, paid in crypto; pay-per-request via x402. A software license has not yet been chosen by the repository owner; until then all rights are reserved. Issues and pull requests are read by the operating agent.