Getly

---

30 秒了解

你是一名氛围编程者。你使用 Cursor、Claude、Copilot、v0、Lovable 构建产品。你有值得出售的东西 — 模板、代码、提示词、课程、音乐 — 却完全不想搭建购物车、webhook、符合税务规定的支付流程、文件 CDN 和收款通道。

Getly 就是这个已经运行起来的后端。 这个仓库包含了 AI 驱动它所需的一切：

# Point AI at a folder. Get a live product + a selling blog post + a pay link.
npx @getly/auto-store ./my-icon-pack --dry-run

在这一条命令背后：Claude 会读取你的文件夹，撰写真实的产品列表和 SEO 文章，上传你的文件（最大 2GB），将产品发布到拥有 708 个分类的市场，并提供一个接受银行卡和 USDT/USDC的结账链接 — 商品交付、收据和许可证密钥都由它处理。

🎬 演示 GIF 即将推出 — 运行上面的命令并添加 --dry-run，即可查看计划，而不会写入任何内容。

快速入门

1. 获取 API 密钥（一个手动步骤，约 2 分钟）：getly.store/dashboard/developer/keys → 创建一个具有所需作用域的密钥。

2. 出售你的第一个产品：

import { Getly } from '@getly/sdk';

const getly = new Getly(); // reads GETLY_API_KEY from env

const product = await getly.products.create({
  name: 'Neon UI Kit',
  priceCents: 1900,                    // money is ALWAYS integer cents
  shortDescription: '120 dark-mode components for Figma',
});

await getly.products.uploadFile(product.id, {
  fileName: 'neon-ui-kit.zip',
  data: await fs.readFile('./neon-ui-kit.zip'),
});

const live = await getly.products.publish(product.id);
console.log(live.urls.buy); // → share it. Getly handles checkout + delivery.

3. 在对话中销售（机器人、客服聊天，任何场景）：

const link = await getly.checkoutLinks.create({
  productId: product.id,
  couponCode: 'FRIENDS20',
  reference: chatId,            // echoed back in the sale.completed webhook
});
// → link.url — buyer pays with PayPal or USDT/USDC, no Getly account needed.

更喜欢使用 curl？完整的复制粘贴流程和预期响应请见：getly.store/developers。

🤖 MCP — 让你的 AI 运营商店

这是其他人都没有提供的功能。将 Getly 添加到 Claude Code：

claude mcp add getly --env GETLY_API_KEY=your_key -- npx -y @getly/mcp

或者添加到 Cursor（.cursor/mcp.json）：

{ "mcpServers": { "getly": { "command": "npx", "args": ["-y", "@getly/mcp"], "env": { "GETLY_API_KEY": "your_key" } } } }

现在，这是一场对话，而不是编码会话：

“把 ~/designs/spring-pack 里的所有内容上传为一个售价 $24 的新产品，为我的博客写一篇发布文章，再给我一个 15% 折扣链接，让我可以分享到 X。”

30 个工具：产品（创建/更新/发布/上传）、你自己的许可证密钥池、博客文章、优惠券、结账链接、许可证、订单、销售统计、Getly Billing 方案和订阅、分类搜索、Pay Widget 代码。破坏性操作需要明确确认 — 被提示词注入的评论无法毁掉你的商店。npx @getly/mcp init 会为你写入 Claude Code / Cursor / Claude Desktop / Windsurf 的配置。

📦 包含内容

软件包	功能
@getly/sdk	零依赖 TypeScript 客户端。自动生成幂等键、根据速率限制智能退避、一次调用即可上传 2GB 文件、验证 Webhook 签名、支持游标迭代器。
@getly/mcp	上述 MCP 服务。包含 init 命令，可用于 Smithery。
@getly/nextjs	Checkout() + Webhooks() 路由处理程序——为 Next.js 提供类似 Polar 的单行调用。
@getly/auto-store	将文件夹转化为在线商店的 CLI（由 Claude 驱动）。
create-getly-store	npx create-getly-store my-shop → 创建可部署的 Next.js 店面，并连接到你的 Getly 商店。
examples/	Telegram 销售机器人（在聊天中销售并确认付款）、零依赖店面组件、一行代码即可添加的 Pay Widget 购买按钮。
Pay Widget	只需一个 <script> + 一个购买按钮，即可为任何网站添加结账功能（买家邮箱 + PayPal 或 USDT/USDC）——浏览器中无需 API 密钥，卖家无需支付账户。Getly 负责交付文件。
openapi/getly-v1.yaml	完整 API，采用 OpenAPI 3.1，每个操作均附有示例。也可通过 getly.store/openapi.yaml 访问。
llms.txt	将完整 API 参考整合为一个文件，供 AI 读取。也可通过 getly.store/llms-api.txt 访问。
AGENTS.md	黄金提示词：粘贴到 Cursor/ChatGPT，AI 就能一次性正确使用 API。

💸 费用说明（没有隐藏条款）

通过此 SDK 带来的销售——API 结账链接、自有网站上的 Pay Widget、你的 Telegram 商店——都属于**你自己的流量：Getly 收取 10%，你保留 90%。始终如此。**由 Getly 市场带来的销售，费率从 20% 起，并随销量下降（根据上月销售额，分别为 17% / 15% / 12%）。无月费、无上架费、无文件托管费、无需配置支付网关。包含实时计算器的完整费率说明：getly.store/pricing。

	Getly（自有流量全包费率 10%）	典型支付 API 方案（4–10% + 固定费用）
支付处理（PayPal、加密货币；银行卡支付恢复后提供）	✅ 已包含	✅ 即 4–10% 费率
加密货币结账（USDT/USDC，5 条链）+ 稳定币提现（BSC 或 Tron）	✅ 已包含	❌
文件托管 + 最大 2GB 文件交付	✅ 已包含	❌ 需自行准备 S3/CDN
市场流量（708 个类别的商品目录、搜索、AI 推荐）	✅ 已包含	❌ 流量需全部自行获取
许可证密钥签发 + 验证 API	✅ 已包含	因情况而异
联盟网络 + 推荐计划	✅ 已包含	❌
拒付、收据、退款流程	✅ 已处理	部分处理
固定月费	$0	$0–29+

**新卖家在最初 3 个月内，所有销售都可保留 90%。**还有一个坦诚的旧提醒——「如果你只需要支付通道，4% 的 API 可能更便宜」——在自有流量费率降至 10% 后，基本已不再适用：全包费率为 10%（包含支付处理、托管、交付、加密货币、许可证和拒付），而另一种方案是 4–10% + 固定费用，且以上所有事项都要由你自行处理，因此只用支付通道的方案如今很少更划算。我们仍希望你先算清楚，而不是气愤地发现这一点。税务说明：Getly 负责付款、交付、退款和拒付；卖家仍需自行承担所得税/VAT 义务（详情）。

🌍 开发者为何真正选择 Getly

• 稳定币结算，无需银行账户。 在 BNB Smart Chain 上使用 USDT/USDC（最低 $5），或在 Tron 上使用 USDT（最低 $15），每月 1 日和 15 日付款——无论你身在何处。
• 访客结账。 买家只需提供邮箱并使用 PayPal 或加密货币付款——无需强制创建账户，不会因此损失潜在客户。（银行卡结账目前已暂停，恢复后会自动重新启用。）
• 交付你自己的许可证密钥。 将密钥上传到产品密钥池（getly.products.keys.add）；每笔销售都会发放下一个密钥，sale.completed 会通过 items[].licenseKey 携带该密钥。
• 为你自己的 SaaS 提供订阅。 Getly Billing 可为运行在你自己网站上的产品销售定期套餐——托管式结账、billing.* Webhook，以及 SDK 中的 getly.billing。
• MCP 优先。 不是“我们有 API”——而是你的 AI 助手拥有工具。

⚙️ 诚实地完成初始设置

“完全由 AI 管理”确实只需 3 个步骤由人工完成，总计约 5 分钟：

1. 在 getly.store 注册（Google/GitHub/魔法链接）。
2. 创建 API 密钥 → dashboard/developer/keys（如果需要，会自动创建你的商店）。
3. 想要收款：在 dashboard/settings → Payments 保存 USDT/USDC 钱包（BNB Smart Chain 或 Tron）。

之后的一切——产品、博客、折扣、结账链接、许可证——都由你的 AI 负责。

🧪 无需花钱即可测试资金流

创建一个 $0 产品（或使用 100% 折扣优惠券），免费运行完整的结账链接 → 访客结账 → sale.completed Webhook 流程，然后再启用实际价格。操作指南见 AGENTS.md。

📚 示例

• Telegram 销售机器人 — 在聊天中销售你的商品目录、发送付款链接，并在对话中确认付款。这是“AI 在对话中促成交易”的演示，可在笔记本电脑上运行。
• 店面组件 — 在任何网站（v0、Lovable、Webflow、纯 HTML）中添加一个 <script> 和一个 <div>，即可呈现带有购买按钮的产品。浏览器中绝不会出现 API 密钥。
• 付款组件 — 一个 <script> 加一个购买按钮，即可将任何网站变成单个产品的结账页面。买家输入邮箱并使用 PayPal 或 USDT/USDC 付款；Getly 会交付文件并处理收据和退款。完整指南见 docs/pay-widget.md。
• React 代码片段 — 为生成式应用复制粘贴 <GetlyStorefront/> 和 <GetlyBuyButton/>，并提供 适用于 v0/Lovable/Bolt 的现成提示词。

🗺 路线图

托管式远程 MCP（mcp.getly.store，OAuth — 无需本地配置即可从 claude.ai/ChatGPT 连接）· 测试模式 API 密钥 · 批量产品端点 · 与 GitHub 合作扫描 getly_sk_live_ 密钥 · 设备码 CLI 登录 · Python SDK（欢迎协助）。

🔐 简要说明安全性

密钥格式为 getly_sk_live_…，具有作用域，可轮换并提供 24 小时宽限重叠期，且应保存在环境变量中——此处的每个工具都拒绝以其他方式接收密钥。Webhook 使用带时间戳的 HMAC 签名（SDK 中的 verifyWebhookSignature）。MCP 服务会标注破坏性工具并要求确认。完整指南：AGENTS.md。

贡献与社区

问题 → GitHub Discussions。错误/想法 → issues。开发环境设置和最小依赖策略 → CONTRIBUTING.md。做出了什么？添加到 SHOWCASE.md。

MIT。祝销售顺利。🟢