البدء السريع

من الصفر إلى أول إحاطة نتيجة GEO في نحو خمس دقائق. تحتاج إلى حساب geOracle (مجاني) وأحد الوكلاء المدعومين.

المتطلبات المسبقة

حساب geOracle (سجّل مجاناً)
تثبيت Claude Code أو Cursor أو Codex CLI
عنوان URL لموقعك في بيئة الإنتاج

1. احصل على مفتاحك

شغّل معالج الإعداد واختر MCP، أو أنشئ مفتاحاً في إعدادات الفريق. تُعرض المفاتيح مرة واحدة فقط: انسخه إلى مكان آمن.

2. أضف الخادم إلى وكيلك

اختر عميلك. يضيف الأمر خادم geOracle MCP مع مفتاحك في الترويسة.

terminal

claude mcp add --transport http georacle https://georacle.ai/api/mcp --header "Authorization: Bearer YOUR_KEY"

Claude Code

/plugin marketplace add georacle/claude-plugin
/plugin install georacle@georacle
/georacle:setup

ثبّت إضافة geOracle في Claude Code وسيتولى /georacle:setup إعداد كل ذلك، بما في ذلك الروتين الأسبوعي.

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

اطلب من وكيلك استدعاء get_dashboard_summary، أو استخدم زر اختبار الاتصال في المعالج. يظهر الاستدعاء الناجح في لوحة التحكم لديك خلال ثوانٍ.

4. شغّل أول سير عمل لديك

في Claude Code، ثبّت الإضافة وشغّل /georacle:setup للمسار الموجّه (ربط الموقع، أول تحسين، الروتين الأسبوعي). أو اطلب من وكيلك ببساطة ربط موقعك وتقييم أضعف ثلاث صفحات لديك.

استكشاف الأخطاء وإصلاحها

401 Unauthorized: المفتاح خاطئ أو مُبطل أو يفتقر إلى نطاق mcp. أنشئ مفتاحاً جديداً في إعدادات الفريق وحدّث إعداد عميلك.
payment_required على إحدى الأدوات: هذه الأداة ضمن الفئة المدفوعة. تغطي الفئة المجانية التحليل والتقييم؛ قم بالترقية في المعالج أو استخدم الوصول المضمّن في خطة PRO أو ENTERPRISE لديك.
مهلات (Timeouts) على get_site_snapshot: تُحلَّل المواقع الكبيرة بشكل غير متزامن. تعيد الأداة معرّف مهمة (job id) ويستعلم عنه وكيلك دورياً. هذا أمر طبيعي.
stale_briefing عند الإرسال: تغيّر المحتوى بين الإحاطة والإرسال. اجلب إحاطة جديدة وأعد الإرسال.

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

اقرأ مورد البدء الذي يمكن لوكيلك رؤيته (georacle://docs/getting-started)
أعدّ الروتين الأسبوعي باستخدام /georacle:setup
افتح لوحة التحكم لمراجعة ما يقدمه وكيلك