host-html

host-html

将任意 HTML 文件发布为实时链接 — 即刻完成。 需要免费账户。无需部署流水线，也无需管理服务器。 → host-html.com

**注意 — v2.0.0 中的破坏性变更：**匿名发布已停止。现在发布需要一个免费的、已验证邮箱的 host-html 账户，并将个人 API 密钥设为 HOSTHTML_API_KEY。请参阅设置：获取 API 密钥。依赖内置共享密钥的旧版本将无法继续发布。

---

安装

Claude Code

/plugin marketplace add phanosh/host-html
/plugin install host-html@host-html

Claude Code 官方市场列表正在筹备中 — 在上线之前，请使用上面的两条命令直接从此仓库安装。

Claude Desktop、Cursor、Codex（MCP 服务）

// claude_desktop_config.json / .cursor/mcp.json / .mcp.json
{
  "mcpServers": {
    "host-html": {
      "command": "npx",
      "args": ["-y", "host-html-mcp"],
      "env": { "HOSTHTML_API_KEY": "hh_your_key_here" }
    }
  }
}

包含两个工具：publish_html（输入 HTML，输出链接）和 update_page（输入新的 HTML，链接保持不变）。 源代码和文档：mcp-server/ · npm：host-html-mcp

其他 AI Agent（技能）

npx skills add phanosh/host-html -g -y

然后使用这些技能：

/host-html          # publish HTML as a live link
/host-pdf           # export HTML slides to PDF

/host-html 会查找 HTML、发布页面，并在几秒内提供实时 URL。 /host-pdf 会以视网膜级画质捕获每张幻灯片，并将其合成为 PDF。

适用于 Claude Code、Cursor、Codex、Copilot，以及其他 40 多种 Agent。

---

设置：获取 API 密钥

现在发布需要一个免费的 host-html 账户：

1. 在 host-html.com 登录（免费）

2. 确认你的邮箱

3. 前往 账户 → API 密钥 → 创建密钥

4. 复制生成的密钥（以 hh_… 开头 — 仅显示一次）

5. 将其设为环境变量：

   export HOSTHTML_API_KEY=hh_your_key_here
   

技能会自动读取 HOSTHTML_API_KEY。自定义 slug（见下方的直接 API 表格）仍需 Pro/Team 方案；发布本身不需要。

---

更新

此处发布新版本后，使用以下命令将其拉取到本地 Claude Code：

/plugin marketplace update phanosh/host-html

这条命令会刷新市场目录，并安装 marketplace.json、plugin.json 或技能 frontmatter 中的任何版本更新。检查当前版本：

/plugin

若要自动保持最新，请打开 /plugin，前往 Marketplaces 选项卡，选择 phanosh/host-html，并开启 auto-update — 此后 Claude Code 会在启动时拉取更新。

对于独立技能安装（npx skills add ...），重新运行相同命令即可升级：

npx skills add phanosh/host-html -g -y

---

直接 API

发布边缘函数需要个人 host-html API 密钥（格式为 hh_…）作为 bearer token — 请参阅设置以生成密钥。通过 Authorization 标头传入（无需 apikey 标头）：

curl -X POST https://suifgsvtcbrawzdhyuhk.supabase.co/functions/v1/publish \
  -H "Authorization: Bearer $HOSTHTML_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"html": "<h1>Hello</h1>", "title": "my page"}'

请求

字段	类型	必填	说明
html	string	✓	HTML 内容（最大 1MB）
title	string		页面标题
slug	string		符合 ^[a-z0-9-]{2,64}$ 格式的自定义 URL 路径（付费方案）
password	string		为页面设置密码保护（4–72 个字符，付费方案，仅限 JSON 正文）

响应 201

{
  "url": "https://host-html.com/p/abc123",
  "slug": "abc123",
  "edit_token": "...",
  "page_id": "...",
  "has_password": false,
  "expires_at": "2026-03-16T..."
}

当请求设置了 password 时，has_password 为 true（页面已锁定并从私有存储提供）；否则为 false。

expires_at 的类型为 string | null。免费方案中，该字段是页面失效的 ISO 时间戳；付费方案中，页面永不过期，该字段为 null。它是权威的过期时间 — 请从响应中读取，而不要假定固定时长；并妥善处理 null，不要将其格式化为日期。

---

许可证

MIT