ガイド

AI アシスタント向けレシピ

API、SaaS プラン、アプリ、ボット、MCP ツールを、コードを書くアシスタントへのリクエストひとつで暗号資産で販売。

アシスタントに「API クレジットを USDC で買えるようにして」と頼めば、正しく作ってほしいものです：まずテストモード、署名付き Webhook、支払いの完了後にだけアクセス。このレシピがそれを教えます。どれもひとつの元から作られた Claude Code のスキル、Cursor のルール、AGENTS.md 用のブロックで、さらに実際に動かせる小さなアプリが付きます。費用はかかりません：あなた自身のキーで Perly Pay を呼ぶ、プロジェクト内のファイルです。

レシピ	販売するもの	スキル	サンプル
API クレジット	前払いクレジット、リクエストごとに消費	`sell-credits`	`api-credits` (Hono)
SaaS サブスク	月額プラン、請求書で更新	`sell-subscription`	`saas-subscription` (Next.js)
ライセンスキー	キーで開くアプリやプラグイン	`sell-license-keys`	`license-keys` (Node CLI)
Telegram ボット	有料コマンド、ロール、グループ	`sell-bot-access`	`telegram-bot` (Node)
有料 MCP サーバー	MCP ツール、呼び出しごとにクレジット	`paid-mcp-tools`	`paid-mcp-server` (MCP SDK)

ほかにスキルが 3 つ：あらゆる一回払いの販売のための add-crypto-checkout、各フレームワークで正しい Webhook のルートを書く verify-webhooks、支払いのシミュレーションと本物のお金への切り替えのための test-and-go-live。

Claude Code

bash

claude plugin marketplace add volodymyrslipak/perly-pay-ai && claude plugin install perly-pay@perly

あとは普通の言葉で頼むか、スキルを呼び出します：/perly-pay:sell-credits。

Cursor

プラグインの cursor/rules/*.mdc をプロジェクトの .cursor/rules/ にコピーします。perly-pay.mdc にルールがあり、各レシピには、その話題になったときに読み込まれる専用ファイルがあります。

AGENTS.md

プラグインの AGENTS-snippet.md を自分の AGENTS.md に貼ります（Codex、Jules、Copilot、Zed、Cursor などが読みます）。BEGIN perly-pay と END perly-pay の間にあるため、更新時は丸ごと置き換わります。

どのアシスタントでも

どのアシスタントでも使えるスキルは /.well-known/skills/index.json に一覧があります。ドキュメントの各ページは Markdown でも読めます — アドレスに .md を付けるか、/llms-full.txt でまとめて読んでください。

すべてのレシピが守ること

まずテストモード：sk_test_… キーと invoices.simulate。本物のお金は動きません。
シークレットキーはサーバーの PERLY_PAY_SECRET_KEY に置きます。配布するアプリは、キーなしでライセンスを検証します。
アクセスは invoice.fulfilled か entitlements.check でのみ — 支払いからの戻りや invoice.paid では決して開きません。
Webhook は生のボディで検証し、各イベントは一度だけ処理します。
クレジットの消費など、繰り返される可能性のあるものにはすべて冪等キーを。
金額はセント単位、USD か EUR。浮動小数点の端数は決して使いません。
自動請求はなし：更新もチャージも、購入者が自分のウォレットから支払う請求書です。