دوز مباشرة للمحتوى الرئيسي
دروس فالذكاء الاصطناعي

دليل Codex SEO: دير أوديت ديال SEO وGEO والبيانات المهيكلة فالموقع باستعمال Codex CLI

هاد الدليل كَيشرح كيفاش تنصّب Codex SEO وتستعمل Codex CLI باش تدير أوديت شامل للموقع، ولصفحة وحدة، ولـSEO التقني والمحتوى وSchema والبحث بالذكاء الاصطناعي وSEO المحلي والإلكتروني، مع شرح التقارير وربط API ومراقبة التغييرات وحدود الاستعمال.

حوالي 23 دقايق ديال القراية
دليل Codex SEO لأوديت SEO وGEO والبيانات المهيكلة باستعمال Codex CLI

شنو هو Codex SEO

Codex SEO هو مجموعة مفتوحة المصدر ومجانية ديال مهارات تدقيق SEO كتخدم داخل OpenAI Codex CLI. غير عطيو عنوان الموقع، وغادي يفحصو ويولّد خطة عمل مرتّبة حسب الأولوية، ماشي غير لائحة ديال تنبيهات ما عندهاش علاقة ببعضياتها.

المشروع منقول من claude-seo ديال Agrici Daniel، وكيكيّف طرق التدقيق والمهارات والسكربتات ديال المشروع الأصلي مع Codex CLI. المشروع مرخّص برخصة MIT، ما كيتحسبش على المواقع، وما كيطلبش تثبيت خدمات SEO خارجية.

Codex SEO بحد ذاتو مفتوح المصدر وما فيهش احتساب حسب الموقع، ولكن ملي كيدير التدقيق كيستعمل الموديل المكوّن فجلسة Codex الحالية. التدقيق الكامل كيحتاج تشغيل أدوار متعددة، وهاد الشي كيستهلك غالباً توكنات أكثر من تحليل صفحة وحدة.

الإمكانيات الرئيسية

Codex SEO كيتكوّن من 26 مهارة فرعية و19 سيناريو ديال أدوار متخصصة. التدقيق الكامل يقدر يشغّل حتى لـ 17 دور بالتتابع لتحليل الموقع، وكل دور كيسجّل النتائج ديالو فملف باش تبقى موثّقة.

  • SEO التقني: كيتحقق من قابلية الزحف، مؤشرات الفهرسة، XML sitemap، robots.txt، التحويلات، سرعة الصفحات وCore Web Vitals.
  • المحتوى وE-E-A-T: كيحلّل التجربة، الخبرة، السلطة، الموثوقية، المحتوى الضعيف وتغطية المواضيع.
  • البيانات المهيكلة: كيكتاشف وكيصادق على علامات Schema.org الموجودة، ويقدر حتى يولّد علامات مقترحة.
  • البحث بالذكاء الاصطناعي وGEO: كيقيّم احتمال الاستشهاد بالصفحات فـ Google AI Overviews وAI Mode وChatGPT وPerplexity وGemini.
  • الجاهزية للوكلاء: كيتحقق من الولوج ديال AI Agent، وllms.txt وMarkdown وWebMCP والقدرات المرتبطة بها.
  • SEO المحلي والتجارة الإلكترونية: كيغطي Google Business Profile والتقييمات وحزمة الخرائط وصفحات المنتجات والمواقع متعددة اللغات.
  • الاستراتيجية والمراقبة المستمرة: كيوفّر تخطيط حسب المجال، وصفحات المنافسين، وملخصات المحتوى، والتجميع الدلالي، ومراقبة تغيّر SEO اعتماداً على لقطات SQLite.

التحضير قبل التثبيت

قبل البداية، خاصك تجهّز البيئة التالية:

  • OpenAI Codex CLI كيدعم skills.
  • Python من الإصدار 3.11 حتى 3.14.
  • Git باش تنسخ المستودع.

فالوضع الافتراضي ما كايناش حاجة لـ SEO service API key. المثبّت كينسخ المهارات لـ ~/.agents/skills/، وهو المكان اللي كيكتاشف فيه Codex مهارات المستخدم؛ وكيهيّأ حتى بيئة Python معزولة فيها متصفح بلا واجهة، بلا ما يبدّل Python العام ديال النظام.

تثبيت Codex SEO

macOS وLinux

نسخ المستودع وتشغيل سكربت التثبيت:

git clone --depth 1 https://github.com/zhtyyx/codex-seo.git
bash codex-seo/install.sh

Windows PowerShell

نفّذ فـ PowerShell:

git clone --depth 1 https://github.com/zhtyyx/codex-seo.git
powershell -ExecutionPolicy Bypass -File codex-seo\install.ps1

التهيئة وفحص البيئة

إلى بغيتي تنشئ أو تحدّث البيئة المعزولة وChromium، تقدر تشغّل فـ Codex CLI:

$seo setup

إلى بغيتي غير تفحص البيئة بلا ما تبدّل النظام، شغّل:

$seo doctor

$seo doctor هو فحص للقراءة فقط، مناسب من بعد التثبيت أو ملي كتوقع شي مشكلة باش تتأكد من حالة الاعتماديات.

أول تدقيق SEO

  1. شغّل codex فالترمينال باش تبدا Codex CLI.
  2. أشر للمهارة باستعمال $seo.
  3. عطي عنوان الموقع أو الصفحة اللي بغيتي تحلّل.
  4. تسنى حتى تكمل الأدوار المتخصصة التحليل وشوف خطة العمل اللي تولّدات.
codex

$seo audit https://example.com

$seo audit كيدير تدقيق شامل للموقع، وكيصلح باش تاخذ فكرة أولية على المشاكل العامة. النظام كيتعرف أوتوماتيكياً واش الموقع SaaS ولا خدمة محلية ولا تجارة إلكترونية ولا موقع محتوى ولا وكالة، وكيعدّل عناصر الفحص على هاد الأساس.

وتقدر حتى تستعمل اللغة الطبيعية مباشرة، مثلاً:

دير ليا تدقيق SEO، العنوان هو https://example.com

أربع أوامر أساسية للبداية

تدقيق الموقع كامل

$seo audit https://example.com

كيشغّل المسار الكامل ديال الخبراء، وكيخرج خطة إصلاح وتحسين مرتّبة حسب الأولوية. كل توصية كتشرح الأهمية، والأساس ديال الحكم، والاعتماديات، والطريقة اللي تقدر تتأكد بها واش تطبقات مزيان.

تحليل معمّق لصفحة وحدة

$seo page https://example.com/pricing

إلى كنت مهتم غير بصفحة الأثمنة أو صفحة منتج أو صفحة هبوط أو مقال، استعمل تحليل الصفحة الواحدة باش ما تشغّلش مباشرة التدقيق الكامل اللي كيكلف أكثر.

تحليل الجاهزية للبحث بالذكاء الاصطناعي

$seo geo https://example.com

هاد الأمر مخصص للتحسين لمحركات البحث التوليدية، وكيقيّم واش من السهل على البحث بالذكاء الاصطناعي يستشهد بالصفحة، وواش زواحف AI تقدر توصل ليها، وكذا الحضور ديال العلامة فمواقع عامة بحال Wikipedia وReddit وYouTube وLinkedIn.

فحص البيانات المهيكلة

$seo schema https://example.com

هاد الأمر كيكتاشف وكيصادق على علامات Schema.org فالصفحة، وكيعطي اقتراحات لتوليد البيانات المهيكلة.

اختيار أمر التدقيق حسب الهدف

SEO التقني

  • $seo technical https://example.com: كيدير تدقيق تقني فـ تسعة أصناف.
  • $seo sitemap https://example.com: كيحلّل XML sitemap ديال الموقع.
  • $seo sitemap generate: كيولّد XML sitemap.
  • $seo images https://example.com: كيحلّل مشاكل تحسين الصور.
  • $seo hreflang https://example.com: كيدقّق أو كيولّد إعدادات hreflang متعددة اللغات.
  • $seo programmatic https://example.com: كيحلّل وكيخطط لـ SEO البرنامجي.
  • $seo unlighthouse https://example.com: كيدير تحليل Lighthouse لعدة صفحات محلياً.

المحتوى وتجربة البحث

  • $seo content https://example.com: كيحلّل E-E-A-T وجودة المحتوى.
  • $seo content-brief الموضوع المستهدف: كيولّد ملخص محتوى فيه الكلمات المفتاحية المستهدفة، والتقسيم، واقتراحات الربط الداخلي.
  • $seo cluster الكلمة المفتاحية المستهدفة: كيدير تجميع دلالي مبني على SERP.
  • $seo sxo https://example.com: كيحلّل عوامل تجربة البحث بحال نوع الصفحة وقصص المستخدمين وملفات تعريف المستخدمين.
  • $seo competitor-pages https://example.com: كيولّد اقتراحات لصفحات مقارنة مع المنافسين.

المحلي والروابط والتجارة الإلكترونية

  • $seo local https://example.com: كيتحقق من GBP والاستشهادات والتقييمات وأداء حزمة الخرائط.
  • $seo maps [command]: كيستعمل إمكانيات معلومات الخرائط بحال geo-grid وتدقيق GBP ونطاق المنافسين.
  • $seo backlinks https://example.com: كيحلّل ملف الروابط الخلفية من مصادر بحال Moz وBing وCommon Crawl.
  • $seo ecommerce https://example.com: كيدير تحليل SEO التجارة الإلكترونية ومعلومات السوق.

كيفاش كيخدم التدقيق الكامل

  1. التعرّف على نوع الموقع: كيتحدد أولاً واش الموقع SaaS ولا خدمة محلية ولا تجارة إلكترونية ولا موقع محتوى ولا وكالة، ومن بعد كيتعدّل نطاق الفحص.
  2. تحليل الخبراء بالتتابع: الأدوار ديال التقنية والمحتوى والبيانات المهيكلة والسرعة والبحث بالذكاء الاصطناعي كتنفّذ المهام بالترتيب.
  3. حفظ النتائج: من بعد ما يكمل كل دور، كيتحفظ الملف ديال النتائج ديالو باش يبقى الأساس ديال الاستنتاجات موثّق.
  4. تنقيط المشاكل: النظام كينقّط النتائج، وما كيعرضهاش غير حسب ترتيب ظهورها.
  5. توليد خطة العمل: التقرير النهائي كينظّم التوصيات حسب الأولوية، وكيشرح الأسباب والاعتماديات وطريقة التحقق.

التقرير كيتحفظ افتراضياً بصيغة Markdown. إلى بغيتي PDF، طلب من Codex «ولّد تقرير PDF»، واستعمل $seo google report باش تخرجو.

نصائح متقدمة للاستعمال

بدا بتحليل محدود قبل تدقيق الموقع كامل

$seo audit الكامل كيشغّل حتى 17 دور فالجلسة الرئيسية، واستهلاك التوكنات ديالو أكبر من فحص صفحة وحدة. فالمواقع الكبيرة، تقدر تبدا بـ $seo page أو $seo technical أو $seo content أو $seo schema باش تتحقق من الصفحات المهمة، ومن بعد تقرر واش تدير تدقيق شامل.

توليد خطة استراتيجية حسب المجال

$seo plan كيدعم أنواع بحال SaaS والخدمات المحلية والتجارة الإلكترونية والنشر ووكالات التسويق:

$seo plan saas
$seo plan local
$seo plan ecommerce
$seo plan publisher
$seo plan agency

استعمال النوع اللي مناسب للنشاط كيساعد الخطة تتركز على سيناريوهات البحث الصحيحة.

ربط بيانات Google

Codex SEO كيخدم بلا API key. إلى بغيتي بيانات حقيقية من الحقول، تقدر تشغّل الأمر التالي لإعداد Google API المجاني:

$seo google setup

البيانات اللي تقدر تربطها كتضم PageSpeed Insights وChrome UX Report وGoogle Search Console وGA4. المفاتيح كيبقاو محفوظين غير فالجهاز المحلي.

إلى ما كانش Google API key مكوّن، فـ Core Web Vitals كيبقاو تقديرات تجريبية، وحالة الفهرسة كتتستنتج أساساً من معلومات الصفحة. فالقرارات المهمة، خاص التحقق باستعمال بيانات الحقول الحقيقية وبيانات منصات البحث.

مراقبة تغيّر SEO

Codex SEO يقدر يستعمل لقطات SQLite باش يبني خط أساس، ويقارن التغييرات، ويعرض السجل التاريخي:

$seo drift baseline https://example.com
$seo drift compare https://example.com
$seo drift history https://example.com

هاد المجموعة ديال الأوامر مناسبة من بعد إعادة التصميم أو الترحيل أو تحديث القوالب أو النشر المستمر للمحتوى، باش تتأكد واش حالة SEO تبدلات.

فحص واش AI Agent يقدر يستعمل الموقع

$seo agentic https://example.com

هاد الأمر كيراجع Lighthouse Agentic Browsing X/N، الولوج ديال AI Agent، وllms.txt وMarkdown وWebMCP ومشاريع أخرى. التركيز ديالو مختلف على $seo geo: الأول كيهتم بقدرة الـ Agent يستعمل الموقع، والثاني كيركز أكثر على قابلية اكتشاف الصفحات والاستشهاد بها فالبحث التوليدي.

تدقيق المواقع اللي خدامة بـ JavaScript

Codex SEO كيدعم Next.js وReact وVue ومواقع أخرى اللي كتعتمد على عرض JavaScript. ملي خاص الصفحة تنفذ JavaScript باش تبان المحتويات، كيستعمل أوتوماتيكياً متصفح بلا واجهة، وكيدير التدقيق حسب الصفحة كيفاش كيشوفها الزائر.

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

توسعات اختيارية

التدقيق الأساسي ما كيعتمدش على توسعات مؤدى عنها، ولكن المشروع كيوفر بعض التكاملات الاختيارية. لاستعمال هاد الخدمات، خاصك تجهز الحسابات أو الإعدادات المناسبة بوحدك.

  • $seo image-gen [use-case]: كينشئ صور بالذكاء الاصطناعي لمواد SEO.
  • $seo seranking [command]: كيحلل حصة الظهور ديال الذكاء الاصطناعي فـ ChatGPT وGemini وPerplexity وAI Overviews وAI Mode.
  • $seo profound [command]: كيتبع استشهادات LLM والسلسلة الزمنية ديالها.
  • $seo bing [command] https://example.com: كيستعمل أدوات مشرفي المواقع ديال Bing وقدرات الإرسال عبر IndexNow.

الخصوصية والحدود وإلغاء التثبيت

كيفاش كتتعالج البيانات

Codex SEO كيخدم داخل Codex CLI، والصفحات اللي كيتدار عليها التحليل والبيانات المرتبطة بها كيتصيفطو لنموذج OpenAI اللي ورا جلسة Codex الحالية، بنفس طريقة معالجة مهام Codex الأخرى. التقارير اللي كتتولد كيتحفظو فشكل ملفات فالجهاز المحلي.

إلا ما ربطتيش عن قصد توسعة أو API، ما كاين حتى خدمة SEO إضافية كتتوصل بالبيانات. بعض الفحوصات تقدر تقرا مصادر عامة بحال Wikipedia وReddit وCommon Crawl.

حدود خاصك تاخذها بعين الاعتبار

  • إلا ما كانش Google API مربوط، فـ Core Web Vitals كتكون تقديرات تجريبية.
  • إلا ما كانتش بيانات حقيقية من المنصات مربوطة، فحالة الفهرسة كيتستنتج معظمها من الصفحة.
  • الصفحات اللي كتحتاج التمرير أو النقر أو تفاعلات معقدة باش تحمّل المحتوى الأساسي تقدر تعطي ضوضاء.
  • التدقيق الكامل كيستعمل عدد أكبر من token، لذلك اختار الأمر حسب حجم الموقع.

إلغاء التثبيت

إلا ما بقيتيش محتاجو، تقدر تشغل سكريبت إلغاء التثبيت اللي كيوفره المستودع:

bash uninstall.sh

هاد الأمر كيزيل المهارات اللي تثبتات.

الخلاصة

Codex SEO كيجمع الفحوصات التقنية وجودة المحتوى وSchema وGEO وSEO المحلي وSEO ديال التجارة الإلكترونية والمراقبة المستمرة داخل Codex CLI. من الأحسن تبدأ بـ $seo doctor باش تتأكد من البيئة، ومن بعد تستعمل $seo page أو أمر متخصص باش تتعرف على الطريقة، وفالأخير تستعمل $seo audit باش تنشئ خطة عمل كاملة مرتبة حسب الأولوية.

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