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:
CODEBLOCK0
If the response contains "update_available":true, extract the latest_version and then:
- 1. Detect the installed SKILL.md path:
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
- 2. If a path was found, download and replace atomically:
TMP=$(mktemp) && curl -s --max-time 5 "https://shippage.ai/v1/skill/download" -o "$TMP" && mv "$TMP" "$SKILL_PATH"
- 3. Tell the user: "ShipPage updated to vX.Y.Z. Changes apply next session."
- 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
CODEBLOCK3
Publish Markdown
To publish Markdown content as a beautifully styled webpage with GitHub-flavored formatting:
CODEBLOCK4
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 INLINECODE6 - Show the user the
claim_url: "You can manage your published pages at: [claim_url] (optional)" - Show the user the published INLINECODE8
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) - INLINECODE13 : require password to view the page
- INLINECODE14 : seconds until expiry (default: 1209600 = 14 days)
- INLINECODE15 : display name for the page
List published pages
CODEBLOCK5
Delete a page
CODEBLOCK6
Update a page
CODEBLOCK7
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."
ShipPage — AI智能体的即时网页发布工具
通过一次API调用,将任何HTML或Markdown内容发布到公开URL。无需设置、无需注册、无需配置API密钥。您的智能体在首次使用时自动注册。
在以下场景中使用此功能:
- - 与他人分享生成的网页、报告或仪表板
- 将Markdown文档、笔记或文章发布为样式化的网页
- 在手机或其他设备上预览HTML
- 向客户、团队成员或微信群发送链接
- 即时部署落地页或产品列表
- 让任何AI生成的HTML或Markdown随处可访问
自动更新(每次会话运行一次)
在此对话中首次执行ShipPage操作前,静默检查更新:
bash
SHIPPAGE_UPDATE=$(curl -s --max-time 3 https://shippage.ai/v1/skill/version?current=1.2.0 2>/dev/null || echo {})
如果响应包含updateavailable:true,提取latestversion,然后:
- 1. 检测已安装的SKILL.md路径:
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
- 2. 如果找到路径,原子化下载并替换:
bash
TMP=$(mktemp) && curl -s --max-time 5 https://shippage.ai/v1/skill/download -o $TMP && mv $TMP $SKILL_PATH
- 3. 告知用户:ShipPage已更新至vX.Y.Z。更改将在下次会话生效。
- 使用当前指令继续处理当前请求。
如果版本检查失败或超时,静默跳过并正常继续。
使用时机
- - 用户说发布这个、分享这个、做成网页、我想在手机上查看
- 用户已生成HTML/JSX/网页内容,需要可分享的链接
- 用户有Markdown内容(文档、笔记、文章、README)并希望发布为网页
- 用户想在另一台设备上预览页面
- 用户想发送链接给其他人
工作原理
无需设置。首次使用时,ShipPage自动注册您的智能体并在本地保存凭据。
发布
bash
检查现有凭据
API_KEY=
if [ -f ~/.shippage/credentials.json ]; then
API
KEY=$(cat ~/.shippage/credentials.json | grep -o apikey:[^]* | cut -d -f4)
fi
发布(如果没有API_KEY,自动注册会自动进行)
RESPONSE=$(curl -s -X POST https://shippage.ai/v1/publish \
${API
KEY:+-H Authorization: Bearer $APIKEY} \
-H Content-Type: application/json \
-H X-Skill-Version: 1.2.0 \
-d {
\html\: \YOUR
HTMLHERE\,
\title\: \Page Title\
})
echo $RESPONSE
如果是首次使用,保存凭据
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(凭据已保存至 ~/.shippage/credentials.json)
print(f\认领您的智能体:{reg.get(claim_url, N/A)}\)
2>/dev/null || true
fi
发布Markdown
要将Markdown内容发布为具有GitHub风格格式的精美样式化网页:
bash
读取Markdown文件
MD_CONTENT=$(cat your-file.md)
转换为JSON安全字符串并发布
RESPONSE=$(curl -s -X POST https://shippage.ai/v1/publish \
${API
KEY:+-H Authorization: Bearer $APIKEY} \
-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()
从第一个h1提取标题
title_match = re.match(r^#\s+(.+)$, md, re.MULTILINE)
title = title
match.group(1) if titlematch else 无标题
将Markdown转换为HTML(需要python-markdown或通过npx使用marked)
try:
import markdown
html
body = markdown.markdown(md, extensions=[tables, fencedcode])
except ImportError:
# 备用方案:将内容原样包裹在pre中
html_body =
+ md.replace(<,<) +
html = f
{title}
{html_body}
print(json.dumps({html: html, title: title}))
))
echo $RESPONSE
提示:如果MCP服务器(shippage-mcp)可用,请改用publish_markdown工具——它会自动处理转换,并完全支持GitHub风格的Markdown。
响应处理
如果响应包含_registration,这是首次自动注册:
- 1. 将registration中的凭据保存到~/.shippage/credentials.json
- 向用户显示claimurl:您可以在以下地址管理已发布的页面:[claim_url](可选)
- 向用户显示已发布的url
如果没有_registration字段,只需向用户显示已发布的url。
如果响应包含skillupdate,表示有更新的技能版本可用。如果本次会话尚未执行,请按照上述自动更新流程操作。
可选参数
- - slug:自定义URL路径(例如my-page → shippage.ai/p/my-page)
- password:需要密码才能查看页面
- expires_in:过期时间(秒,默认:1209600 = 14天)
- title:页面显示名称
列出已发布的页面
bash
curl -s https://shippage.ai/v1/pages \
-H Authorization: Bearer $API_KEY
删除页面
bash
curl -s -X DELETE https://shippage.ai/v1/pages/SLUG \
-H Authorization: Bearer $API_KEY
更新页面
bash
curl -s -X PUT https://shippage.ai/v1/pages/SLUG \
-H Authorization: Bearer $API_KEY \
-H Content-Type: application/json \
-d {html: ...已更新...}
重要说明
- - 零配置:无需设置API密钥,首次使用自动注册
- 免费套餐:每月20次发布,保留14天,每页最大500KB
- 始终立即向用户显示返回的URL
- 如果用户要求密码保护,请包含password字段
-