إنشاء خادم بروتوكول سياق نموذج AgentQL: دليل عملي

يُمكنك استخدام AgentQL لجمع البيانات من أي موقع ويب يحتوي على بيانات غير مُنسّقة، وذلك عن طريق تحديد الشكل الدقيق للمعلومات التي ترغب في الحصول عليها. يُوفر لك AgentQL نتائج مُتناسقة ومنظمة، حتى من الصفحات التي تحتوي على محتوى ديناميكي أو تخطيطات متغيرة بشكل متكرر. سنسرد في هذا الدليل كيفية إنشاء خادم AgentQL MCP داخل تطبيق Claude Desktop، واستخدام إمكانيات التصور المُدمجة في Claude لاستعراض البيانات. سنقوم تحديداً بجمع بيانات صفحات نتائج البحث على أمازون عن كتب الذكاء الاصطناعي، مع استخراج تفاصيل مثل السعر، التقييم، وعدد التعليقات.

الخطوة الأولى: إعداد المُتطلبات

Node.js

نحتاج إلى npx لتشغيل خادم AgentQL، والذي يأتي مُرفقاً مع Node.js.

1. قم بتنزيل أحدث إصدار من Node.js من موقع nodejs.org.
2. قم بتشغيل برنامج التثبيت.
3. اترك جميع الإعدادات على وضعها الافتراضي واكمِل عملية التثبيت.

Claude Desktop

قم بتنزيل Claude من خلال الرابط التالي: claude.ai/download.

واجهة برمجة تطبيقات AgentQL (API)

أنشئ مفتاح واجهة برمجة تطبيقات AgentQL الخاص بك من خلال dev.agentql.com/api-keys واحفظة بشكل آمن، ستحتاج إليه لاحقاً في هذا الدليل.

الخطوة الثانية: تثبيت الحزم

بمجرد تثبيت Node.js، افتح محطة الأوامر (Terminal) وقم بتشغيل الأمر التالي:

npm install -g agentql-mcp

الخطوة الثالثة: تهيئة خادم MCP

بعد ذلك، قم بتهيئة Claude للاتصال بخادم MCP الخاص بك. افتح ملف claude_desktop_config.json الموجود في دليل تثبيت Claude باستخدام أي محرر نصوص. إذا لم يكن الملف موجوداً، يمكنك إنشاؤه يدوياً. بمجرد فتحه، أدخل الكود التالي:

{
  "mcpServers": {
    "agentql": {
      "command": "npx",
      "args": ["-y", "agentql-mcp"],
      "env": {
        "AGENTQL_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

استبدل <YOUR_API_KEY> بمفتاح API الذي قمت بإنشائه.

الخطوة الرابعة: تشغيل الخادم

بمجرد اكتمال تهيئة MCP، يجب أن يظهر الخادم الخاص بك في Claude. يتضمن خادم AgentQL أداة قوية واحدة وهي extract_web_data، والتي تأخذ عنوان URL ووصفاً بلغة طبيعية لهيكل البيانات التي تريد استخراجها. يمكنك استخدام أي عنوان URL تريد جمعه منه البيانات. في هذا الدليل، استخدمت صفحة نتائج بحث أمازون عن كتب الذكاء الاصطناعي وطلبت من Claude تصور البيانات المُستخرجة.

يُوفر Claude واجهة طرفية تفاعلية حيث يُنشئ الكود لمعالجة البيانات وتصورها – ويمكنك تعديل هذا الكود حسب الحاجة. بمجرد الانتهاء من الكود، عرض Claude مخططاً شريطياً مع خيارات تفاعلية لاستعراض الأسعار، التقييمات، عدد التعليقات، وحتى رسم بياني لانتشار السعر مقابل التقييم، بالإضافة إلى أهم الإحصائيات المُلخصة.

استخدامات AgentQL

يمكن استخدام AgentQL لجمع البيانات من مواقع الويب، ويمكننا توصيله بخوادم أخرى مثل Notion أو GitHub لإرسال البيانات المُنسّقة تلقائياً للوثائق، أو التتبع، أو المزيد من الأتمتة. هذا يجعل AgentQL أداة قوية لتحويل المحتوى غير المُنسّق على الويب إلى رؤى عملية – كل ذلك ضمن سير عمل بسيط بلغة طبيعية.

لمحة عن Marktechpost

في الختام، إليك لمحة سريعة عن ما نقدمه في Marktechpost:

• نشرة إخبارية: airesearchinsights.com (أكثر من 30,000 مشترك)
• فعاليات miniCON للذكاء الاصطناعي: minicon.marktechpost.com
• تقارير ومجلات حول الذكاء الاصطناعي: magazine.marktechpost.com
• أخبار تطوير الذكاء الاصطناعي والبحث: marktechpost.com (أكثر من مليون قارئ شهرياً)
• مجموعة أخبار تعلم الآلة: r/machinelearningnews (أكثر من 92,000 عضو)

المصدر: MarkTechPost