SEO Automation: دليل بناء Workflows بالـAI

لو بتشتغل في SEO وعندك مهام بتتكرر كل يوم، فـ SEO Automation ممكن يوفر عليك وقت كبير جدًا، لكن البداية الصح مش إنك تستخدم AI في كل حاجة.
البداية الحقيقية هي إنك تعرف إيه المهمة اللي تستاهل Automation، وإمتى تستخدم كود عادي، وإمتى تدخل AI Workflow، وإمتى فعلًا تحتاج AI Agent.

في الجزء الأول من السلسلة هنمشي من اختيار أول مهمة تعملها Automation، لحد تصميم Workflow يستخدم الـAI، وهنشوف دور Python وAPIs وGoogle Sheets بأمثلة عملية، من غير ما نفترض إنك محترف برمجة. ☕
الكورس للـ م/خالد زين

---

1. قبل الأدوات: اختار المهمة المناسبة​

أفضل مهمة تبدأ بيها في Automation هي مهمة:

• بتتكرر باستمرار.
• مدخلاتها واضحة.
• عندك قواعد محددة للحكم على النتيجة.
• تقدر تراجع الـOutput وتعرف هل هو صحيح ولا لأ.

مثال بسيط:
عندك Google Sheet فيه عناوين صفحات، وعايز تعرف:

• العناوين الأقصر من 30 حرف.
• العناوين اللي محتاجة Optimization.
• الـDuplicate الموجودة في البيانات.

هنا أنت مش محتاج AI أصلًا.

ممكن تعمل Google Apps Script بسيط بقواعد واضحة، أو حتى تستخدم Google Sheets Formulas لتنفيذ المهمة.
لكن لو عايز تقترح عنوان مناسب لكل صفحة بناءً على محتوى الصفحة، هنا الـAI ممكن يكون مفيد جدًا، لأنه بيتعامل مع محتوى ومعنى الصفحة، مش مجرد قاعدة ثابتة.

يعني قبل ما تقول: "أنا عايز أعمل Automation للمشروع كله"، اسأل نفسك الأول:
إيه الـTask اللي فعلًا ينفع أعمله Automation؟

اكتب على ورقة قبل التنفيذ: الداتا هتيجي منين؟

• هل من Google Sheets؟
• هل من API؟
• هل من Google Search Console أو مصدر بيانات تاني؟

النتيجة المطلوبة شكلها إيه؟

• هل محتاج Google Sheet؟
• هل محتاج Google Docs؟
• هل محتاج ملف JSON أو CSV؟

والأهم:
إيه الشروط اللي لازم تتحقق علشان أقبل النتيجة؟

دي نقطة مهمة جدًا، خصوصًا مع الـAI. لو مفيش Rules واضحة، ممكن تحصل على Output شكله كويس لكنه مش مناسب للمهمة.

وأخيرًا:
إمتى التنفيذ يقف ويرجعلك للمراجعة؟

ممكن تعمل اختبار على عينة صغيرة، تراجع النتيجة، ولو الجودة مناسبة تكمل على باقي البيانات. ولو ظهرت مشكلة، تعدل الـWorkflow قبل ما تشغله على كمية كبيرة.
وده طبيعي جدًا في البداية. أنت بتتعلم طريقة تفكير جديدة، مش مجرد أداة جديدة. 🧠

---

2. الفرق بين Automation وAI Workflow وAI Agent​

من أهم الحاجات اللي لازم تفهمها قبل ما تبني أي نظام هي الفرق بين التلاتة.

Automation​

هو تنفيذ مجموعة خطوات تلقائيًا بناءً على قواعد محددة.

مثلًا:
Google Sheet ⬅️ فحص العناوين ⬅️ استخراج العناوين الأقل من 30 حرف ⬅️ تحديد الـDuplicate.
المهمة هنا واضحة، والقواعد واضحة، ومش محتاج نموذج ذكاء اصطناعي علشان ينفذها.

AI Workflow​

هنا بتضيف نموذج ذكاء اصطناعي داخل خطوات أنت محدد ترتيبها مسبقًا.
مثلًا عندك Google Sheet فيه:

• Main Keyword
• Secondary Keywords
• Category
• معلومات عن الصفحة

وعايز تستخدم البيانات دي لإنشاء Category Description قصيرة بأسلوب Copywriting.
أنت محدد الـWorkflow والقواعد، والـAI بيقوم بالجزء اللي يحتاج فهم أو توليد محتوى.

AI Agent​

هنا الموضوع مختلف شوية.
الـAI Agent عنده مساحة أكبر في تحديد الخطوة التالية والأداة المناسبة لتحقيق الهدف، لكن داخل الحدود والصلاحيات اللي أنت محددها.

مثلًا ممكن يكون عندك نظام Content فيه أكتر من Agent:

• Agent 1: يبحث عن الكلمات والبيانات المطلوبة.
• Agent 2: يحلل المنافسين ويحدد الـContent Gaps.
• Agent 3: يبني المحتوى اعتمادًا على الـBrief النهائي.

وممكن كل Agent يستخدم Model مختلف أو Tools مختلفة حسب المهمة.
الفكرة هنا إنك مش بتستخدم AI لمجرد استخدام AI؛ أنت بتوزع المهام حسب طبيعتها. 🤖

---

3. الأدوات اللي هنستخدمها ودور كل أداة​

علشان تبني SEO Automation باستخدام الكود، فيه مجموعة أدوات مهمة:

Python​

لغة تقدر تستخدمها لمعالجة الملفات، التعامل مع البيانات، استدعاء APIs، وربط خطوات الـWorkflow ببعض.

VS Code​

محرر تكتب وتراجع وتشغل منه الكود.

Terminal​

المكان اللي بتشغل منه الأوامر وتشوف الـLogs ورسائل البرنامج.

API​

وسيلة تخلي برنامجك يتواصل مع خدمة خارجية، زي نموذج AI أو مصدر بيانات.

Claude Code وCodex وOpenCode​

أدوات ممكن تساعدك في كتابة الكود وفهمه وتعديله، وممكن تستخدم معها Skills حسب الأداة والبيئة اللي شغال فيها.

Google Apps Script​

بيئة مبنية على JavaScript تقدر تستخدمها لإضافة وظائف وأتمتة داخل Google Sheets وخدمات Google الأخرى.

اختيار الكود بيديك مرونة كبيرة جدًا في التحكم والتعديل والحفاظ على جودة الـOutput، لكن في المقابل هتحتاج تعمل Testing وتهتم بالتحديثات والصيانة.
أنا هنا هركز على فهم طريقة بناء الـWorkflow بالكود من الصفر، حتى لو لسه مش فاهم برمجة بشكل كبير.
أما أدوات الـNo-Code أو Low-Code زي Make وn8n، فهي ممكن تكون مناسبة جدًا لبعض الاستخدامات، لكن هدف السلسلة هنا إنك تفهم الـMindset وطريقة بناء النظام نفسه بدل ما تعتمد على أداة جاهزة فقط.

---

4. الـPattern الأول: Sequential Workflow​

ده من أبسط أنماط الـWorkflow.
الفكرة إن كل Agent يخلص مهمته، وبعدها يسلم الـOutput للـAgent اللي بعده:
Agent 1 → Agent 2 → Agent 3
مفيش خطوة بتبدأ قبل ما الخطوة السابقة تخلص.

النمط ده مناسب جدًا للمهام اللي محتاجة:
بحث ⬅️ تجميع ⬅️ تحليل ⬅️ نتيجة نهائية

مثال: بناء Content Brief​

ممكن تعمل Workflow مكون من 3 Agents:

Agent 1 - Scraper
يستقبل الكلمة المفتاحية، يجمع البيانات المطلوبة من نتائج البحث والمصادر المتاحة، وينظف البيانات قبل إرسالها للخطوة التالية.

Agent 2 - Analyzer
مش مهمته الكتابة، لكن التحليل.
يحلل البيانات ويستخرج مثلًا:

• الـEntities المهمة.
• هيكلة العناوين.
• الأسئلة المتكررة.
• الـContent Gaps عند المنافسين.

Agent 3 - Brief Creator
يأخذ التحليل السابق ويبني Content Brief للكاتب، ويقدر يشمل:

• العناوين المقترحة.
• Search Intent.
• النقاط المطلوب تغطيتها.
• عدد كلمات تقديري.
• المتطلبات الأساسية للمحتوى.

الميزة هنا إن كل Agent عنده Role واضح، والـOutput بتاع خطوة هو الـInput للخطوة اللي بعدها.

---

5. الـPattern الثاني: Parallelization​

هنا بنشتغل على مهام مستقلة عن بعضها في نفس الوقت بدل ما نستنى كل مهمة تخلص قبل ما نبدأ اللي بعدها.
وده مفيد جدًا في الـBulk Tasks، خصوصًا في المواقع اللي عندها عدد كبير من المنتجات أو الصفحات.

مثال: إنشاء أوصاف لآلاف المنتجات​

تخيل متجر عنده 70,000 منتج، وفي 10,000 منتج محتاجين إضافة أو تحديث وصف.
لو هتعمل كل ده يدويًا، الوقت المطلوب هيكون ضخم.
لكن باستخدام Parallelization، تقدر تقسم المهمة إلى دفعات وتنفذ المهام المستقلة بالتوازي، مع وضع حدود مناسبة لعدد الطلبات والتكلفة.

لو بيانات المنتج متوفرة، مثل:

• اسم المنتج.
• التصنيف.
• Attributes.
• الخامات.
• المقاسات.
• الألوان.

فالـAI عنده Input أفضل، وبالتالي فرصة الحصول على Output أفضل.

ممكن مثلًا تشغل معالجة لعدة منتجات في نفس الوقت، لكن لازم تراقب:

• جودة الـOutput.
• تكلفة الـAPI.
• حدود الـAPI.
• سرعة التنفيذ.
• معدل الأخطاء.

ولو بيانات المنتج ضعيفة، الموضوع بيختلف.

ممكن تستخدم Vision Models لتحليل صور المنتجات واستخراج بعض الـAttributes، لكن لازم تفتكر إن تحليل الصور مش بديل مضمون عن البيانات الأصلية.

مثلًا لو صورة لابتوب مفيهاش المواصفات التقنية، النموذج مش هيقدر يستنتج RAM أو المعالج بشكل موثوق لمجرد إن الصورة موجودة.

Input واضح ⬅️ Output أفضل.
والأهم من سرعة التنفيذ هو Quality Control.

ممكن تعمل Agent أو خطوة مراجعة تفحص عينة من الـOutputs وتتأكد إنها:

• متوافقة مع أسلوب الـBrand.
• خالية من المعلومات غير الموجودة في البيانات.
• لا تحتوي على هلوسة.
• ملتزمة بالقواعد المحددة.

بعد التأكد من الجودة، تكمل على باقي المنتجات. 🔍

---

6. الـPattern الثالث: Router Workflow​

الـRouter تقدر تعتبره زي "عسكري المرور" للبيانات. 🚦
وظيفته إنه يستقبل البيانات، يحدد نوعها، وبعدها يوجهها للـWorkflow المناسبة.

مثال: تصنيف 40,000 Keyword​

تخيل إنك سحبت قائمة كبيرة من الكلمات المفتاحية.
الـRouter Agent يستقبل كل Keyword ويحدد الـSearch Intent، وبعدها يوجهها للمسار المناسب.
مثلًا:
Informational
تروح إلى Workflow خاصة بالمقالات وإنشاء Content Brief.
Transactional
تروح إلى Workflow خاصة بالمنتجات أو صفحات الأقسام.
Irrelevant
تخرج من النظام، وبالتالي متصرفش عليها API Credits بدون داعي.
الميزة هنا إنك بدل ما تستخدم نفس الـWorkflow على كل البيانات، بتعمل Routing حسب نوع كل حالة.

مثال آخر: استخدام Router في SEO Audit​

ممكن تعمل Router مرتبط ببيانات Google Search Console أو بيانات SEO موجودة في Google Sheet.
مثلًا:
لو الصفحة أداؤها جيد ⬅️ Leave as is
لو ترتيب الصفحة بين 4 و20 ⬅️ تدخل Workflow خاصة بالـAudit والتحسين.

الـWorkflow ممكن تراجع:

• Meta Tags.
• تحديث المحتوى.
• Internal Linking.
• مشاكل الصفحة.
• فرص تحسين الـContent.

ولو الصفحة مش Indexed، ممكن يكون فيه مسار مختلف يبدأ بالبحث عن سبب المشكلة.

مثلًا:
هل Google شايف إن الصفحة مفيهاش قيمة كافية؟
هل فيه صفحة أخرى أفضل بتستهدف نفس الموضوع؟
هل الصفحة عليها Canonical لصفحة أخرى؟
هل فيه مشكلة تقنية؟
بعد تحديد السبب، قرار الإجراء النهائي يعتمد على الحالة.
ممكن يكون الإجراء المناسب تحديث الصفحة، أو دمج المحتوى، أو حذف الصفحة، أو استخدام 301 أو 410 حسب الحالة.
وهنا تبدأ تشوف قوة الـWorkflow: مش مجرد تنفيذ أمر، لكن توجيه كل حالة للمسار المناسب.

أداة مفيدة للتجارب: Serper​

فيه أدوات Search APIs ممكن تساعدك في بناء Workflows تعتمد على نتائج البحث.
ومن الأمثلة Serper، واللي تقدر تستخدمه كمصدر لنتائج البحث داخل تطبيقاتك حسب الخطة والحدود المتاحة وقت الاستخدام.
الفكرة مش في الأداة نفسها، لكن في إن الـWorkflow يقدر يستخدم API للحصول على البيانات بدل تنفيذ كل خطوة يدويًا.

---

7. أسهل بداية: Google Sheets وGoogle Apps Script​

لو Terminal وPython لسه تقال عليك، فـGoogle Sheets ممكن تكون بداية ممتازة.
الميزة إنك تقدر تبدأ من المتصفح وتستخدم Google Apps Script لبناء Functions وعمليات Automation مرتبطة بالـSheets.
مش لازم تكون JavaScript Developer من البداية.

الأهم إنك تعرف تحدد:

• الـInput.
• المطلوب من الـFunction.
• شكل الـOutput.
• الـRules.
• طريقة التعامل مع الأخطاء.

---

إزاي تخلي AI يساعدك في كتابة Google Apps Script؟​

ممكن تستخدم Prompt واضح زي ده:

أنا بستخدم Google Sheets ومحتاجك تكتبلي كود Google Apps Script.

المهمة:
عايز أعمل Custom Function تاخد النص الموجود في الخلية، وتعمل الآتي:
[اشرح المهمة بالتفصيل هنا]

المطلوب:

• اكتب الكود كامل وجاهز للنسخ.
• اشرحلي أين أضع الكود داخل Google Apps Script.
• اشرحلي طريقة استخدام الدالة داخل Google Sheets.
• إذا كانت المهمة تحتاج API، اشرحلي طريقة إضافة API Key واستخدامه بأمان.
• وضح أي حدود أو أخطاء محتملة في الكود.

بعد كده تراجع الكود وتختبره على بيانات بسيطة قبل ما تستخدمه على كمية كبيرة.
المهم: متتعاملش مع Output من الـAI على إنه صحيح تلقائيًا. شغّل Test، راجع النتيجة، وعدّل الـPrompt أو الكود حسب الحاجة.

---

8. أفكار SEO Automation تقدر تبدأ بيها​

بعد ما تفهم الأساسيات، فيه مهام كتير ممكن تبدأ تطبق عليها Automation:

1. فحص حالة الروابط وStatus Codes.
2. استخراج عناصر SEO من الصفحات.
3. فحص الصور وAlt Text.
4. إنشاء Meta Title وMeta Description بمساعدة AI.
5. إنشاء Schema Markup.
6. استخراج وفحص Sitemap.
7. اكتشاف المحتوى المتشابه.
8. اقتراح Internal Links وAnchor Text.

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

---

الخلاصة​

SEO Automation مش معناه إنك تدخل AI في كل خطوة.
ابدأ بالمهمة نفسها، وبعدها اسأل:

هل أقدر أحلها بقواعد ثابتة؟
لو آه، ممكن Automation عادية أو Script تكون كفاية.

هل محتاجة فهم للمحتوى أو توليد نص؟
هنا ممكن AI Workflow يكون مناسب.

هل النظام محتاج يختار الخطوة التالية أو الأداة بناءً على الحالة؟
هنا ممكن تبدأ تفكر في AI Agent.
وأيًا كان النوع اللي هتستخدمه، خليك فاكر القاعدة الأهم:
Input واضح + Rules واضحة + Testing مستمر = Output أفضل. ⚙️

في الجزء الجاي هنبدأ ندخل بشكل عملي في Google Apps Script، ونبني أدوات SEO حقيقية خطوة بخطوة، وبعدها نقدر ننقل نفس الـMindset إلى Terminal وPython والـWorkflows الأكثر تعقيدًا. 🚀

---

الأسئلة الشائعة​

--------------

هل أحتاج إلى تعلم Python قبل بدء SEO Automation؟​

لا. تقدر تبدأ بمهام بسيطة باستخدام Google Sheets وGoogle Apps Script، وبعدها تتعلم Python تدريجيًا لما تحتاج مرونة وتحكم أكبر.

هل كل مهام SEO تحتاج AI؟​

لا. المهام اللي تعتمد على Rules واضحة، زي فحص طول العنوان أو اكتشاف Duplicate، ممكن تتعمل بكود عادي بدون AI.

ما الفرق الأساسي بين AI Workflow وAI Agent؟​

الـAI Workflow ينفذ خطوات أنت محدد ترتيبها مسبقًا، بينما الـAI Agent عنده مساحة أكبر لاختيار الخطوة أو الأداة التالية ضمن الهدف والصلاحيات اللي حددتها.

هل يمكن استخدام AI لكتابة Google Apps Script؟​

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

 

هذا هو البرومبت الأحترافى كما يوصى به صاحب الكورس :

1. فحص حالة الروابط وStatus Code
أنا بستخدم Google Sheets ومحتاجك تكتبلي مشروع Google Apps Script كامل.
المهمة:
عايز أعمل أداة لفحص حالة الروابط الموجودة في العمود A بداية من الخلية A2.

الأداة تقرأ كل URL وتعرض النتائج التالية:

• Status Code مثل 200 أو 301 أو 404 أو 500.
• الرابط النهائي بعد أي Redirect.
• هل الرابط سليم أو محوّل أو مكسور.
• رسالة الخطأ إن وُجدت.
• تاريخ ووقت آخر فحص.

تنظيم النتائج:

• العمود A: URL
• العمود B: Status Code
• العمود C: Final URL
• العمود D: Status
• العمود E: Error Message
• العمود F: Last Checked

المطلوب:

• اكتب الكود كاملًا وجاهزًا للنسخ داخل Google Apps Script.
• استخدم UrlFetchApp لفحص الروابط.
• تعامل مع الأخطاء باستخدام try/catch بحيث لا يتوقف السكربت بالكامل بسبب رابط واحد.
• نفّذ الفحص على دفعات لتجنب تجاوز مدة تشغيل Apps Script.
• استخدم PropertiesService لحفظ آخر صف تم فحصه.
• أضف قائمة داخل Google Sheets باسم SEO Tools.
• تحتوي القائمة على:
  1. Check URLs
  2. Continue Check
  3. Clear Results
• لو انتهى وقت التنفيذ، أنشئ Trigger مؤقتًا لاستكمال الفحص تلقائيًا.
• لو الرابط فارغ أو غير صالح، سجّل ذلك بدلًا من إيقاف السكربت.
• لو حدث Redirect، أظهر الرابط النهائي.
• لو أمكن، استخدم UrlFetchApp.fetchAll لتسريع التنفيذ مع الحفاظ على معالجة الأخطاء.
• لو كان استخدام Custom Function غير مناسب لهذه المهمة، استخدم Menu Function واشرح السبب.
• لا تستخدم أي مكتبات أو خدمات مدفوعة.
• اجعل الكود متوافقًا مع Google Apps Script V8.
• قسّم الكود إلى دوال منظمة واشرح وظيفة كل دالة.
• اشرح خطوة بخطوة طريقة إضافة الكود وتشغيله ومنح الصلاحيات.

---

2. استخراج عناصر SEO من الصفحة
أنا بستخدم Google Sheets ومحتاجك تكتبلي كود Google Apps Script كامل يعمل كأداة Mini SEO Crawler.
المهمة:
عايز الأداة تاخد رابط الصفحة من العمود A، وتحمل HTML الخاص بالصفحة، وبعدها تستخرج أهم عناصر On-Page SEO.

البيانات المطلوبة:

• Status Code
• Page Title
• عدد أحرف Title
• Meta Description
• عدد أحرف Meta Description
• أول H1
• عدد عناصر H1
• جميع عناصر H2
• Canonical URL
• Meta Robots
• قيمة HTML Lang
• عدد الكلمات التقريبي
• تاريخ الفحص

تنظيم الأعمدة:

• A: URL
• B: Status Code
• C: Title
• D: Title Length
• E: Meta Description
• F: Description Length
• G: First H1
• H: H1 Count
• I: H2 Headings
• J: Canonical
• K: Meta Robots
• L: HTML Lang
• M: Word Count
• N: SEO Notes
• O: Last Checked

المطلوب:

• اكتب الكود كاملًا وجاهزًا للنسخ.
• استخدم UrlFetchApp لجلب HTML.
• تعامل مع اختلاف ترتيب خصائص HTML داخل الوسوم.
• نظّف HTML Entities والمسافات الزائدة من النتائج.
• حوّل Canonical النسبي إلى رابط كامل.
• اعرض تحذيرات في SEO Notes عند وجود:
  • Title مفقود.
  • Meta Description مفقودة.
  • أكثر من H1.
  • Canonical مفقود.
  • noindex.
  • محتوى قليل.
• لا تجعل خطأ صفحة واحدة يوقف باقي الصفحات.
• نفّذ العملية على دفعات.
• استخدم PropertiesService لحفظ التقدم.
• أضف قائمة باسم SEO Tools تحتوي على:
  1. Crawl URLs
  2. Continue Crawl
  3. Clear Crawl Results
• لا تستخدم مكتبات خارجية أو خدمات مدفوعة.
• اجعل الكود متوافقًا مع Google Apps Script V8.
• قسّم الكود إلى دوال واضحة.
• اشرح طريقة وضع الكود وتشغيله ومنح الصلاحيات.

---

3. فحص صور الصفحات وAlt Text
أنا بستخدم Google Sheets ومحتاجك تكتبلي مشروع Google Apps Script كامل لفحص صور صفحات الموقع من ناحية SEO.
المهمة:
عايز السكربت يقرأ روابط الصفحات من العمود A في Sheet باسم Pages، وبعدها يستخرج جميع الصور الموجودة في كل صفحة ويحللها.

أنشئ Sheet منفصل باسم Images، وسجّل فيه:

• Page URL
• Image URL
• Alt Text
• هل Alt Text مفقود؟
• Width
• Height
• Loading Attribute
• Image Status Code
• Content-Type
• حجم الصورة بالـKB إذا كان متاحًا
• SEO Notes
• Last Checked

المطلوب:

• اكتب الكود كاملًا وجاهزًا للنسخ.
• استخدم UrlFetchApp لجلب HTML والصور.
• استخرج جميع وسوم img.
• حوّل روابط الصور النسبية إلى روابط كاملة.
• تعامل مع lazy-loaded images مثل:
  • data-src
  • data-lazy-src
  • srcset
• تجاهل صور Base64 التي تبدأ بـ data:image.
• لا تسجّل الصورة نفسها أكثر من مرة داخل نفس الصفحة.
• علّم الصور التي لا تحتوي على Alt Text.
• علّم الصور التي ترجع 404 أو 500.
• أظهر تحذيرًا للصور الأكبر من 200KB.
• لو تعذّر تحديد حجم الصورة، اكتب Not Available.
• لو كانت الصفحة تحتوي على عدد ضخم من الصور، نفّذ الفحص على دفعات.
• أضف قائمة باسم SEO Tools تحتوي على:
  1. Extract Images
  2. Check Image Status
  3. Continue Process
  4. Clear Image Report
• استخدم ألوانًا مختلفة للمشكلات.
• لا تستخدم خدمات مدفوعة أو مكتبات خارجية.
• اشرح خطوات إضافة الكود وتشغيله ومنح الصلاحيات.

---

4. إنشاء Meta Title وMeta Description بالذكاء الاصطناعي
أنا بستخدم Google Sheets ومحتاجك تكتبلي كود Google Apps Script كامل لإنشاء Meta Titles وMeta Descriptions باستخدام الذكاء الاصطناعي.
المهمة:
عايز السكربت يقرأ بيانات كل صف ويرسلها إلى OpenAI API أو Claude API، وبعدها يكتب Title وDescription مناسبين للسيو.

تنظيم الأعمدة:

• A: اسم الصفحة أو المنتج
• B: الكلمة المفتاحية الأساسية
• C: الكلمات الثانوية
• D: نوع الصفحة
• E: اسم البراند
• F: الجمهور المستهدف
• G: اللغة
• H: نبرة الكتابة
• I: Meta Title
• J: Title Length
• K: Meta Description
• L: Description Length
• M: Status أو Error

قواعد التوليد:

• يكون Title طبيعيًا وجذابًا وغير محشو بالكلمات المفتاحية.
• توضع الكلمة الأساسية بالقرب من بداية Title عندما يكون ذلك طبيعيًا.
• يكون Title مناسبًا للظهور في نتائج البحث.
• يكون Description واضحًا ويحتوي على فائدة وCTA مناسب.
• تجنب الادعاءات غير الموجودة في البيانات.
• دعم اللغة العربية والإنجليزية.
• إرجاع النتيجة بصيغة JSON منظمة تحتوي على title وdescription فقط.

المطلوب:

• اكتب الكود كاملًا وجاهزًا للنسخ.
• اجعل الكود يدعم OpenAI API، ثم وضّح الجزء الذي يمكن تعديله لاستخدام Claude بدلًا منه.
• لا تضع API Key داخل الكود أو الخلايا.
• استخدم Script Properties لحفظ API Key بشكل آمن.
• اكتب دالة منفصلة لحفظ المفتاح مثل setApiKey.
• اشرح بالخطوات طريقة إضافة API Key.
• أضف Custom Function يمكن استخدامها مثل:

=GENERATE_SEO_METADATA(A2,B2,C2,D2,E2,F2,G2,H2)

• وضّح قيود Custom Functions عند الاتصال بالـAPI.
• أضف أيضًا Menu Function لتوليد النتائج لعدة صفوف دفعة واحدة.
• لا تعِد معالجة الصفوف التي تحتوي على نتائج إلا إذا طلب المستخدم ذلك.
• تعامل مع Rate Limits والأخطاء والنتائج غير الصالحة.
• لا تسجّل API Key في Logs.
• أضف قائمة باسم AI SEO تحتوي على:
  1. Generate Selected Rows
  2. Generate All Missing
  3. Retry Failed Rows
• اجعل الكود متوافقًا مع Apps Script V8.
• اشرح طريقة كتابة الدالة داخل الشيت وطريقة تشغيل الأداة من القائمة.

---

5. إنشاء Schema Markup
أنا بستخدم Google Sheets ومحتاجك تكتبلي مشروع Google Apps Script كامل لإنشاء Schema Markup بصيغة JSON-LD.
المهمة:
عايز المستخدم يختار نوع Schema، ويدخل البيانات داخل Google Sheets، والسكربت يولّد كود JSON-LD صالح وجاهز للاستخدام في الموقع.

أنواع Schema المطلوبة:

• Article
• Product
• FAQPage
• LocalBusiness
• BreadcrumbList

المطلوب:

• أنشئ Sheet باسم Schema Input.
• أضف قائمة منسدلة لاختيار نوع Schema.
• أنشئ الأعمدة المطلوبة لكل نوع.
• اقرأ بيانات كل صف وأنشئ JSON-LD مناسبًا.
• ضع النتيجة داخل:
• اكتب النتيجة في عمود Schema Output.
• اكتب نتيجة المراجعة في عمود Validation.
• تحقّق من الحقول الإلزامية قبل إنشاء Schema.
• تجاهل الحقول الاختيارية الفارغة.
• لا تضف بيانات غير موجودة في الشيت.
• تأكد أن JSON الناتج صالح ولا يحتوي على trailing commas.
• أضف Custom Function إن كان ذلك مناسبًا.
• أضف قائمة باسم Schema Tools تحتوي على:
  1. Generate Selected Schema
  2. Generate All
  3. Validate Data
  4. Clear Output
• أضف خيار تصدير النتائج إلى Google Doc أو ملف JSON داخل Google Drive.
• اكتب الكود كاملًا وجاهزًا للنسخ.
• اشرح أسماء الملفات والدوال وطريقة التثبيت والتشغيل.
• أضف أمثلة بيانات لكل نوع Schema.
• لا تستخدم API أو خدمة مدفوعة.

---

6. استخراج وفحص Sitemap
أنا بستخدم Google Sheets ومحتاجك تكتبلي كود Google Apps Script كامل لتحليل وفحص XML Sitemap.
المهمة:
عايز أحط رابط Sitemap في الخلية B1 داخل Sheet باسم Settings، والسكربت يستخرج جميع الروابط ويفحصها.

المطلوب:

• دعم ملفات Sitemap العادية.
• دعم Sitemap Index الذي يحتوي على أكثر من Sitemap.
• التعامل مع XML Namespaces بصورة صحيحة.
• استخراج البيانات التالية:
  • URL
  • Last Modified
  • Change Frequency
  • Priority
  • Source Sitemap
  • Status Code
  • Final URL
  • SEO Issue
  • Last Checked
• وضع النتائج داخل Sheet باسم Sitemap URLs.

المشكلات المطلوب اكتشافها:

• روابط 404 أو 500.
• الروابط التي تعمل Redirect.
• الروابط المكررة.
• روابط HTTP بدل HTTPS.
• روابط تحتوي على Parameters.
• روابط خارج الدومين الأساسي.
• Sitemap فارغ أو غير صالح.

متطلبات التنفيذ:

• استخدم XmlService لتحليل XML.
• استخدم UrlFetchApp لفحص الروابط.
• نفّذ الفحص على دفعات.
• استخدم PropertiesService لحفظ التقدم.
• أضف Trigger مؤقتًا لاستكمال العملية عند اقتراب انتهاء وقت التنفيذ.
• أضف Sheet باسم Sitemap Summary لعرض الإحصائيات.
• أضف قائمة باسم Sitemap Tools تحتوي على:
  1. Import Sitemap
  2. Check URLs
  3. Continue Check
  4. Create Summary
  5. Clear Results
• اكتب الكود كاملًا وجاهزًا للنسخ.
• اشرح طريقة التثبيت والتشغيل ومنح الصلاحيات.
• لا تستخدم أي مكتبات أو خدمات مدفوعة.

---

7. اكتشاف المحتوى المتشابه
أنا بستخدم Google Sheets ومحتاجك تكتبلي مشروع Google Apps Script لاكتشاف الصفحات ذات المحتوى المتشابه.
المهمة:
عايز السكربت يقرأ روابط الصفحات من العمود A، ويستخرج النص الأساسي لكل صفحة، وبعدها يقارن الصفحات لاكتشاف المحتوى المتكرر أو المتشابه.
طريقة المقارنة:
استخدم خوارزمية مناسبة مثل Jaccard Similarity بعد تنظيف النص وتقسيمه إلى مجموعات كلمات أو Shingles.

المطلوب:

• تحميل HTML باستخدام UrlFetchApp.
• إزالة العناصر غير المهمة مثل:
  • script
  • style
  • nav
  • footer
  • header
  • form
• إزالة أكواد HTML والمسافات الزائدة.
• دعم النصوص العربية والإنجليزية.
• حساب عدد الكلمات لكل صفحة.
• مقارنة كل صفحة بباقي الصفحات.
• عدم مقارنة الصفحة بنفسها.
• عدم تسجيل نفس الزوج مرتين.

أنشئ Sheet باسم Similarity Report يحتوي على:

• URL 1
• URL 2
• Similarity Percentage
• Words in URL 1
• Words in URL 2
• Classification
• Notes

التصنيفات:

• Low Similarity
• Medium Similarity
• High Similarity
• Possible Duplicate

متطلبات إضافية:

• اعرض فقط النتائج التي تتجاوز النسبة الموجودة في Settings.
• اجعل النسبة الافتراضية 70%.
• نفّذ المقارنة على دفعات.
• استخدم PropertiesService لحفظ التقدم.
• أضف قائمة باسم Content Tools لتشغيل التحليل ومسح النتائج.
• اكتب الكود كاملًا وجاهزًا للنسخ.
• اشرح حدود دقة الأداة وحدود Google Apps Script.
• لا تستخدم خدمات مدفوعة.

---

8. اقتراح الروابط الداخلية وAnchor Text
أنا بستخدم Google Sheets ومحتاجك تكتبلي كود Google Apps Script كامل لاقتراح فرص الربط الداخلي بين صفحات الموقع.
عندي Sheet باسم Pages يحتوي على:

• : URL
• : Page Title
• : Primary Keyword
• : Secondary Keywords
• : Page Type
• : Priority من 1 إلى 5

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

أنشئ Sheet باسم Internal Link Suggestions يحتوي على:

• Source URL
• Target URL
• Suggested Anchor Text
• النص أو الجملة المحيطة بالـ Anchor
• Relevance Score
• Target Priority
• Status
• Notes

قواعد الاقتراح:

• لا تقترح ربط الصفحة بنفسها.
• لا تقترح رابطًا موجودًا بالفعل داخل Source URL.
• لا تكرر نفس الاقتراح.
• أعطِ أولوية للصفحات ذات Priority الأعلى.
• اجعل Anchor Text طبيعيًا وموجودًا داخل المحتوى.
• لا تعتمد على Exact Match فقط.
• ادعم الكلمات العربية والإنجليزية.
• حدد عدد الاقتراحات لكل صفحة من Sheet باسم Settings.
• لا تقم بتعديل صفحات الموقع؛ المطلوب إنشاء تقرير اقتراحات فقط.

المطلوب:

• اكتب الكود كاملًا وجاهزًا للنسخ.
• استخدم UrlFetchApp.
• نفّذ العمل على دفعات.
• تعامل مع الأخطاء والصفحات المحظورة.
• أضف قائمة باسم Internal Linking تحتوي على:
  1. Analyze Pages
  2. Generate Suggestions
  3. Continue Process
  4. Clear Suggestions
• اشرح طريقة إضافة الكود وتشغيله.
• لا تستخدم مكتبات أو خدمات مدفوعة.

---

9. إنشاء SEO Toolkit كاملة التحدي
أنا بستخدم Google Sheets ومحتاجك تكتبلي مشروع Google Apps Script احترافي يحول الشيت إلى Mini SEO Toolkit.
المهمة:
عايز المشروع يجمع مجموعة أدوات SEO داخل Google Sheets من خلال قائمة مخصصة باسم SEO Tools.

الأدوات المطلوبة:

• Crawl URLs
• Check Status Codes
• Extract Metadata
• Check Sitemap
• Find Duplicate Titles
• Find Duplicate Descriptions
• Check Missing H1
• Generate Schema
• Create SEO Summary
• Continue Previous Job
• Clear Results
• Open Settings

أنشئ Sheets التالية تلقائيًا:

• URLs
• Crawl Results
• Sitemap
• Schema
• Settings
• Logs
• Dashboard

بيانات Crawl Results:

• URL
• Status Code
• Final URL
• Title
• Title Length
• Meta Description
• Description Length
• H1
• H1 Count
• Canonical
• Meta Robots
• Word Count
• SEO Issues
• Last Checked

الـDashboard يعرض:

• إجمالي الروابط.
• عدد صفحات 200.
• عدد Redirects.
• عدد Broken Links.
• عدد Missing Titles.
• عدد Missing Descriptions.
• عدد Missing H1.
• عدد Duplicate Titles.
• عدد صفحات noindex.
• متوسط عدد الكلمات.

متطلبات تقنية:

• استخدم onOpen لإنشاء القائمة.
• استخدم PropertiesService لحفظ تقدم العمليات.
• استخدم LockService لمنع تشغيل عمليتين في الوقت نفسه.
• استخدم CacheService عندما يكون مفيدًا.
• استخدم UrlFetchApp أو fetchAll بصورة آمنة.
• نفّذ العمليات على دفعات.
• أنشئ Trigger مؤقتًا لاستكمال العمل عند اقتراب انتهاء مدة التنفيذ.
• احذف Trigger المؤقت بعد انتهاء المهمة.
• سجّل الأخطاء داخل Sheet باسم Logs.
• لا تجعل خطأ رابط واحد يوقف المشروع بالكامل.
• لا تحذف أو تستبدل بيانات المستخدم دون رسالة تأكيد.
• أظهر Toast Notifications توضح تقدم العمليات.
• لا تستخدم مكتبات أو خدمات مدفوعة.

طريقة كتابة الإجابة:

• لا تعطيني مجرد نموذج أو pseudo-code.
• اكتب المشروع كاملًا وجاهزًا للنسخ.
• قسّم المشروع إلى ملفات Apps Script منظمة.
• اكتب اسم كل ملف قبل الكود الخاص به.
• اشرح وظيفة كل ملف.
• اشرح خطوات التركيب والتشغيل ومنح الصلاحيات.
• اشرح حدود Google Apps Script المتوقعة.
• اجعل المشروع متوافقًا مع Google Apps Script V8.