# وصفات لمساعدي الذكاء الاصطناعي

> بِع واجهة API، أو خطة SaaS، أو تطبيقًا، أو بوتًا، أو أدوات MCP بالعملات المشفرة بطلب واحد إلى مساعد يكتب الكود.

اطلب من مساعدك «دع الناس يشترون رصيد API بـ USDC» — ويجب أن ينفّذ ذلك بشكل صحيح: وضع الاختبار أولًا، وويب هوك موقّع، والوصول فقط بعد دفع مُنفَّذ. هذه الوصفات تعلّمه ذلك. كل وصفة مهارة لـ 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) |

ومعها ثلاث مهارات أخرى: `add-crypto-checkout` لأي بيع لمرة واحدة، و`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` أبدًا.
- يُتحقق من الويب هوك على الجسم الخام، ويُعالَج كل حدث مرة واحدة.
- مفاتيح عدم التكرار على كل ما قد يتكرر، مثل استهلاك الرصيد.
- المبالغ بالسنتات، بالدولار الأمريكي أو اليورو. لا كسور عشرية عائمة أبدًا.
- لا خصم تلقائي: التجديدات والشحنات فواتير يدفعها المشتري من محفظته.