Agent Storefront

Clize

**Clize 是一个命令行工具和 MCP 服务，可为 AI 编码 Agent 提供真实世界的操作能力：域名、电子邮件、部署、支付和媒体生成。**你的 Agent 已经有了大脑——Clize 为它装上双手：一个域名、一个可用的收件箱、一个上线的网站。一个命令行工具（外加一个 MCP 服务），让 Claude Code / Codex 中的编码 Agent 能够注册域名、处理真实邮件、构建并发布网站和短片、生成媒体，以及向客户收款——无论你运行多少个项目，都能轻松应对。

→ clize.ai

安装

npm i -g @clize/clize
clize install          # wire clize into your coding agent (Claude Code / Codex)

clize install 这一步能让你的 Agent 真正主动使用 clize——仅仅把二进制文件放在 PATH 上，并不能让 Agent 知道它的存在。默认情况下，它会将 clize 的技能（何时使用以及安全限制）安装到每个 Agent 的技能目录中；这项技能很轻量——只有触发条件满足时，它的简短描述才会进入上下文。它会自动检测 Claude Code（~/.claude）、Codex（~/.codex）和 Pi（~/.pi）；Codex 和 Pi 共用开放的 ~/.agents/skills 目录，因此任何读取该目录的 Agent 都能获得这项技能。使用 --claude / --codex / --pi 指定范围，使用 --dry-run 预览。添加 --mcp 还能注册 clize-mcp 服务——此功能需选择启用，因为 MCP 服务的工具列表会在每次会话中一直占用上下文。

稍后只需运行一条命令即可更新——获取最新版本并同时刷新技能：

clize update            # or `clize update --check` to only check for a newer version

如果更新后某些内容看起来过时，clize doctor 会显示已安装的内容与实际运行的内容之间的差异——CLI 版本（以及适用于你的安装管理器的升级命令：volta / pnpm / asdf / …）、技能版本差异和控制平面的可连接状态。

默认情况下，输出为英文。设置 CLIZE_LANG=zh（或使用 zh* 系统区域设置）即可将 CLI、MCP 工具描述和控制平面消息切换为中文；词典位于 src/i18n/zh.ts。

快速入门（托管版）

登录即可开始——你的 Agent 全程无需接触 Cloudflare：

clize login                              # browser authorize; the first login creates your account
clize claim acme --email                 # free identity: acme.clize.app + [email protected]
clize init --handle acme                 # bind this directory (deploy / send / inbox infer the rest)
clize email inbox --wait-for "verify"    # give the new inbox a minute, then the agent signs up with [email protected] and reads the code here
clize status                             # who is waiting (real people + codes only), this month's spend
clize email send --to [email protected] --subject "Re: …" --text "…"   # queued for a one-tap approval in the console; --confirm sends now
clize deploy ./site                      # ship a static site → https://acme.clize.app

可运行示例（录制于 2026-10-01，包含耗时、成本和失败情况）

示例	功能	成本
01 · 首封验证邮件	安装 → 认领一个带收件箱的地址 → 读取验证码 → 将回复加入队列，等待真人批准	$0
02 · HTML → HTTPS → 你的域名	将一个包含三个文件的文件夹发布到 https://<slug>.clize.app，然后为其配置域名和邮箱	$0（另加域名费用，提前报价）
03 · 一个 SEO 循环	对真实网站运行 clize seo check → 根据数据进行两项修改 → 发布 → 按日期重新检查	$0

每个示例都使用 Clize 自己的账户和网站（自用），并非客户案例。

托管 — 只需登录

登录方式	各项服务运行的位置
clize login（网页：GitHub / Google / 电子邮件）——或在 CI / 无头环境中使用 clize login --token clize_…	命令会调用 clize 后端；资源运行在 clize 的基础设施上。你无需接触 Cloudflare / Vercel 密钥。

clize 是轻量客户端：CLI / MCP 不携带任何基础设施凭据，只与 clize 控制平面通信——域名、电子邮件、部署和媒体服务都由托管服务提供。（凭据保存在你的控制面板中；Cloudflare / Vercel 自带密钥需在控制面板中配置，而非在你的机器上配置。）

以下几点值得了解：

• clize deploy <dir> 和 clize email send 需要 --domain / --from——除非目录已使用 clize init --handle <slug> 绑定，此时会从 ./clize.json 自动推断两者。部署以目录为单位（支持多文件静态网站）。
• gen image --ref/--mask（图生图 / 图像修复 / 多图合成）支持托管运行——参考图数量上限取决于上游模型：gpt-image-2 为 16 张，nano-banana-2 为 14 张（视频 / veo 支持 3 张）；每张 ≤10 MB，总计 ≤80 MB。gpt-image-2 以异步任务运行（需要多张参考图的繁重任务可能需要几分钟——不会受同步管道超时限制）：CLI 默认等待（--timeout，默认 300 s），也可使用 --async，然后通过 gen status <id> 获取结果；每个任务生成一张图片（--n > 1 时会拆分），--mask 图像修复仅支持 nano-banana-2。gen budget 预先批准功能尚不支持托管运行：每次生成都需单独使用 --confirm 确认。
• 免费的 *.clize.app 句柄：使用 clize claim <slug>。自有域名：使用 clize domain buy / clize domain import。运行 clize check 验证登录状态。
• 免费层配额（防滥用，按租户计算）：3 个句柄 · 5 个邮箱 · 每天 10 次认领尝试 · 每天发送 30 封外发邮件 · 每天部署 20 次 · 每个站点 500 MB。任何充值都会将你升级到可信层（10 · 30 · 30 · 200 · 100 · 5 GB）。超过限额的调用会返回普通的 429 错误——不会产生任何费用。
• 部署目标可以是免费句柄，也可以是账户中的整个域名；你的域名下的子域名（blog.example.com）目前不能作为单独的部署目标。通过 clize domain buy 购买的域名会使用 Clize 的注册人联系信息在底层注册商处注册——如需成为登记在案的注册人，请在其他地方注册域名，再使用 clize domain import 导入。部分 ccTLD（.de .fr .es .jp .kr .com.br .uk .eu）无法通过 Clize 注册；clize domain tlds 会列出可注册的 555 个顶级域名。

它能做什么

领域	命令
身份	clize claim <slug> --email — 为你的 Agent 免费领取一个先到先得的身份：<slug>.clize.app（站点占位符）以及用于接收邮件的 support@<slug>.clize.app。不带 --email 时，只会获得名称和站点（之后运行 clize email setup <handle> 即可开通收件箱）——接收邮件是可选项，因为每个收件箱都会占用共享 clize.app 区域中的 4 条 DNS 记录，而该区域的容量就是整个平台免费句柄的总容量
域名	clize domain search / tlds / buy / import / list；clize domain check <domain> 按修复顺序检查六个层级 — 注册局委派（公共 DoH）→ Cloudflare 区域 → worker 绑定 → 内容 → 边缘 AI 爬虫策略（Cloudflare ai_bots_protection；自 2026-09-15 起，新区域默认阻止 AI 爬虫，而边缘层的阻止策略优先于任何 robots.txt）→ http→https（实际的 http:// 请求必须返回指向 https 的 301；clize 会在其部署、导入或注册到的每个区域启用 Cloudflare 的 Always Use HTTPS，domain canonicalize 也会这样做）
电子邮件	你的 Agent 用于注册服务并读取验证码的邮箱（clize email inbox [domain] --wait-for <text> 会轮询，直到邮件到达），以及真实用户写信给你的收件箱。clize email address add <addr> 可在你拥有的任意域名上一步开通邮箱（对象 + 收件功能）；每个域名可按需创建任意数量（ops@、sales@，或为每个 Agent、每个人各建一个）；--forward [email protected] 会将邮件转发到个人收件箱，--owner <member> 会将其设为某人的私人邮箱。任何已领取的句柄均可通过 clize email setup <handle> 开通 support@<slug>.clize.app（也可使用 clize claim <slug> --email）。通过 inbox（已分类：促销／通知／垃圾邮件会被过滤，--all 可显示全部邮件）／show／thread／search 读取邮件，通过 mark 修正分类，通过 send 发送邮件（--attach）。邮件会永久存储并建立索引。多用户：clize members invite [email protected] --mailbox alice@<domain> 允许用户登录并使用自己的邮箱；所有者／管理员可以查看账户中的每个邮箱。每个 Agent 独立密钥：clize email key create --scope read,send --address ops@<domain>。命令参考：clize.ai/docs/commands。
发件箱	不带 --confirm 运行交互式 clize email send 时，邮件会进入发件箱，而不会像草稿一样消失：用户可以在控制台（Home → needs you → Inbox）中批准或拒绝，也可以点击摘要邮件中的已签名单击链接操作；clize email pending 会列出待处理邮件，status 会显示其数量。长期允许列表（收件人或 @domain，每周上限为 5）只能在控制台中设置 — CLI 签发的密钥无法进行审批或设置允许列表，因此提示词注入无法为自身授予豁免。在上限内发送给允许列表中收件人的邮件无需 --confirm。
发送 API（可由服务端调用）	POST /v1/email/send — 从长期运行的后端（fly.io / cron）发送事务性邮件，采用 Resend/Postmark 风格，可从已接入 Clize 的域名发送（无需第二家邮件服务商）。使用作用域受限的发送密钥进行身份验证（clize_sk_…：仅可发送，可锁定到指定域名）— clize email key create/list/revoke。无需 --confirm（人工审核关卡仅适用于交互式 email send）。支持 Idempotency-Key、HMAC 签名的投递 Webhook（退信／投诉）、RFC 8058 单击退订 + 抑制列表（email delivery-webhook / suppressions / messages）。操作指南：使用作用域受限的密钥从后端发送邮件 · Webhook 和投递事件。
媒体	clize gen image / video / music — 文本→图像（gpt-image-2 / nano-banana-2，使用 --ref / --mask 进行图生图和图像修补）、文本／图像→视频（veo）、文本→音乐（suno）；长任务可通过 gen jobs / status 管理。每笔费用都必须通过 --confirm 确认（托管服务的 gen budget 预先批准功能已列入路线图）。结果会保存为本地文件，可直接用于 deploy 或 email --attach。
构建 · 站点（托管方法）	clize build site start <brief> — 托管式设计系统会先为你的 Agent 提供简明的统一风格说明，再由其编写站点，让页面呈现出品味，而不是充斥着 AI 模板的糟粕。之后可使用 build site recommend / list / get / search / review，以及 build site stack <stack> 获取特定技术栈的指导（React / Next / SwiftUI / …）。旧写法 clize design … 仍可用作隐藏别名。clize build site check <dir> [--live <origin>] 是免费的发布前 lint：检查门页式近重复内容（≥60% 的可见文本相同）和单薄页面、_redirects 目标（使用 --live 时会进行线上探测）、hreflang 互惠关系、FAQ 文本与 JSON-LD、canonical/noindex 冲突、站点地图收录情况 — 出错时以非零状态码退出。自 0.41.0 起，还会报告三项 GEO 警告（绝不会报错）：比较页面开头 200 个单词中没有提及你自己的产品、比较页面没有 <table>、内容页面没有可见日期或日期超过 12 个月。
构建 · 短片（托管方法）	clize build clip start <brief> → 你的 Agent 编写逐镜头蓝图 → build clip check（免费的本地 lint：连贯性、对白覆盖率、时长）→ build clip render --confirm（💰 汇总报价一次、批量生成 + 合并、可恢复）。一次性素材仍使用 gen video。
部署	clize deploy <dir> --domain <host> — 多文件静态站点；免费 *.clize.app 或你自己的域名。先用 clize serve <dir> 在本地预览（正确支持 Range — <video> 页面可在 Safari 中正常播放）。部署前会运行与 build site check 相同的检查 — 门页式近重复内容会阻止上传（使用 --allow-similar 可覆盖），上传后会对每条 _redirects 规则进行线上探测；检查结果会随部署输出一起提供，显示在 guards 中（包括 build site check 的三项 GEO 警告）。部署只会添加或覆盖：<dir> 中不存在的线上路径仍会保持在线，并列在回执的 orphans 下；--prune 会删除所有此类路径（--prune-under <prefix> 可将范围限制在一个子树内），而 clize site paths / clize site rm <path...> 可列出和删除单个线上路径。
SEO / GEO（托管数据）	clize seo keywords <seeds...> / competitors <domains...> / serp <keyword> — 无需密钥、注册或上游账户即可获取研究数据：搜索量 + 难度 + 意图（难度分级依据你实际能竞争的范围）、竞争对手依靠哪些内容，以及结果页上有哪些对象（由规则引擎给出 official_wall / definition_wall / listicle_window / open 判定，并列出值得争取收录的榜单文章）。自 0.40.0 起，serp 还会报告 AI Overview 引用了谁（aiOverviewCitations，每项附有引擎摘取的句子），以及 Google 在页面上展示了哪些问题（questions：People Also Ask + 相关搜索；`--questions-depth 1
项目	一个项目 = 一个目录：clize init --handle <slug> 可将其绑定（首次运行 claim / buy 时会自动创建项目记录）。使用 clize projects 列出项目，以及执行 new / move / rename / rm；使用 -p <slug> 进行单次跨项目调用。跨项目发送电子邮件会被阻止（409）；部署则会跟随目标域名 — 过时的 clize.json 检出目录会自动路由到该域名所属的实际项目（并回写 clize.json），只有显式指定不匹配的 -p 才会返回 409。status / 列表 / 费用统计会限定在当前检出的项目内，status 也会标记任何本地↔远程差异。
上下文	clize status [--assets]、clize context [address] — 在会话开始时重新载入等待处理事项 + 身份／知识
计费（托管）	clize balance / clize recharge --amount <usd> — 预付 clize 余额，域名／媒体费用从中扣除（通过 Stripe 充值）；使用 clize audit 查看费用日志
收款（托管）	clize pay link --amount <usd> — 无需配置即可向你的客户收款：默认情况下，款项会进入你的 clize 余额（无手续费 — 余额资金只能用于 clize 消费，不能提现）。直接付至你自己的 Stripe 账户（direct，clize 会收取费用）尚未在平台启用；启用后，在网页控制面板中连接 Stripe 即会自动切换付款方式。在此之前，--mode direct 会被拒绝，所有款项都会进入你的余额。clize pay status / clize pay list。
商店与表单（托管）	clize shop — 将已部署的站点转变为可收取真实款项的商店：商品存放在你部署的 _catalog.json 中，购物车通过 Stripe 结账，并基于已部署的商品目录进行服务端定价（客户端无法伪造价格）；支持一次性付款或订阅、收集收货地址，以及像 pay 一样选择 direct 或 balance 收款。clize 负责订单层 — clize shop orders / todo / fulfill / notify / refund / shipments / events / webhook / hook test（已付款 → 已采购 → 已发货 → 已送达，支持 17TRACK 物流追踪、买家在 /orders 自助服务；带有每个商店独立密钥的签名履约 Webhook、投递记录、自动重试和 --replay；shop hook test 可在首次销售前验证你的端点；成功页面会获得 ?order=cs_…，并提供公开状态端点）— 而商品目录随站点一同发布，库存、税费和运费则由你负责。clize data webhook 会将表单／候补名单提交内容转发到你的端点（clize 不会存储这些内容）。clize 提供的是命令界面、订单台账和支付接入，而不是 Shopify。
运行 clize --help 查看完整功能。

部署与网站托管

clize deploy <dir> 会上传多文件静态网站，并通过共享的 Cloudflare Worker 提供服务：小型热点文件由 KV 支持，大型资源由 R2 支持（而非 Workers Static Assets / Pages），并以 hostname + path 为键。你可以依赖以下行为：

• 未知路径 — 默认情况下，如果网站包含 404.html，则会返回该文件，并使用真正的 HTTP 404（这样失败或拼写错误的 URL 就不会被索引成重复的首页，这是符合 SEO 的做法）；如果没有 404.html，则将网站视为 SPA，请求会回退到 index.html（200）。可通过 --not-found <404-page|spa|none|auto>（auto 为默认值，行为正是上述检测逻辑）按部署覆盖此设置。
• 尾部斜杠 — /foo/ 会提供 /foo/index.html（200，不会 301 重定向）。
• 缓存 — 资源会以 cache-control: public, max-age=300 提供。
• 移除 — deploy 不会自行删除任何内容：目录中缺失的线上路径会继续保留，回执会在 orphans 下列出这些路径（KV 页面和小文件、R2 资源均包括在内）。clize deploy <dir> --prune 会在上传后移除所有孤立路径；--prune-under <prefix> 会将范围限制在一个子树中（适用于多台机器各自管理一个子树的网站）；clize site paths [domain] 会列出所有线上路径及其所在层；clize site rm <path...> 会移除单个路径（/dir/ 表示 /dir/index.html；也适用于 sitemap.xml / llms.txt）。移除的路径仍可能通过边缘缓存提供服务，最长 5 分钟。
• Cloudflare 约定文件 — 404.html 和 index.html 会控制上述未找到路径的行为。_redirects 会被解析（Cloudflare Pages 格式：from to [status]，支持 */:splat 和 :name 占位符；状态码默认为 302；3xx 会保留查询参数并重定向，其他状态码会重写到网站文件，只有外部目标才会重定向）；实际文件始终优先于规则（因此，若要对曾经发布过的页面执行 301，先用 clize site rm 或 deploy --prune 移除该页面，再添加规则）；该文件本身永远不会被提供；deploy 会在上传后实时探测每条规则（guards.redirects）。_headers 仍会存储，但不会生效。
• 大小 — 大型资源（≥128 KB）存储在 R2 中，小型热点文件存储在 KV 中，因此单个文件可流式传输至约 90 MB，网站理论上可达 5 GB。免费层级的政策上限为：每个网站 500 MB，每天上传 2 GB；任意充值都会将你提升至可信层级（每个网站 5 GB，每天 20 GB）。上传内容会按哈希去重，重新部署时只会发送变更文件。
• 路由与回写 — 部署会使用你传入的域名（或 clize.json 中的域名）；它会关联该域名实际对应的项目，并将解析出的 project（以及自定义域名）写回 clize.json，这样重复部署时就不会发生偏移或返回 409。

默认安全机制

• 💰 消费门禁 — 付费操作（clize domain buy、clize gen image/video/music）必须带上 --confirm 才会执行；不带该参数时只会提供报价。
• 📨 身份门禁 — 以你的身份回复真实客户时，流程始终为 草稿 → 人工批准 → 发送，绝不会自动发送。
• 📥 入站内容不可信 — 收到的邮件会被视为数据，而非给 Agent 的指令。

这些门禁以纯文本方式运行，因此每笔支出和每项外发操作都会显示在 Agent 的记录中。

MCP

精选的核心功能子集——认领、域名与 DNS、邮件（包括待审批发件箱）、部署、商店与表单、状态/上下文、账单、收集（pay）——以 33 个 MCP 工具的形式提供，适用于偏好结构化工具而非 shell 的宿主。（媒体生成、SEO/GEO 和 build 方法包仍由 CLI 和技能驱动，而非 MCP 工具：能运行 shell 的 Agent 可以通过 clize 使用这些功能。）需选择启用（clize install --mcp），因为 MCP 服务的工具列表会持续占用每个会话的上下文；仅使用技能就已经可以让 Agent 通过 CLI 操控 clize。手动注册：

claude mcp add clize -- clize-mcp     # Claude Code
codex mcp add clize -- clize-mcp      # Codex

两种模式均可使用——在服务的环境中设置 CLIZE_API_KEY（也可选设置 CLIZE_API_URL）即可运行托管模式。

一次只加载一个产品线 — clize-mcp --profile

每次会话中，33 个工具都会占用上下文，即使你只需要收件箱。--profile <line> 会启动同一个服务，但只注册该产品线的工具——这些工具不会出现在 tools/list 中，而不是注册后再隐藏，因此跳过的工具不会占用主机的任何资源：

claude mcp add inbox -- clize-mcp --profile inbox      # 14 tools instead of 33

配置档只会减少工具：不同配置档中的工具名称、参数和行为完全相同，因此切换配置档不会让 Agent 需要重新熟悉工具。serverInfo.name 会变为 clize-<line>，让主机显示当前连接的产品线。不使用 --profile 时，一切保持不变——全部 33 个工具，serverInfo.name = clize，这也是 clize install --mcp 仍会注册的名称。未知值会以非零状态码退出，并列出有效值，而不是悄悄提供完整工具集（静默回退会在你以为安装了子集时，却交给你 33 个工具）。

每条产品线都安装同一个包 @clize/clize，并通过 --profile 选择工具子集：

产品线	--profile	工具（每个配置档都包含 status / balance / recharge）
Agent Inbox — 真正的收件箱，Agent 可以通过它发送和接收邮件（clize.ai/inbox/）	inbox	14 个 — claim、email setup / address add / inbox (with wait-for) / thread / search / show / mark / send / pending、context
Agent Storefront — 让你的 Agent 运营真正的商店	storefront	15 个 — pay、shop status / orders / order / todo / fulfill / notify / refund / events / shipments / webhook、data webhook
Sites by Clize — 真正上线的营销网站	sites	5 个 — claim、deploy
Agent Domains — Agent 可以购买、指向和监控的域名	domains	9 个 — domain search / buy / ns、dns list / set / rm

deploy 仅属于 sites，而 media / build 完全没有 MCP 工具——如需使用完整工具集，请在不带 --profile 的情况下运行服务。配置档是上下文预算，而非权限边界：资金 / 身份 / 不可信入站内容的限制保持不变；如需真正限制密钥的操作权限，请使用受限密钥（受限密钥）。安装 CLI 的方式仍为 npm i -g @clize/clize——npm 不会将依赖包的二进制文件链接到你的 PATH，因此各产品线的独立包仅用于发现和通过 npx 运行：

claude mcp add inbox -- npx -y -p @clize/clize clize-mcp --profile inbox

MCP 注册表中只列出一个服务 ai.clize/clize；产品线通过 --profile 指定，而非单独的包。

指南与使用场景

分步设置：

• 将 Clize 添加为 Claude Code 的 MCP 服务 · 添加到 Codex CLI
• 什么是操作型 MCP 服务（与只读服务有何不同）

Agent 实际会用它做什么：

• 发送真实邮件——从待审批发件箱中放行
• 让 Agent 将 HTML 文件发布到网上——附带记录在案的真实运行过程
• 注册服务时通过邮件验证——从安装到首段代码，附计时记录
• 整理支持收件箱中的邮件，起草待你审批的回复
• 在资金限制机制后创建 Stripe 付款链接
• 以编程方式注册域名——五个步骤、真实报价和限制
• 在我们自己的网站上完成一次真实的 SEO 循环：检查、两项更改和复查日期

许可证

MIT