内容
<div align="center">
**给你的AI助手一个API密钥。 获取一个运行的数字产品业务。**
产品 · 卡 + 加密货币结账 · 文件交付 · 许可证密钥 · 博客 · 付款 — 所有这些都由API、SDK或MCP驱动。
[](https://github.com/Getly-Store/headless-sdk/actions/workflows/ci.yml)
[](LICENSE)
[](https://www.getly.store/developers)
[快速开始](#快速开始) · [MCP](#-mcp--你的AI运行商店) · [软件包](#-软件包) · [定价诚实](#-费用-无隐藏条款) · [示例](#-示例)
</div>
---
## 30秒版本
你是一名优秀的编码者。你使用Cursor、Claude、Copilot、v0、Lovable等工具构建项目。你有值得出售的产品——模板、代码、提示、课程、音乐等——但你不想构建购物车、Webhook、税安全支付流程、文件CDN和付款渠道。
**Getly就是那个后端，已经在运行。** 这个仓库是你的AI驱动商店所需的一切：
```bash
# 将AI指向一个文件夹。 获取一个实时产品 + 一个销售博客帖子 + 一个付款链接。
npx @getly/auto-store ./my-icon-pack --dry-run
```
在这一条命令背后：Claude读取你的文件夹，编写一个诚实的商品列表和SEO文章，上传你的文件（最多2GB），发布到一个拥有708个类别的市场，并给你一个接受**信用卡和USDT/USDC**的结账链接，同时处理交付、收据和许可证密钥。
> 🎬 *Demo GIF 即将到来 - 运行上述命令并添加 `--dry-run` 参数即可看到计划而不进行任何写入操作。*
## 快速开始
**1. 获取API密钥** （一步手动操作，约2分钟）： [getly.store/dashboard/developer/keys](https://www.getly.store/dashboard/developer/keys) → 创建一个具有所需权限的密钥。
**2. 出售你的第一个产品：**
```ts
import { Getly } from '@getly/sdk';
const getly = new Getly(); // 从环境变量中读取GETLY_API_KEY
const product = await getly.products.create({
name: 'Neon UI Kit',
priceCents: 1900, // 金额始终为整数分
shortDescription: '120个适用于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); // → 分享它。 Getly处理结账 + 交付。
```
**3. 在对话中出售** （机器人、支持聊天、任何地方）：
```ts
const link = await getly.checkoutLinks.create({
productId: product.id,
couponCode: 'FRIENDS20',
reference: chatId, // 在sale.completed Webhook中回显
});
// → link.url — 买家可以使用信用卡或加密货币支付，无需Getly账户。
```
更喜欢使用curl吗？完整的复制粘贴流程及预期响应： **[getly.store/developers](https://www.getly.store/developers)**。
## 🤖 MCP — 你的AI运行商店
其他人都不提供的部分。 将Getly添加到Claude Code：
```bash
claude mcp add getly --env GETLY_API_KEY=your_key -- npx -y @getly/mcp
```
或Cursor（`.cursor/mcp.json`）：
```json
{ "mcpServers": { "getly": { "command": "npx", "args": ["-y", "@getly/mcp"], "env": { "GETLY_API_KEY": "your_key" } } } }
```
现在这是一个对话，而不是编码会话：
> *"将~/designs/spring-pack中的所有内容上传为一个新产品，价格为24美元， 为我的博客撰写一篇文章，并给我一个可以分享给X的15%折扣链接。*
18种工具：产品（创建/更新/发布/上传）、博客帖子、优惠券、结账链接、许可证、销售统计、类别搜索。破坏性操作需要明确确认 — 注入提示的审查不能摧毁你的商店。 `npx @getly/mcp init` 为Claude Code / Cursor / Claude Desktop / Windsurf 编写配置文件。
## 📦 软件包
| 软件包 | 功能 |
|---|---|
| [`@getly/sdk`](packages/sdk-js) | 零依赖TypeScript客户端。自动幂等密钥、速率限制感知退避、一次性2GB上传、Webhook签名验证、游标迭代器。 |
| [`@getly/mcp`](packages/mcp) | 上面的MCP服务器。 `init`命令，适用于Smithery。 |
| [`@getly/nextjs`](packages/nextjs) | `Checkout()` + `Webhooks()`路由处理程序 — Polar风格的Next.js一行代码。 |
| [`@getly/auto-store`](packages/auto-store) | 文件夹 → 直播商店CLI（Claude驱动）。 |
| [`create-getly-store`](packages/create-getly-store) | `npx create-getly-store my-shop` → 一个可部署的Next.js商店前端，连接到你的Getly商店。 |
| [`examples/`](examples) | Telegram销售机器人（在聊天中销售，确认付款），依赖项免费的商店前端小部件。 |
| [`openapi/getly-v1.yaml`](openapi/getly-v1.yaml) | 整个API，OpenAPI 3.1，每个操作都有示例。在[getly.store/openapi.yaml](https://www.getly.store/openapi.yaml)上也有提供。 |
| [`llms.txt`](llms.txt) | 整个API引用作为一个文件，你的AI可以理解。 在[getly.store/llms-api.txt](https://www.getly.store/llms-api.txt)上也有提供。 |
| [`AGENTS.md`](AGENTS.md) | 黄金提示：粘贴到Cursor/ChatGPT，你的AI在第一次尝试中正确使用API。 |
## 💸 费用（无隐藏条款）
Getly收取**每次销售的20%** — 而且这就是唯一的数字。 无月费、无列表费、无文件托管费、无支付网关设置。
| | **Getly（全包20%）** | 典型的支付API堆栈（4–10% + 固定） |
|---|---|---|
| 支付处理（信用卡） | ✅ 包含 | ✅ 那是4–10% |
| **加密货币结账 + 加密货币付款** （USDT/USDC，5个链） | ✅ 包含 | ❌ |
| 文件托管 + 交付最高2GB | ✅ 包含 | ❌ 自带S3/CDN |
| **市场流量** （708类别目录，搜索，AI推荐） | ✅ 包含 | ❌ 你带来100%的流量 |
| 许可证密钥发布 + 验证API | ✅ 包含 | 变化 |
| 关联网络 + 推荐计划 | ✅ 包含 | ❌ |
| 拒付、收据、退款管道 | ✅ 处理 | 部分 |
| 固定月成本 | **$0** | $0–29+ |
**新卖家在前3个月保留90%的销售额。** 如果你已经有受众并且只需要支付渠道，4%的API可能更便宜 — 我们宁愿在这里告诉你，而不是让你发现时感到愤怒。 税务说明：Getly处理支付、交付、退款和拒付；卖家仍然负责自己的收入/增值税义务（[详情](https://www.getly.store/faq)）。
## 🌍 为什么构建者选择Getly
- **加密货币付款，无需银行。** USDT/USDC在Ethereum/Tron/BSC/Polygon/Solana上，每月支付两次。 如果Stripe不为你的国家提供服务，我们仍然提供。
- **访客结账。** 你的买家使用电子邮件和信用卡支付 — 无需强制账户创建来杀死你的转化率。
- **MCP优先。** 不是“我们有一个API” — 你的AI助手有**工具**。
## ⚙️ 诚实的启动
"完全AI管理"的确有**3个人步骤**，总共约5分钟：
1. 在[getly.store](https://www.getly.store)注册（Google/GitHub/神奇链接）。
2. 创建API密钥 → [dashboard/developer/keys](https://www.getly.store/dashboard/developer/keys)（如果需要，自动创建你的商店）。
3. 要获得**付款**：点击一个Stripe onboarding链接 **或** 粘贴一个加密货币钱包地址（`POST /api/v1/store/payout-onboarding`返回链接 — 甚至此步骤也是API驱动的）。
之后的一切 — 产品、博客、折扣、结账链接、许可证 — 都是你的AI的工作。
## 🧪 无需资金测试资金流
创建一个$0产品（或100%折扣券），运行完整的结账链接 → 访客结账 → `sale.completed` Webhook循环，免费，然后切换到真实价格。 配方在[AGENTS.md](AGENTS.md#test-without-money)。
## 📚 示例
- [**Telegram销售机器人**](examples/telegram-sales-bot) — 在聊天中销售你的目录，发送支付链接，在线程中确认付款。 “AI在对话中成交”演示，在笔记本电脑上运行。
- [**商店前端小部件**](examples/storefront-widget) — 任何网站（v0、Lovable、Webflow、纯HTML）上的一个`<script>` + 一个`<div>` 渲染你的产品并带有购买按钮。 浏览器中永远不需要API密钥。
- [**React代码片段**](docs/react-snippets.md) — 复制粘贴`<GetlyStorefront/>`和`<GetlyBuyButton/>`以生成的应用，以及[v0/Lovable/Bolt的现成提示](docs/v0-lovable-prompt.md)。
## 🗺 路线图
托管远程MCP（`mcp.getly.store`，OAuth — 从claude.ai/ChatGPT连接，无需本地配置） · 测试模式API密钥 · 批量产品端点 · GitHub秘密扫描合作伙伴，用于`getly_sk_live_`密钥 · 设备代码CLI登录 · Python SDK（[帮助 wanted](https://github.com/Getly-Store/headless-sdk/issues)）。
## 🔐 安全，简而言之
密钥为`getly_sk_live_…`，范围限定，可旋转，带有24小时宽限期，属于环境变量 — 这里的每个工具都拒绝接受其他方式。 Webhook具有HMAC签名和时间戳（`verifyWebhookSignature`在SDK中）。 MCP服务器注释破坏性工具并要求确认。 完整指南： [AGENTS.md](AGENTS.md#security-rules)。
## 贡献与社区
问题 → [GitHub Discussions](https://github.com/Getly-Store/headless-sdk/discussions)。 错误/想法 → [issues](https://github.com/Getly-Store/headless-sdk/issues)。 开发设置和最小依赖项策略 → [CONTRIBUTING.md](CONTRIBUTING.md)。 构建了什么？ 添加到 [SHOWCASE.md](SHOWCASE.md)。
MIT。 卖得好。
