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

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

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

| レシピ | 販売するもの | スキル | サンプル |
| --- | --- | --- | --- |
| [API クレジット](https://pay.perly.io/docs/recipe-api-credits.md) | 前払いクレジット、リクエストごとに消費 | `sell-credits` | `api-credits` (Hono) |
| [SaaS サブスク](https://pay.perly.io/docs/recipe-saas-subscription.md) | 月額プラン、請求書で更新 | `sell-subscription` | `saas-subscription` (Next.js) |
| [ライセンスキー](https://pay.perly.io/docs/recipe-license-keys.md) | キーで開くアプリやプラグイン | `sell-license-keys` | `license-keys` (Node CLI) |
| [Telegram ボット](https://pay.perly.io/docs/recipe-telegram-bot.md) | 有料コマンド、ロール、グループ | `sell-bot-access` | `telegram-bot` (Node) |
| [有料 MCP サーバー](https://pay.perly.io/docs/recipe-paid-mcp-server.md) | 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。浮動小数点の端数は決して使いません。
- 自動請求はなし：更新もチャージも、購入者が自分のウォレットから支払う請求書です。