

تفترض معظم تكاملات واجهة برمجة التطبيقات وجود إنسان في الحلقة. تم بناؤها حول الحسابات، وتدفقات OAuth، والمفاتيح المسبقة الإصدار، وواجهات الدفع لأن البرمجيات التي تحتاج إلى شراء شيء ما لم يكن لديها حتى وقت قريب طريقة نظيفة للقيام بذلك بمفردها.
هذا يتغير. ما يسميه الناس التجارة الوكيلة هو النمط الذي يمكن فيه للبرمجيات المستقلة اكتشاف الأسعار وشراء السلع دون انتظار تأكيد إنسان في كل خطوة. إنه نموذج مختلف عن تكامل واجهة برمجة التطبيقات التقليدية بطريقة أساسية واحدة: الوكيل لا يسجل مسبقًا، ولا يحمل رمز جلسة، ولا يعيد توجيه أي شخص إلى شاشة الدفع.
تتناسب بطاقات الهدايا بشكل طبيعي هنا. إنها رقمية، يمكن إصدارها على الفور، ولا تتطلب شحنًا أو تحقق من الهوية من جانب المشتري. تغطي هذه المقالة كيفية عمل البنية التحتية وكيفية توصيلها.
تمنح المهارات وMCP وx402 الوكلاء الأدوات اللازمة لاقتباس والتحقق وشراء بطاقات الهدايا وeSIMs وإعادة الشحن بشكل مستقل، باستخدام العملات المستقرة.قم بتوصيل وكيل الذكاء الاصطناعي الخاص بك بـ 6600+ منتج عبر 180+ دولة.
لا KYC. لا بطاقات ائتمان.
MCP هو الطبقة التي تسمح لنموذج الذكاء الاصطناعي باستدعاء أدوات خارجية. بدلاً من أن تضرب الشيفرة الخاصة بك واجهة برمجة التطبيقات مباشرة، يستدعي الوكيل أداة مسماة، يقوم خادم MCP بترجمة ذلك إلى الطلب الصحيح، وتعود النتيجة بتنسيق يمكن للنموذج التفكير فيه. بالنسبة لعمليات شراء بطاقات الهدايا، يعني هذا أن الوكيل يمكنه استدعاء searchProducts، getProductPrice، validateOrder و createOrder كاستدعاءات أدوات طبيعية بدلاً من استدعاءات HTTP الخام.
تم نشر خادم MCP الخاص بـ Cryptorefills على api.cryptorefills.com/mcp ويمكن اكتشافه تلقائيًا عبر /.well-known/mcp.json، لذا يمكن للعملاء المتوافقين مع MCP بما في ذلك Claude وChatGPT الاتصال دون أي شفرة لاصقة مخصصة. راجع دليل تكامل MCP لقصة البناء وراء ذلك.
x402 هو معيار دفع مفتوح يعيد تنشيط رمز الحالة HTTP 402 الذي كان نائمًا لفترة طويلة. تعمل العملية على النحو التالي: يقوم الوكيل بإجراء طلب إلى مورد، ويستجيب الخادم برمز 402 الدفع مطلوب وحمولة قابلة للقراءة آليًا تحدد السعر، والأصل المقبول، والعنوان المستهدف. يقوم الوكيل بتوقيع تفويض الدفع باستخدام EIP-712 (على سلاسل EVM) أو ما يعادلها على Solana، ثم يعيد محاولة الطلب مع رأس X-PAYMENT. لا يتطلب إنشاء حساب، ولا OAuth، ولا مفتاح واجهة برمجة التطبيقات المسبق التمويل.
بالنسبة لمهارة cryptorefills-x402 على وجه التحديد، الأصل هو USDC على Base والدفع بدون غاز عبر تحويلات موقعة باستخدام EIP-712.
للبناة الذين يرغبون في تكامل مباشر بدلاً من استدعاءات أدوات MCP، تغطي واجهة برمجة التطبيقات REST الخاصة بـ Cryptorefills دورة حياة الطلب بالكامل. تصفح الكتالوج عبر /v2/brands و/v5/products/country، تسعير في الوقت المناسب عبر /v4/products/price، تحقق من الطلب عبر /v5/orders/validations، إنشاء الطلب عبر /v5/orders، وتتبع ما بعد الإنشاء عبر البث أو الاستطلاع.
هذا هو المسار الصحيح إذا كنت تبني إطار عمل وكيل مخصص، أو تطبيق مصغر على Telegram، أو عملية دفع مدمجة في المحفظة وترغب في التحكم الكامل في تدفق الطلب. تتوفر الوثائق الكاملة لنقاط النهاية على api-docs.
إليك كيف يبدو الشراء المستقل الكامل من البداية إلى النهاية، باستخدام Claude Desktop مع خادم MCP الخاص بـ Cryptorefills مثبتًا.
في ملف claude_desktop_config.json الخاص بك، أضف:
{ "mcpServers": { "cryptorefills": { "url": "https://api.cryptorefills.com/mcp/http", "transport": "http", "headers": { "User-Agent": "Cryptorefills-MCP/1.0" } } }}
يستخدم حقل transport: "http" HTTP القابل للبث بدلاً من stdio، مما يعني أن الاتصال يبقى مفتوحًا عبر تدفق شراء متعدد الخطوات دون إنشاء عملية جديدة لكل استدعاء أداة. لا يتطلب مفتاح واجهة برمجة التطبيقات في الرأس لعمليات الكتالوج والتسعير.
{ "tool": "searchProducts", "input": { "query": "أمازون", "country": "US", "category": "gift_cards" }}
يعود الخادم بقائمة من المنتجات المطابقة مع معرفاتها، والفئات المتاحة، وطرق الدفع المدعومة.
{ "tool": "getProductPrice", "input": { "product_id": "amazon-us-50", "currency": "USDC", "network": "solana" }}
هذا يعيد ما يعادل 50 دولارًا أمريكيًا من USDC بأسعار الحالية، جنبًا إلى جنب مع نافذة صلاحية الاقتباس. يتم جلب التسعير في الوقت المناسب حتى لا يدفع الوكيل مقابل سعر قديم.
تتم عملية التحقق أولاً حتى يتمكن الوكيل من اكتشاف أي مشاكل في عنوان التسليم أو توفر المنتج قبل الالتزام. عند النجاح:
{ "tool": "createOrder", "input": { "product_id": "amazon-us-50", "currency": "USDC", "network": "solana", "delivery_email": "user@example.com" }}
{ "order_id": "cr_ord_9f3a12b", "status": "awaiting_payment", "payment": { "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA7SjTBRet7vQ9z", "amount": "50.23", "currency": "USDC", "network": "solana", "expires_at": "2026-04-23T14:35:00Z" }, "product": { "name": "بطاقة هدايا أمازون", "denomination": 50, "currency": "USD" }}
بمجرد وصول الدفع إلى العنوان ضمن نافذة انتهاء الصلاحية، ينتقل حالة الطلب إلى مكتمل ويتم تسليم القسيمة. يمكن للوكيل بث تحديثات الحالة عبر نقطة النهاية /track-order-stream أو العودة إلى الاستطلاع.
روبوتات سوق المحفظة. يخبر المستخدم الروبوت بالعلامة التجارية التي يريدها. يقدم الروبوت سعرًا بالدولار الأمريكي، وينفذ ويقوم ببث حالة التسليم مرة أخرى، كل ذلك ضمن واجهة المحفظة.
مساعدو تطبيقات Telegram المصغرة. تدفقات شراء حوارية حيث يتولى الوكيل البحث عن العلامة التجارية، واختيار الفئة، والتحقق من الدفع، مع حواجز لمنع الطلبات المزدوجة.
وكلاء مكافآت DAO. المشاركة في الحوكمة على السلسلة، والمساهمات المجتمعية أو إكمال المكافآت يتم مكافأتها بقسائم بطاقات الهدايا الصادرة بشكل مستقل من محفظة الخزانة.
مساعدو إنفاق الخزانة. يمكن للفرق التي تنفق من خزانة عملة مستقرة مشتركة أتمتة شراء بطاقات الهدايا بشكل منظم وقابل للتدقيق دون خطوات تحويل يدوية.
للحصول على نظرة أطول على منطق الحوافز وراء إصدار الوكلاء المكافآت للبشر، انظر عندما تبدأ الذكاءات الاصطناعية في شراء بطاقات الهدايا.
البديل المغري هو دمج معالج دفع، وواجهة برمجة تطبيقات بطاقات الهدايا، وتحويل العملات الورقية بنفسك. في الممارسة العملية، يعني ذلك إدارة أرصدة مسبقة التمويل مع مزود طرف ثالث، والتنقل عبر القيود الجغرافية على توفر بطاقات الهدايا، واستيعاب التأخير وتعقيد طرق الدفع الورقية، والحفاظ على مزامنة الكتالوج الخاص بك.
تزيل Cryptorefills كل ذلك. لا يتطلب أي تمويل مسبق، ولا تحويل عملات ورقية في المسار الحرج، ويغطي الكتالوج أكثر من 6600 علامة تجارية عبر أكثر من 180 دولة، متاحة في اللحظة التي يستدعي فيها وكيلك searchProducts. تحتوي صفحة وكلاء الذكاء الاصطناعي على نظرة عامة كاملة على المهارات المتاحة وخيارات الاتصال.
نعم. يدعم Claude بروتوكول MCP بشكل أصلي عبر Claude Desktop وClaude Code. أضف خادم MCP الخاص بـ Cryptorefills إلى تكوينك (انظر الشيفرة أعلاه) ويمكن لـ Claude البحث في الكتالوج، والحصول على سعر مباشر، والتحقق من الطلب وإنشاء طلب في محادثة واحدة. لا يتطلب الوصول إلى الكتالوج والتسعير مفتاح واجهة برمجة تطبيقات منفصل أو حساب.
x402 هو معيار دفع مفتوح عبر HTTP يعيد استخدام رمز الحالة HTTP 402 حتى يتمكن الخادم من إعلان سعره وطريقة الدفع المقبولة. بالنسبة للوكلاء المستقلين، يعني هذا إجراء عمليات شراء دون حسابات مسجلة مسبقًا أو رموز OAuth. تنفذ مهارة cryptorefills-x402 هذا لعمليات الشراء المستقلة بالكامل.
يحتاج الوكيل إلى ثلاثة أشياء: محفظة ممولة (عادة ما تحتوي على عملات مستقرة مثل USDC أو USDT)، وطريقة لاستدعاء الخدمات الخارجية (استدعاءات أدوات MCP أو استدعاءات واجهة برمجة التطبيقات المباشرة)، وآلية دفع لا تتطلب إنسانًا في نقطة المعاملة. يتعامل x402 مع الجزء الأخير من خلال تضمين مصافحة الدفع داخل HTTP. بدون شيء مثل x402 أو MCP، يمكن للوكيل إعداد طلب ولكن لا يمكنه إكمال الدفع بمفرده.
نعم. تنشر Cryptorefills خادم MCP يتعامل مع الأدوات الخاصة بالبحث في الكتالوج، والتسعير، والتحقق من الطلب، وإنشاء الطلب، وتتبع التسليم. يعمل مع أي عميل متوافق مع MCP بما في ذلك Claude وChatGPT.
قم بتوصيل وكيلك بـ 6600+ علامة تجارية لبطاقات الهدايا عبر أكثر من 180 دولة. لا KYC. لا تمويل مسبق.
أضف خادم MCP مباشرة في Claude Desktop أو Claude Code أو أي وقت تشغيل وكيل متوافق مع MCP.
npx skills add cryptorefills/agents
افتح صفحة وكلاء الذكاء الاصطناعي لرؤية جميع المهارات الثلاث، وتكوين مهارة x402، والقائمة الكاملة لشبكات الدفع المدعومة.