ShipPage

ShipPage — 输入 HTML 或 Markdown，输出 URL。零配置。

ShipPage 是一项面向 AI Agent 的零配置 HTML 发布服务。 只需发送一次 HTTP POST，即可将任意 HTML 或 Markdown 转换为公开 URL——无需账户、无需设置、无需构建步骤。专为 Claude Code、Claude Desktop、Cursor 及任何 HTTP 客户端打造。

官方网站：shippage.ai · 安装： clawhub install shippage 或 npx shippage-mcp

English | 中文

---

什么是 ShipPage？

ShipPage 是一项专为 AI Agent 打造的零配置 HTML 发布服务。 提供任意 HTML 或 Markdown，即可获得公开 URL——调用一次 API 即可完成。Markdown 内容会自动转换为样式精美、适合移动设备浏览且采用 GitHub 风格格式的网页。

只需发送一次 HTTP POST，即可将任意 HTML 转换为公开 URL——无需账户、无需设置、无需构建步骤。 AI Agent 首次调用发布端点时，ShipPage 会自动注册该 Agent、签发 API 密钥并返回可访问的 URL——全部通过一次请求完成。无需人工设置。

ShipPage 基于 Cloudflare Workers、R2 和 KV 构建，可实现低于 100 毫秒的边缘性能。 支持密码保护页面、自定义 URL slug、完整的 CRUD 管理、选择性搜索引擎索引（public: true）、技能自动更新，并集成 OpenClaw 和 MCP 生态系统。采用 MIT 许可证。

快速开始

选项 1：OpenClaw 技能（Claude Code）

clawhub install shippage

然后告诉你的 AI：“将此 HTML 发布为网页”或“将此 Markdown 转换为可分享的链接”——搞定。

选项 2：MCP 服务（Claude Desktop / Cursor）

添加到你的 claude_desktop_config.json：

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

无需 API 密钥。无需环境变量。支持 publish_html 和 publish_markdown 工具。

选项 3：直接调用 API

发布 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"
  }'

发布 Markdown（会自动转换为带样式的网页）：

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

响应：

{
  "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"
  }
}

保存 api_key 以用于后续请求。claim_url 可让用户通过 Web UI 管理页面（可选）。

API 参考

方法	端点	说明	认证
POST	/v1/publish	发布 HTML，返回公开 URL	可选（缺少时自动注册）
GET	/v1/pages	列出所有已发布页面	必需
PUT	/v1/pages/:slug	更新页面	必需
DELETE	/v1/pages/:slug	删除页面	必需
GET	/p/:slug	查看已发布页面	无
GET	/v1/skill/version	检查技能更新	无
GET	/v1/skill/download	下载最新版 SKILL.md	无

POST /v1/publish 参数

参数	必需	类型	说明
html	是	string	要发布的 HTML 内容
title	否	string	页面的显示名称
slug	否	string	自定义 URL 路径（例如，my-page → shippage.ai/p/my-page）
password	否	string	设置密码才能查看页面
expires_in	否	number	到期前的秒数（默认值：1,209,600 = 14 天）
public	否	boolean	若为 true，页面可被搜索引擎索引（index,follow），并会加入 /sitemap.xml。默认值为 false（noindex）。

功能

功能	ShipPage	PageDrop	手动部署
零配置	✅	✅	❌
HTML → 网页	✅	✅	✅
Markdown → 带样式的网页	✅	❌	❌
Agent 身份系统	✅	❌	❌
页面管理（CRUD）	✅	❌	因情况而异
密码保护	✅	❌	因情况而异
自定义 URL slug	✅	❌	✅
OpenClaw + MCP 生态系统	✅	❌	❌
技能自动更新	✅	❌	❌
自动过期与清理	✅	✅	❌

工作原理

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

• 基础设施：Cloudflare Workers + R2（存储）+ KV（元数据）
• 响应时间：<100ms（部署在 300+ 个数据中心的边缘节点）
• 每日清理：Cron 任务自动删除过期页面

免费套餐

限制	值
每月发布次数	20
页面最大大小	500 KB
页面保留时间	14 天
密码保护	✅ 已包含
自定义 slug	✅ 已包含

无需信用卡。

常见问题

问：使用 ShipPage 前需要注册吗？ 答：不需要。ShipPage 会在首次 API 调用时自动注册你的 AI Agent。无需注册账号、填写表单或验证邮箱。

问：可以直接发布 Markdown 吗？ 答：可以。OpenClaw 技能和 MCP 服务都原生支持 Markdown——你的 Markdown 会自动转换为美观、适合移动设备浏览的网页。

问：页面过期后会发生什么？ 答：免费套餐的页面会在 14 天后过期，并自动清理。你可以随时重新发布。Pro 套餐（即将推出）支持永久保留页面。

问：不使用 Claude 也能使用 ShipPage 吗？ 答：可以。ShipPage 兼容任何 HTTP 客户端。API 是标准的 REST 端点，可通过任何 AI Agent、脚本或工具调用。

问：技能如何自动更新？ 答：ShipPage 技能会在每个会话首次使用时检查更新。如果有新版本可用，它会自动下载并替换自身。更改会在下一个会话生效。

问：ShipPage 是开源的吗？ 答：是的。源代码采用 MIT 许可证，可在 github.com/jieshu666/ShipPage-Skill 查看。

技术栈

• 运行时：Cloudflare Workers + Hono
• 存储：Cloudflare R2（HTML 文件）
• 元数据：Cloudflare KV（Agent 记录、页面元数据）
• 语言：TypeScript

参与贡献

欢迎贡献！请提交 issue 或拉取请求。

许可证

MIT