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 キーを取得する（手動での作業は 1 回だけ、約 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 の新製品としてアップロードして、ブログ用のローンチ記事を書き、X で共有できる 15% オフのリンクを作って。」

30 種類のツールを利用できます：製品（作成／更新／公開／アップロード）、自分専用のライセンスキープール、ブログ記事、クーポン、チェックアウトリンク、ライセンス、注文、販売統計、Getly Billing のプランとサブスクリプション、カテゴリ検索、Pay Widget コード。破壊的な操作には明示的な確認が必要なため、プロンプトインジェクションを受けたレビューによってストアを破壊されることはありません。npx @getly/mcp init を実行すると、Claude Code／Cursor／Claude Desktop／Windsurf 用の設定が自動で作成されます。

📦 パッケージ内容

パッケージ	内容
@getly/sdk	依存関係ゼロの TypeScript クライアントです。冪等性キーの自動生成、レート制限に応じたバックオフ、1 回の呼び出しで完了する 2GB アップロード、Webhook 署名の検証、カーソルイテレーターに対応しています。
@getly/mcp	上記の MCP サーバーです。init コマンドを備え、Smithery に対応しています。
@getly/nextjs	Next.js 用の Checkout() と Webhooks() のルートハンドラーです。Polar スタイルの簡潔な実装で利用できます。
@getly/auto-store	フォルダーから実店舗を作成する CLI です（Claude を利用）。
create-getly-store	npx create-getly-store my-shop を実行すると、Getly ストアと連携したデプロイ可能な Next.js ストアフロントが作成されます。
examples/	Telegram 販売ボット（チャット内で販売し、支払いを確認）、依存関係不要のストアフロントウィジェット、1 行で設置できる Pay Widget の購入ボタンです。
Pay Widget	<script> を 1 つ設置して購入ボタンを追加するだけで、あらゆるサイトに購入手続き（購入者のメールアドレスと PayPal または USDT/USDC）を追加できます。ブラウザーに API キーを置く必要も、販売者が決済アカウントを用意する必要もありません。ファイルは Getly が配信します。
openapi/getly-v1.yaml	API 全体を OpenAPI 3.1 で記述した仕様です。すべての操作にサンプルが含まれています。getly.store/openapi.yaml でも提供しています。
llms.txt	AI が読み込める 1 つのファイルにまとめた、API リファレンス全体です。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>を1つと<div>を1つ配置するだけで、「購入」ボタン付きの商品が表示されます。ブラウザーにAPIキーを置く必要は一切ありません。
• 決済ウィジェット — <script>を1つと「購入」ボタンを配置するだけで、あらゆるサイトを単一商品のチェックアウトにできます。購入者はメールアドレスを入力し、PayPalまたはUSDT/USDCで支払います。Getlyがファイルを配布し、領収書と返金にも対応します。詳しいガイドはdocs/pay-widget.mdをご覧ください。
• Reactスニペット — 生成アプリ向けの<GetlyStorefront/>と<GetlyBuyButton/>をコピー＆ペーストできます。v0/Lovable/Bolt向けのすぐに使えるプロンプトもあります。

🗺 ロードマップ

ホスト型リモートMCP（mcp.getly.store、OAuth — ローカル設定なしでclaude.ai/ChatGPTから接続） · テストモードAPIキー · 商品の一括処理エンドポイント · getly_sk_live_キー向けGitHubシークレットスキャンの提携 · デバイスコードによるCLIログイン · Python SDK（協力者募集中）。

🔐 セキュリティについて

キーはgetly_sk_live_…形式で、スコープが設定され、24時間の猶予期間を設けてローテーションできます。環境変数に保存してください。ここにあるすべてのツールは、それ以外の方法でキーを受け付けません。Webhookはタイムスタンプ付きでHMAC署名されます（SDKのverifyWebhookSignature）。MCP サーバーは破壊的な操作を行うツールに注釈を付け、確認を必須にします。詳しいガイダンスはAGENTS.mdをご覧ください。

コントリビューションとコミュニティ

質問 → GitHub Discussions。バグやアイデア → issues。開発環境のセットアップと最小依存関係の方針 → CONTRIBUTING.md。何か作りましたか？SHOWCASE.mdに追加してください。

MIT。たくさん販売しましょう。🟢