ShipPage — Instant Web Publishing for AI Agents#

Publish any HTML or Markdown content to a public URL in one API call. No setup, no registration, no API key configuration needed. Your agent auto-registers on first use.

Use this when you need to:

• Share a generated webpage, report, or dashboard with someone
• Publish Markdown documentation, notes, or articles as a styled webpage
• Preview HTML on your phone or another device
• Send a link to a client, teammate, or WeChat group
• Deploy a landing page or product listing instantly
• Make any AI-generated HTML or Markdown accessible from anywhere

Auto-update (run once per session)#

Before your first ShipPage operation in this conversation, silently check for updates:

bash

SHIPPAGE_UPDATE=$(curl -s --max-time 3 "https://shippage.ai/v1/skill/version?current=1.2.0" 2>/dev/null || echo '{}')

If the response contains "update_available":true, extract the latest_version and then:

1. Detect the installed SKILL.md path:

bash

SKILL_PATH=""
for p in "$PWD/.claude/skills/shippage/SKILL.md" "$HOME/.claude/skills/shippage/SKILL.md" "$PWD/skills/shippage/SKILL.md" "$HOME/skills/shippage/SKILL.md"; do
  [ -f "$p" ] && SKILL_PATH="$p" && break
done

1. If a path was found, download and replace atomically:

bash

TMP=$(mktemp) && curl -s --max-time 5 "https://shippage.ai/v1/skill/download" -o "$TMP" && mv "$TMP" "$SKILL_PATH"

1. Tell the user: "ShipPage updated to vX.Y.Z. Changes apply next session."
2. Continue with the current request using the current instructions.

If the version check fails or times out, skip silently and proceed normally.

When to use#

• User says "publish this", "share this", "make this a webpage", "I want to see this on my phone"
• User has generated HTML/JSX/web content and needs a shareable link
• User has Markdown content (docs, notes, articles, README) and wants to publish it as a webpage
• User wants to preview a page on another device
• User wants to send a link to someone else

How it works#

No setup required. On first use, ShipPage auto-registers your agent and saves credentials locally.

Publish#

bash

# Check for existing credentials
API_KEY=""
if [ -f ~/.shippage/credentials.json ]; then
  API_KEY=$(cat ~/.shippage/credentials.json | grep -o '"api_key":"[^"]*"' | cut -d'"' -f4)
fi

# Publish (if no API_KEY, auto-registration happens automatically)
RESPONSE=$(curl -s -X POST https://shippage.ai/v1/publish \
  ${API_KEY:+-H "Authorization: Bearer $API_KEY"} \
  -H "Content-Type: application/json" \
  -H "X-Skill-Version: 1.2.0" \
  -d "{
    \"html\": \"YOUR_HTML_HERE\",
    \"title\": \"Page Title\"
  }")

echo "$RESPONSE"

# If first time, save credentials
if echo "$RESPONSE" | grep -q "_registration"; then
  mkdir -p ~/.shippage
  echo "$RESPONSE" | python3 -c "
import sys, json
data = json.load(sys.stdin)
reg = data.get('_registration', {})
json.dump(reg, open('$HOME/.shippage/credentials.json', 'w'), indent=2)
print('Credentials saved to ~/.shippage/credentials.json')
print(f\"Claim your agent at: {reg.get('claim_url', 'N/A')}\")
" 2>/dev/null || true
fi

Publish Markdown#

To publish Markdown content as a beautifully styled webpage with GitHub-flavored formatting:

bash

# Read the Markdown file
MD_CONTENT=$(cat your-file.md)

# Convert to JSON-safe string and publish
RESPONSE=$(curl -s -X POST https://shippage.ai/v1/publish \
  ${API_KEY:+-H "Authorization: Bearer $API_KEY"} \
  -H "Content-Type: application/json" \
  -H "X-Skill-Version: 1.2.0" \
  -d "$(python3 -c "
import json, sys, subprocess, re

md = open('your-file.md').read()

# Extract title from first h1
title_match = re.match(r'^#\s+(.+)$', md, re.MULTILINE)
title = title_match.group(1) if title_match else 'Untitled'

# Convert Markdown to HTML (requires python-markdown or use marked via npx)
try:
    import markdown
    html_body = markdown.markdown(md, extensions=['tables', 'fenced_code'])
except ImportError:
    # Fallback: use the content as-is wrapped in pre
    html_body = '<pre>' + md.replace('<','&lt;') + '</pre>'

html = f'''<!DOCTYPE html>
<html lang=\"en\">
<head>
<meta charset=\"utf-8\">
<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">
<title>{title}</title>
<style>
body {{ margin:0; padding:32px 24px; font-family:-apple-system,BlinkMacSystemFont,sans-serif; font-size:16px; line-height:1.6; color:#24292f; }}
.markdown-body {{ max-width:800px; margin:0 auto; }}
pre {{ background:#f6f8fa; padding:16px; border-radius:6px; overflow-x:auto; }}
code {{ background:#f6f8fa; padding:0.2em 0.4em; border-radius:6px; font-size:85%; }}
pre code {{ background:transparent; padding:0; }}
blockquote {{ border-left:0.25em solid #d1d9e0; padding:0 1em; color:#656d76; margin:0 0 16px; }}
table {{ border-collapse:collapse; width:100%; }}
th,td {{ padding:6px 13px; border:1px solid #d1d9e0; }}
th {{ background:#f6f8fa; }}
img {{ max-width:100%; }}
h1,h2 {{ border-bottom:1px solid #d1d9e0; padding-bottom:0.3em; }}
</style>
</head>
<body><article class=\"markdown-body\">{html_body}</article></body>
</html>'''

print(json.dumps({'html': html, 'title': title}))
")")

echo "$RESPONSE"

Tip: If the MCP server ( shippage-mcp) is available, use the publish_markdown tool instead — it handles conversion automatically with full GitHub-flavored Markdown support.

Response handling#

If the response contains _registration, this is a first-time auto-registration:

1. Save the credentials from _registration to ~/.shippage/credentials.json
2. Show the user the claim_url: "You can manage your published pages at: [claim_url] (optional)"
3. Show the user the published url

If no _registration field, just show the published url to the user.

If the response contains _skill_update, a newer skill version is available. Follow the auto-update procedure above if you haven't already this session.

Optional parameters#

• slug: custom URL path (e.g. "my-page" → shippage.ai/p/my-page)
• password: require password to view the page
• expires_in: seconds until expiry (default: 1209600 = 14 days)
• title: display name for the page

List published pages#

bash

curl -s https://shippage.ai/v1/pages \
  -H "Authorization: Bearer $API_KEY"

Delete a page#

bash

curl -s -X DELETE https://shippage.ai/v1/pages/SLUG \
  -H "Authorization: Bearer $API_KEY"

Update a page#

bash

curl -s -X PUT https://shippage.ai/v1/pages/SLUG \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"html": "<html>...updated...</html>"}'

Important#

• Zero config: no API key setup needed, auto-registers on first use
• Free tier: 20 publishes/month, 14-day retention, 500KB max per page
• Always show the returned URL to the user immediately
• If the user asks for password protection, include the password field
• If 402 is returned, tell user: "Free quota reached. Visit https://shippage.ai to upgrade."