ShipPage

ShipPage — HTML or Markdown in. URL out. Zero config.

[npm version] [License: MIT]

ShipPage is a zero-config HTML publishing service for AI agents. Turn any HTML or Markdown into a public URL with a single HTTP POST — no account, no setup, no build step. Purpose-built for Claude Code, Claude Desktop, Cursor, and any HTTP client.

Official Website: shippage.ai · Install: clawhub install shippage or npx shippage-mcp

English | 中文

What is ShipPage?

ShipPage is a zero-config HTML publishing service designed for AI agents. Hand it any HTML or Markdown and get back a public URL — one API call, done. Markdown content is automatically converted to a beautifully styled, mobile-friendly webpage with GitHub-flavored formatting.

One HTTP POST turns any HTML into a public URL — no account, no setup, no build step. When an AI agent calls the publish endpoint for the first time, ShipPage automatically registers the agent, issues an API key, and returns a live URL — all in one request. No human setup required.

ShipPage is built on Cloudflare Workers, R2, and KV for sub-100ms edge performance. It supports password-protected pages, custom URL slugs, full CRUD management, selective search-engine indexing (public: true), skill auto-update, and integrates with the OpenClaw and MCP ecosystems. MIT-licensed.

Quick Start

Option 1: OpenClaw Skill (Claude Code)

clawhub install shippage

Then tell your AI: "Publish this HTML as a webpage" or "Turn this Markdown into a shareable link" — done.

Option 2: MCP Server (Claude Desktop / Cursor)

Add to your claude_desktop_config.json:

{  "mcpServers": {    "shippage": {      "command": "npx",      "args": ["shippage-mcp"]    }  }}

No API key needed. No environment variables. Supports both publish_html and publish_markdown tools.

Option 3: Direct API

Publish HTML:

curl -X POST https://shippage.ai/v1/publish \  -H "Content-Type: application/json" \  -d '{    "html": "<html><body><h1>Hello World!</h1></body></html>",    "title": "My Page"  }'

Publish Markdown (converted to a styled webpage automatically):

curl -X POST https://shippage.ai/v1/publish \  -H "Content-Type: application/json" \  -d '{    "html": "<html>...your rendered markdown...</html>",    "title": "My Doc"  }'

Response:

{  "ok": true,  "url": "https://shippage.ai/p/x7k2m9",  "slug": "x7k2m9",  "expires_at": "2026-04-05T14:30:00Z",  "_registration": {    "api_key": "sk_...",    "claim_url": "https://shippage.ai/claim/ABCD-1234"  }}

Save the api_key for subsequent requests. The claim_url lets the user manage pages via web UI (optional).

API Reference

POST /v1/publish Parameters

Features

How It Works

Agent calls POST /v1/publish with HTML or rendered Markdown    │    ├─ First time? → Auto-register: generate agent_id + api_key + claim_code    │                Return URL + credentials in one response    │    ├─ Returning? → Verify API key, check quota    │    ▼Store HTML in R2 → Store metadata in KV → Return public URL

• Infrastructure: Cloudflare Workers + R2 (storage) + KV (metadata)
• Response time: <100ms (edge-deployed on 300+ data centers)
• Daily cleanup: Cron job removes expired pages automatically

Free Tier

No credit card required.

FAQ

Q: Do I need to register before using ShipPage? A: No. ShipPage auto-registers your AI agent on the first API call. No signup, no forms, no email verification.

Q: Can I publish Markdown directly? A: Yes. The OpenClaw skill and MCP server both support Markdown natively — your Markdown is converted to a beautifully styled, mobile-friendly webpage automatically.

Q: What happens when my pages expire? A: Free-tier pages expire after 14 days and are automatically cleaned up. You can re-publish at any time. Pro tier (coming soon) offers permanent pages.

Q: Can I use ShipPage without Claude? A: Yes. ShipPage works with any HTTP client. The API is a standard REST endpoint — use it from any AI agent, script, or tool.

Q: How does skill auto-update work? A: The ShipPage skill checks for updates on first use each session. If a new version is available, it downloads and replaces itself automatically. Changes take effect in the next session.

Q: Is ShipPage open source? A: Yes. The source code is available at github.com/jieshu666/ShipPage-Skill under the MIT license.

Tech Stack

• Runtime: Cloudflare Workers + Hono
• Storage: Cloudflare R2 (HTML files)
• Metadata: Cloudflare KV (agent records, page metadata)
• Language: TypeScript

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

License

MIT