SanDeals.net
في هذه الصفحةاختر طريقة التكامل
مواصفة Markdownعرض OpenAPI

المطوّرون

ابدأ البناء مع SanDeals

اربط وكيل الذكاء الاصطناعي أو تطبيقك بكتالوج عروض SanDeals. تشرح هذه الصفحة الإعداد عبر MCP وواجهة REST API وChatGPT Actions، ثم المرجع الكامل.

claude mcp add --transport http sandeals https://www.sandeals.net/mcp
عنوان الخادم
https://www.sandeals.net/mcp
  • Streamable HTTP
  • Auth: None
  • للقراءة فقط

يعمل معClaude CodeChatGPTCursor

التكاملات

اختر طريقة التكامل

اختر الواجهة المناسبة لعميلك. الثلاث تقرأ الكتالوج نفسه.

MCP

للمساعدين والوكلاء بالذكاء الاصطناعي. اتصل مرة واحدة، ويستدعي نموذجك search_deals وlist_deals كأدوات.

REST API

للتطبيقات والسكربتات والأنظمة الخلفية. أرسل طلب HTTP واحدًا واحصل على JSON منظّم.

ChatGPT Actions

لنماذج GPT المخصصة. استورد مواصفة OpenAPI واستدعِ العملية searchDeals.

ابدأ الآن

البدء السريع

يربط هذا الدليل السريع SanDeals بـ Claude Code وينفّذ أول بحث لك. تلي ذلك خطوات ChatGPT وCursor والعملاء الآخرين.

المتطلبات

  • عميل MCP مثل Claude Code أو ChatGPT أو Cursor
  • أو أي عميل HTTP، مثل curl، لواجهة REST API
  • لا حاجة إلى حساب أو مفتاح API: الخادم عام وللقراءة فقط

Claude Code

  1. أضف الخادم

    نفّذ هذا الأمر في الطرفية. يسجّل SanDeals كخادم Streamable HTTP باسم sandeals.

    Terminal
    claude mcp add --transport http sandeals https://www.sandeals.net/mcp

  2. تحقق من الاتصال

    اعرض قائمة خوادمك. يظهر ✓ Connected بجانب sandeals عندما يعمل الاتصال. إذا رأيت Failed to connect، فتحقق من الشبكة ونفّذ أمر الإضافة مرة أخرى. داخل جلسة Claude، يعرض الأمر /mcp الحالة نفسها.

    Terminal
    claude mcp list
    المخرجات
    Checking MCP server health...

sandeals: https://www.sandeals.net/mcp (HTTP) - ✓ Connected

  3. ابحث عن العروض

    اسأل بلغة طبيعية. يستدعي Claude الأداة search_deals ويرد بالعناوين والروابط من الكتالوج.

    Claude Code
    استخدم SanDeals للعثور على عروض القهوة وأعد عنوان ورابط كل عرض.
    المخرجات
    إليك عروض القهوة من SanDeals:

1. قهوة مطحونة 500 غ — https://slink.sandeals.net/AbC123
2. قهوة سريعة التحضير 3 في 1، 20 كيسًا — https://slink.sandeals.net/XyZ789

راجع الشروط على موقع المتجر قبل الشراء.
لمشاركة الخادم مع فريقك، أضف --scope project. يحفظه Claude Code في ملف .mcp.json داخل مستودعك.
claude mcp add --scope project --transport http sandeals https://www.sandeals.net/mcp

ChatGPT

  1. في ChatGPT Connectors، أضف custom MCP server.

  2. الصق عنوان الخادم واختر No authentication.

    عنوان الخادم
    https://www.sandeals.net/mcp

  3. ثبّته. في محادثة جديدة، اكتب @ واختر SanDeals.

يعتمد التوفر على صلاحيات مساحة العمل لديك. أما ChatGPT Actions أدناه فهو تكامل REST منفصل.

Cursor وعملاء آخرون

أي عميل يدعم MCP البعيد عبر Streamable HTTP يتصل باستخدام عنوان الخادم. في Cursor، أضفه إلى mcp.json:

~/.cursor/mcp.json
{
  "mcpServers": {
    "sandeals": {
      "url": "https://www.sandeals.net/mcp"
    }
  }
}

ChatGPT Actions

في ChatGPT، أنشئ GPT مخصصًا، وافتح Actions واختر Import from URL. الصق الرابط أدناه، واضبط Authentication على None، وسيستدعي GPT العملية searchDeals.

OpenAPI
https://www.sandeals.net/openapi.json

موجّه الوكيل

وجّه الوكيل إلى www.sandeals.net/for-agents.md، أو استخدم هذا الموجّه:

موجّه الوكيل
اتصل بـ https://www.sandeals.net/mcp. استدعِ search_deals. أعد عنوان ورابط كل عرض من الاستجابة.

المرجع

خادم MCP

يستخدم خادم MCP بروتوكول Streamable HTTP ولا يحتفظ بحالة الجلسة بين الطلبات. عنوانه هو www.sandeals.net/mcp.

EndpointPOST /mcp
AliasPOST /api/mcp
AuthNone
TransportStreamable HTTP · JSON-RPC 2.0
Protocol2025-03-26 · 2025-06-18 · 2025-11-25
Methodsinitialize · tools/list · tools/call

الأدوات

search_dealsللقراءة فقط

يبحث عن العروض بكلمة مفتاحية. لكل نتيجة عنوان ورابط وفئة.

الحقلالنوعملاحظات
queryمطلوبstring1–512 chars
limitinteger1–50 · default 10
list_dealsللقراءة فقط

يسرد الكتالوج، مع إمكانية الترشيح حسب الفئة أو الكلمة المفتاحية.

الحقلالنوعملاحظات
categoryenumall · food · travel · shopping · tech · books · lifestyle · education
searchstring≤ 512 chars
limitinteger1–100 · default 20
tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_deals",
    "arguments": {
      "query": "coffee",
      "limit": 5
    }
  }
}

REST API

تنفّذ واجهة REST API البحث نفسه الذي تنفّذه أداة MCP search_deals. مرّر استعلامك في q. أما limit فاختياري، قيمته الافتراضية 10 وحده الأقصى 50. في طلبات POST، أرسل mode: "agent" للحصول على JSON منظّم.

GETPOST/api/search-advanced

curl "https://www.sandeals.net/api/search-advanced?q=coffee&limit=5"
  • الكتالوج: يسرد GET /api/deals الكتالوج. رشّحه باستخدام category وsearch (أو اسمه البديل q) وlimit.
  • بديل HTML: يعيد GET /search?q=coffee صفحة نتائج HTML تعمل بدون JavaScript. استخدمها فقط إذا كان عميلك لا يستطيع قراءة JSON.

الاستجابة

تتضمن كل نتيجة title وhref.

response.json
{
  "ok": true,
  "query": "coffee",
  "total": 1,
  "results": [
    {
      "title": "Example Cafe",
      "href": "https://slink.sandeals.net/example",
      "category": "food",
      "summary": "Example cafe — coffee and tea.",
      "score": 13,
      "source": "deals"
    }
  ],
  "response": "Found 1 deal for \"coffee\": 1. Example Cafe — https://slink.sandeals.net/example",
  "meta": {
    "mode": "agent",
    "matched": true
  }
}
الحقلالنوعملاحظات
results[].titlestringاسم المتجر أو العرض
results[].hrefstringرابط العرض
results[].categorystringfood (مأكولات)، travel (سفر)، shopping (تسوق)، tech (تقنية)، books (كتب)، lifestyle (نمط حياة)
meta.matchedbooleanfalse تعني اقتراحات بديلة

القيد

إذا كانت قيمة meta.matched هي false، فأبلغ بعدم وجود تطابق تام، ثم أعد الصفوف المقترحة. استخدم فقط القيم الموجودة في الاستجابة.

جرّب

نفّذ بحثًا من متصفحك مباشرة. يرسل النموذج طلب GET إلى /search، وهي صفحة النتائج نفسها التي يستخدمها الزوار، ويعمل مع تعطيل JavaScript.

أمثلة: coffeegiàyvoucherJSON قهوة

الفهارس

تصف هذه الملفات SanDeals لبرامج الزحف ووكلاء البرمجة. يسرد كل منها نقاط النهاية نفسها بتنسيق مختلف.

المسارالتنسيق
/llms.txtMarkdown
/for-agents.mdMarkdown
/api/llmsJSON
/.well-known/ai.txtText
/openapi.jsonOpenAPI 3
GET /mcpJSON

الخطوات التالية

لقد ربطت SanDeals. استكشف الآن المرجع الكامل وطرق التكامل الأخرى.

مرجع APIكل نقاط النهاية والمعلمات ومخططات الاستجابة.خادم MCPتفاصيل الخادم والأدوات وخطوات الاتصال في صفحة واحدة.مواصفة OpenAPIاستوردها في ChatGPT Actions أو أنشئ عميلًا.دليل الوكلاءالتوثيق بصيغة Markdown لوكلاء البرمجة وبرامج الزحف.