ShipPage

io.github.jieshu666由 GitHub 账号 jieshu666 发布v1.2.1更新于 Oct 24, 2026

Publish HTML or Markdown to a public URL in one call. Zero config, auto-registers on first use.

发布方自己的服务:ship.page

已验证STDIO仅桌面效率与工作流文件与存储

概览

AI 生成的概览

ShipPage 可将 HTML 或 Markdown 发布为公开网页并返回可访问的 URL,让助手一次调用就把生成内容变成可分享的链接。

可以做什么
发布 HTML 为公开页面,返回 URL 和 slug,可设置标题、自定义 slug、密码和过期时间(publish_html)。将 Markdown 自动转换为美观、适配移动端的网页并发布(publish_markdown)。页面默认不被搜索引擎索引,默认 14 天后过期。首次发布时服务会自动注册智能体,并返回 API 密钥和认领链接。
适用场景
适合助手生成需要有人在浏览器中查看的 HTML 或 Markdown 时使用,例如报告、原型、文档页面或演示,希望无需搭建托管或注册账号即可获得公开链接。
运行要求
通过 npx shippage-mcp 作为本地 stdio 进程运行(需要 Node.js)。启动无需 API 密钥或环境变量,首次发布时自动注册。需要能访问 ShipPage 服务的网络。仅支持桌面客户端。
安装前请注意
发布的页面默认在互联网上公开,请勿发送密钥或隐私数据。首次发布会自动创建账户并返回 API 密钥,应妥善保管以便后续管理。免费额度为每月 20 次发布、单页 500 KB,页面 14 天后过期。内容存储在第三方 Cloudflare 基础设施上。

安装

在 SourceWeft 中

  1. 打开 控制台中的 ShipPage,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

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)

bash
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:

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:

bash
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):

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

Response:

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

MethodEndpointDescriptionAuth
POST/v1/publishPublish HTML, returns public URLOptional (auto-registers if missing)
GET/v1/pagesList all published pagesRequired
PUT/v1/pages/:slugUpdate a pageRequired
DELETE/v1/pages/:slugDelete a pageRequired
GET/p/:slugView a published pageNone
GET/v1/skill/versionCheck for skill updatesNone
GET/v1/skill/downloadDownload latest SKILL.mdNone

POST /v1/publish Parameters

ParameterRequiredTypeDescription
htmlYesstringThe HTML content to publish
titleNostringDisplay name for the page
slugNostringCustom URL path (e.g., my-page → shippage.ai/p/my-page)
passwordNostringRequire a password to view the page
expires_inNonumberSeconds until expiry (default: 1,209,600 = 14 days)
publicNobooleanIf true, the page is indexable by search engines (index,follow) and included in /sitemap.xml. Default false (noindex).

Features

FeatureShipPagePageDropManual Deploy
Zero config✅✅❌
HTML → Webpage✅✅✅
Markdown → Styled Webpage✅❌❌
Agent identity system✅❌❌
Page management (CRUD)✅❌Varies
Password protection✅❌Varies
Custom URL slugs✅❌✅
OpenClaw + MCP ecosystem✅❌❌
Skill auto-update✅❌❌
Auto-expiry & cleanup✅✅❌

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

LimitValue
Publishes per month20
Max page size500 KB
Page retention14 days
Password protection✅ Included
Custom slugs✅ Included

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

Contributing

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

License

MIT

来源:README.md,提交 6f0d437

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v1.2.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Ship 集成