Comprehensive Technical & Operational Manual

Mudawwin Technical & User Knowledge Base

Detailed technical specifications, step-by-step REST API connection protocols, automated publishing setup, SEO gap analysis, technical auditing, and workflow optimization.

Section 1

1. Account Registration, Authentication & 2FA Security

Mudawwin platform protects your automated publishing infrastructure with enterprise-grade authentication protocol:

Google Single Sign-On (SSO)

Instantly register and authenticate using your verified Google Account with one click. No password management required.

Two-Factor Authentication (2FA)

Enable TOTP authenticator apps (Google Authenticator, Authy) from Settings → Security to mandate a 6-digit dynamic code upon login.

Section 2

2. Technical Integration Protocols & API Connections Guide

Below is the exact technical blueprint to configure each publishing target, analytics tool, and AI engine connected to your Mudawwin account:

1. ربط موقع ووردبريس (WordPress REST API / Plugin) REST API

يتم الربط التلقائي عبر بروتوكول WordPress REST API Native Endpoint دون الحاجة لفتح أذونات خطرة:

  1. انتقل لوحة تحكم موقعك الـ WordPress ← أعضاء (Users) ← ملفك الشخصي (Profile).
  2. انزل لأسفل حتى قسم "كلمات مرور التطبيقات (Application Passwords)".
  3. أدخل اسماً للتطبيق (مثلاً: Mudawwin Platform) واضغط "إضافة كلمة مرور جديدة".
  4. انسخ كلمة المرور المكونة من 24 حرفاً (مثل: abcd efgh ijkl mnop qrst uvwx).
  5. في منصة مُدوّن ← انتقل لصفحة "المواقع والربط" ← أدخل رابط الموقع واسم المستخدم وكلمة مرور التطبيق.
  6. خيار الإضافة المباشرة: يمكنك بدلاً من ذلك تنزيل إضافة Mudawwin WordPress Plugin (.zip) وتفعيلها للربط الآلي بضغطة زر واحدة.

2. ربط متجر شوبيفاي (Shopify OAuth & Admin API) خاصة بصاحب المتجر (User / Merchant) OAuth / API Token

هل ينشئ المستخدم تطبيقاً أم الأدمن؟ الربط يتم دائماً من قِبل المستخدم (صاحب المتجر نفسه) لأن لكل متجر صلاحياته المستقلة، ولديه خياران سهلان للربط:

الطريقة الأولى: الربط التلقائي الفوري (OAuth 2.0 - بنقرة واحدة):

انتقل لصفحة "مركز الربط والتكامل" بالمنصة ← اضغط "ربط متجر شوبيفاي" ← أدخل اسم متجرك فقط (مثال: mystore) واضغط موافقة. سيتم تحويلك فوراً لمتجرك لتأكيد الربط التلقائي بنقرة واحدة وبدون الحاجة لإنشاء أي تطبيقات!

الطريقة الثانية: التوكن المباشر (Custom App Admin Token):

إذا فضل صاحب المتجر استخراج توكن مخصص بنفسه: يدخل لوحة متجره الـ Shopify Admin ← Settings ← Develop Apps ← ينشئ تطبيقاً باسم Mudawwin Auto-Blog ويرفقه بصلاحيات write_content و read_content ثم ينسخ التوكن (shpat_...) ويدخله بالمنصة.

3. ربط مدونات بلوجر (Google Blogger API v3) OAuth 2.0

ربط مدونة Blogger عبر مصادقة جوجل الرسمية للنشر الآلي المباشر بتنسيق HTML كامل:

  • اضغط على "ربط حساب Blogger" من لوحة التكاملات.
  • قم بمنح المنصة صلاحية إدارة منشورات المدونة الرسمية عبر Google OAuth.
  • اختر المدونة المستهدفة (Blog ID) وحدد حالة النشر الافتراضية (نشر فوري / مسودة).

4. الربط البرمجي المخصص (Custom Webhooks & REST API Payload) JSON Payload

إذا كان لديك موقع برمجة خاصة (Laravel, React, Node.js, Python)، يمكنك استقبال المقالات عبر Webhook تلقائياً بالتنسيق التالي:

{
  "event": "article.published",
  "title": "عنوان المقال المولد والمعد للسيو",
  "slug": "article-url-slug",
  "html_content": "<h2>مقدمة المقال...</h2><p>المحتوى الكامل...</p>",
  "excerpt": "الملخص التفيذي للمقال في حدود 150 حرف...",
  "featured_image_url": "https://mudawwin.com/storage/uploads/featured_image.jpg",
  "keyword": "الكلمة المفتاحية المستهدفة",
  "category": "قسم المقال",
  "meta_title": "عنوان السيو المخصص لمكائن البحث",
  "meta_description": "وصف السيو المخصص للمقال",
  "signature": "hmac_sha256_verification_hash"
}

يمكنك إضافة رابط الويب هوك الخاص بسيرفرك وكلمة السر التشفيرية (HMAC Secret) لضمان أمان الاتصال.

5. ربط Google Search Console (متابعة الأداء والترتيب) Analytics Sync

ربط حقيقي ومباشر لسحب إحصائيات موقعك من جوجل لمتابعة النقرات ومرات الظهور ومعدل النقر والترتيب المتوسط:

  • اضغط على "ربط Google Search Console" من صفحة التكاملات.
  • قم بمنح الإذن بحساب جوجل الخاص بموقعك واختيار الدومين المستهدف.
  • ملاحظة: تتحدث بيانات جوجل الرسمية تلقائياً كل 48 إلى 72 ساعة داخل لوحة التحكم.

بعد الربط — صفحة "الأداء":

تعرض هذه الصفحة بيانات جوجل الفعلية لكل صفحة/كلمة مفتاحية: عدد النقرات، مرات الظهور، معدل النقر (CTR)، ومتوسط الترتيب (Avg. Position)، مع إمكانية التصفية حسب الفترة الزمنية أو صفحة معيّنة لمعرفة أي المقالات تجلب زيارات فعلية من جوجل وأيها لا يظهر إطلاقاً.

صفحة "الفرص السريعة" (Quick Win Opportunities):

يحلّل النظام بيانات Search Console تلقائياً ليكتشف نوعين من الفرص الجاهزة للتحسين الفوري:

  • قريبة من الصفحة الأولى (Near Top 10): صفحات ترتيبها الحالي بين المركز 11-20 تقريباً — تحسين بسيط قد يدفعها للصفحة الأولى.
  • نسبة نقر منخفضة رغم ظهور جيد (Low CTR): صفحات تظهر كثيراً في نتائج البحث لكن نسبة من ينقر عليها ضعيفة — غالباً بسبب عنوان أو وصف ميتا غير جذّاب.

لكل فرصة مكتشَفة، يقترح الذكاء الاصطناعي عنوان ووصف ميتا محسَّنين جاهزين للتطبيق بضغطة زر واحدة مباشرة على المقال المنشور دون الحاجة لتعديل يدوي بلوحة تحكم الموقع.

Section 3

3. Multi-Site Operation & Platform Management

تتيح لك منصة مُدوّن إدارة أكثر من موقع ومدونة من مكان واحد بسلاسة المطلقة:

  • اختيار الموقع الافتراضي: يمكنك اختيار الموقع المستهدف للنشر الفوري أو تبديل النشر الآلي بين أكثر من موقع بنفس الحساب.
  • فحص صحة الاتصال (Connection Health Check): يقوم النظام باختبار حالة الاتصال دورياً والتنبيه بحال تغير كلمة مرور الموقع أو توقف الـ REST API.
Section 4

4. Automated Publishing (Auto-Blog) & Manual AI Writer Guide

أ) محرك النشر الآلي المستمر (Auto-Blog Campaign):

يسمح لك بضبط حملات نشر أوتوماتيكية بدون تدخل يدوي وفق الخطوات التالية:

  1. انتقل إلى صفحة "خطط النشر الآلي (Auto-Blog)" ← اضغط "إنشاء خطة نشر آلي جديدة".
  2. حدد المنصة المستهدفة (ووردبريس / شوبيفاي / بلوجر / ويب هوك) — يجب أن تكون مربوطة مسبقاً من صفحة "مركز الربط والتكامل".
  3. اختر معدل وتكرار النشر: (مثلاً مقال واحد كل 12 ساعة، أو 3 مقالات يومياً) وحدد ساعات النشر المفضّلة إن أردت توزيعاً طبيعياً غير منتظم بالكامل.
  4. حدد قائمة الكلمات المفتاحية المستهدفة والأقسام (يمكن إدخالها يدوياً أو استيرادها من خطة سيو جاهزة أنشأتها مسبقاً — راجع القسم الخامس أدناه).
  5. اختر طول المقال الافتراضي (قصير/متوسط/طويل) ونبرة الكتابة (رسمية، ودّية، تسويقية...).
  6. فعّل خيار توليد الصور البارزة الذكية (يُنتج صورة مخصصة لكل مقال بالذكاء الاصطناعي تلقائياً) وحدد إن كنت تريد توزيعاً تلقائياً لعناوين H2/H3 وجدول محتويات وروابط داخلية لأحدث المقالات.
  7. اختر حالة النشر: نشر فوري مباشر أو حفظ كمسودة للمراجعة اليدوية قبل الظهور للزوار.
  8. اضغط تفعيل الخطة — وسيعمل Cron Job الخاص بالمنصة على كتابة ونشر المقالات بمواعيدها بدقة متناهية دون أي تدخل إضافي منك.
  9. يمكنك متابعة حالة كل مقال (منشور / قيد الكتابة / فشل) من نفس صفحة الخطة، وإيقاف الحملة مؤقتاً أو حذفها في أي وقت.

ب) معالج كتابة المقال اليدوي (Manual Article Writer):

مناسب للمقالات الخاصة التي ترغب في صياغتها ومراجعتها بنفسك قبل النشر:

  1. أدخل الكلمة المفتاحية الرئيسية وتصنيف نية البحث (معلوماتية Informational، تجارية Commercial، أو شرائية Transactional) — هذا يوجّه أسلوب الذكاء الاصطناعي في الكتابة.
  2. اختر طول المقال (قصير 800 كلمة / متوسط 1500 كلمة / طويل 2500+ كلمة متعمق).
  3. سيقترح النظام عنواناً وهيكل عناوين فرعية (H2/H3) قابلة للتعديل قبل توليد المحتوى الكامل.
  4. بعد التوليد، قم بمراجعة المقال داخل محرر النصوص الغني (Rich Text Editor) — يمكنك تعديل النص، إدراج صور إضافية، أو طلب "إعادة صياغة فقرة" لأي جزء لا يعجبك.
  5. حدد الموقع المستهدف للنشر من القائمة المنسدلة، واختر "نشر الآن" للنشر الفوري أو "جدولة" لتحديد تاريخ/وقت لاحق.
Section 5

5. AI SEO Plan Generator, Competitor Gap & Rank Tracking

تعتمد خطة السيو على تحليل محرك البحث وجوجل لنشر محتوى متصدّر يتوافق مع Google AI Overview. صفحة "خطة محتوى SEO" تسير بخطوات متسلسلة واضحة:

الخطوة 1: إضافة مصدر جديد للخطة

  1. اضغط "إضافة خطة جديدة" من صفحة "خطة محتوى SEO".
  2. اختر الموقع/الاتصال المستهدف (الحساب المربوط الذي سيُنشر عليه المحتوى لاحقاً).
  3. أدخل رابط الصفحة أو الموقع الذي تريد بناء خطة محتوى حوله (يُستخدَم لفهم مجال الموقع تلقائياً واستخراج كلمات مناسبة له).
  4. حدد النطاق الجغرافي المستهدف (Target Geo) — يؤثر على اقتراحات الكلمات المفتاحية وحجم البحث التقديري.

الخطوة 2: استخراج الكلمات والفرص

يولّد النظام تلقائياً قائمة كلمات مفتاحية رئيسية وجانبية (LSI) مع مؤشر "مستوى الفرصة" وحجم البحث التقديري. حدّد ✓ بجانب كل كلمة تريد إدراجها في الخطة، أو أضف كلمتك الخاصة يدوياً من حقل "أضف كلمة مفتاحية خاصة بك".

الخطوة 3: فجوة المنافسين (اختياري)

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

الخطوة 4: تتبع الترتيب (SerpApi)

بعد نشر المقالات، يفحص النظام أول 50 نتيجة بحث في جوجل دورياً لمعرفة ترتيب كل كلمة مفتاحية ورصد تقدّم الصفحة عبر الزمن.

الخطوة 5: توليد وتحرير جدول المحتوى

  1. بعد اختيار الكلمات، اضغط "توليد الخطة" وحدد: طول كل مقال (word_count)، تاريخ بداية النشر، وعدد الأيام الفاصلة بين كل مقال والتالي.
  2. سيبني النظام جدولاً كاملاً (عنوان مقترح + كلمة مفتاحية + ملخص/بريف + تاريخ ووقت نشر مقترح) لكل بند في الخطة.
  3. يمكنك تعديل أي عنوان أو كلمة أو بريف أو موعد نشر يدوياً في الجدول قبل الاعتماد، أو حذف أي بند لا يناسبك.

الخطوة 6: اعتماد الخطة وتفعيل النشر

عند الرضا عن الجدول، اضغط "اعتماد الخطة" واضبط خيارات النشر النهائية:

  • اختر حساب/حسابات النشر (يمكن النشر على أكثر من موقع لنفس الخطة).
  • حدد حالة النشر الافتراضية (نشر فوري أو مسودة للمراجعة).
  • فعّل توليد صورة بارزة تلقائية لكل مقال، مع إمكانية إضافة نص حقوق نشر (Watermark) على الصور.
  • فعّل إدراج صور داخل المقال وجدول محتويات تلقائي (TOC) وربط داخلي تلقائي لأحدث المقالات لتقوية هيكل السيو.
  • أضف تعليمات مخصصة إضافية للذكاء الاصطناعي إن أردت (مثل: "أضف انفوجراف نصي يلخص أهم الإحصائيات").
  • بعد التفعيل، سينشر النظام مقالات الخطة تلقائياً حسب الجدول والمواعيد المحددة بالضبط بنفس آلية Auto-Blog الموضحة بالقسم الرابع.
Section 6

6. Technical SEO Audit, One-Click Auto-Fix & Instant Indexing

يعد مركز الفحص والتحليل التقني والأرشفة منظومة فحص شاملة تفحص أي صفحة أو مقال على موقعك وتحللها وفق 35+ فحصاً معيارياً يغطي البنية الهيكلية، الأمان، وسوم الميتا، السكيما، وسرعة التحميل، مع نقطة جودة تقنية دقيقة من 100:

الأمان والبروتوكول (Security)

  • فحص شهادة SSL/HTTPS والتأكد من التشفير.
  • كشف المحتوى المختلط (Mixed HTTP/HTTPS Resources).
  • فحص ترويسات الأمان (X-Frame-Options, HSTS).

الميتا والكانونيكال (Meta & Canonical)

  • طول وسرعة وسم العنوان <title> (15-60 حرفاً).
  • وصف الميتا meta description وجودة الكلمات المفتاحية.
  • وسم Canonical لمنع مشاكل المحتوى المكرر.
  • وسوم بطاقات السوشيال OpenGraph و Twitter Cards.
  • فحص وسم noindex ومشاكل منع الفهرسة العرضية.

بنية المحتوى والسكيما (Content & Schema)

  • هيكلية العناوين الهرمية (H1 واحد فقط، H2، H3).
  • كشف وتوليد بيانات السكيما المنظمة (JSON-LD Schema).
  • فحص نصوص alt للصور والتحميل الكسول (Lazy Loading).
  • فحص التوافق التام مع شاشات الهواتف الذكية (Viewport).

الأداء وتقارير جوجل (Core Web Vitals)

  • زمن استجابة الخادم ومؤشر TTFB الأولي.
  • تقارير Google PageSpeed Insights الرسمية على الجوال والديسكتوب.
  • قياس مؤشرات LCP, CLS, INP وحجم ملفات الأكواد المضغوطة.

الإصلاح الآلي بضغطة زر (One-Click Auto-Fix)

بدلاً من إضاعة ساعات في تعديل ملفات الموقع يدوياً، يتيح لك النظام زر "إصلاح المشاكل آلياً" الذي يحقن وسوم الميتا الناقصة، يصحح وسم الكانونيكال، يولد سكيما JSON-LD احترافية، ويصلح أخطاء الصور تلقائياً على الموقع المربوط.

طلب الأرشفة الفورية (Google Instant Indexing)

بمجرد فحص أو نشر أي صفحة، يمكنك بضغطة زر إرسال طلب "أرشفة فورية" مباشرة عبر Google Indexing API، ليقوم عناكب جوجل بزحف الصفحة وتحديث تصنيفها في دقائق معدودة بدلاً من الانتظار لأسابيع.

Section 8

8. Social Media Campaigns & Email Marketing Center

أدوات تسويق متكاملة لتحويل المقالات إلى منشورات وحملات بريدية:

منشورات التواصل الاجتماعي

توليد منشورات مخصصة لفيسبوك، تويتر (X)، ولينكد إن مع الهاشتاجات المناسبة مشتقة من المقال.

النشرات البريدية المباشرة

صياغة رسائل بريدية تسويقية مقنعة وإرسالها للمشتركين للترويج للمحتوى الجديد.

Section 9

9. Internal Links, Thin/Duplicate Content Detector & Content Refresh

تساعد هذه الأدوات الثلاثة معاً على بناء هيكلية سيو صحية داخل موقعك: ربط داخلي قوي، محتوى ذو قيمة حقيقية بلا تكرار، ومقالات قديمة محدَّثة باستمرار.

أ) خريطة الربط الداخلي (صفحة "خريطة الربط الداخلي")

رسم مرئي للربط الداخلي الفعلي بين مقالاتك المنشورة، يفضح "الصفحات اليتيمة" (Orphan Pages) التي لا يربطها أي مقال آخر — وهي مشكلة سيو شائعة تجعل جوجل يقلّل من أهميتها:

  1. اختر الموقع المستهدف من القائمة (يتطلب موقع ووردبريس مربوط ولديه مقالات منشورة عبر المنصة).
  2. اضغط "فحص الموقع الآن" — يزحف النظام على كل مقالاتك المنشورة فعلياً ويرسم شبكة الروابط بينها.
  3. راجع قائمة الصفحات اليتيمة (بلا أي رابط داخلي واردة إليها) وقائمة عناقيد المواضيع المبنية تلقائياً من خطط السيو الموجودة.
  4. لكل صفحة، يقترح النظام مقالات أخرى مناسبة يمكن الربط منها إليها مع نص الرابط المقترح (Anchor Text).
  5. اضغط "تطبيق" بجانب أي اقتراح ليُضاف الرابط تلقائياً داخل محتوى المقال المصدر على موقعك مباشرة (بدون تعديل يدوي)، أو "نسخ" لتطبيقه بنفسك يدوياً لاحقاً.

ب) كاشف المحتوى الرقيق والمكرر (صفحة "كاشف المحتوى الرقيق والمكرر")

جوجل يعاقب المواقع التي بها نسبة كبيرة من المحتوى الضعيف القيمة أو المتشابه بشدة بين عدة صفحات — هذه الأداة تكتشف الحالتين تلقائياً في كل مقالاتك المنشورة:

  • المحتوى الرقيق (Thin Content): أي مقال عدد كلماته أقل من 300 كلمة يُصنَّف تلقائياً "رقيق" وقيمته منخفضة في نظر جوجل.
  • المحتوى المكرر (Duplicate Content): يقارن النظام كل زوج من مقالاتك ببعضه، ويُبلّغ عن أي زوج تجاوزت نسبة التشابه بينهما الحد المعقول (احتمال كبير أن يكونا نفس الموضوع بصياغة شبه متطابقة).

خطوات الاستخدام:

  1. من صفحة "كاشف المحتوى الرقيق والمكرر"، اضغط "فحص الآن" ليمسح النظام كل مقالاتك المنشورة ويحسب عدد الكلمات ونسبة التشابه بينها.
  2. ستظهر قائمتان: مقالات مصنَّفة "رقيقة" مرتبة من الأقل كلمات، وأزواج مقالات مصنَّفة "متشابهة/مكررة".
  3. لكل مقال رقيق، لديك خياران: "توسيع" — يطلب من الذكاء الاصطناعي توسيع المقال بمحتوى إضافي ذي قيمة معلوماتية حقيقية (وليس حشواً) وينشر النسخة الموسّعة فوراً على موقعك محل القديمة تلقائياً، أو "تجاهل" — لإخفائه من القائمة الحالية دون أي تعديل إذا كنت راضياً عنه كما هو (سيظهر مجدداً فقط لو تغيّر شيء في فحص لاحق).
  4. للمقالات المتشابهة/المكررة، راجع الزوج يدوياً وقرر: هل تدمج المقالين في واحد أشمل، أم تعيد صياغة أحدهما بزاوية مختلفة تماماً، أم تضيف وسم canonical يوجّه جوجل للنسخة الأساسية.

ج) تحديث المحتوى القديم (Content Refresh)

محركات البحث الحديثة وأنظمة الإجابة التوليدية (AI Overview) تفضّل صراحة المحتوى المُحدَّث حديثاً على المحتوى القديم الراكد. هذه الميزة تراجع مقالاتك المنشورة على ووردبريس التي مرّ عليها وقت طويل، وتُحدّث معلوماتها وأرقامها بالذكاء الاصطناعي (دون إعادة كتابة المقال بالكامل من الصفر):

ملحوظة مهمة: هذه الميزة يدوية بالكامل حالياً — لا يوجد تحديث تلقائي عبر الكرون. لازم تدخل بنفسك لصفحة "تحديث المحتوى" وتضغط تشغيل الفحص/التحديث متى أردت. الإعدادات أدناه (عدد الأيام، أقصى عدد مقالات) بتتحكم في سلوك التشغيل اليدوي فقط.

  • يُضبَط من صفحة "موديلات الذكاء الاصطناعي" بالإدارة (كارت "تحديث المحتوى القديم"): عدد الأيام التي تجعل المقال "قديماً" ومؤهَّلاً للتحديث، وأقصى عدد مقالات يُحدَّث في كل مرة تشغّلها يدوياً (لتفادي استهلاك حصة الذكاء الاصطناعي دفعة واحدة).
  • يراجع النظام كل مقال مؤهَّل ويحدّث الإحصائيات/الأرقام/المعلومات المتغيّرة بداخله دون المساس بهيكل المقال أو رابطه (Slug) حتى لا يفقد أي ترتيب أو نقرات مكتسبة مسبقاً.
  • مدعومة حالياً لمواقع ووردبريس المربوطة عبر المنصة فقط.
Section 10

10. Subscription Packages, Word Quotas & Upgrades

يمكنك الاطلاع على رصيد الكلمات المتبقي وحجم الاستهلاك من الشريط العلوي (Topbar) دائماً، والترقية المباشرة عبر صفحة الباقات والأسعار بالدفع الإلكتروني أو اليدوي.

Section 11

11. Support Tickets & Specialist Assistance

فريق الدعم الفني متواجد لمساعدتك عبر مركز الرسائل وتذاكر الدعم على مدار الساعة للإجابة عن أي استفسار تقني أو فني.

Section 12

12. Account Profile Settings & Security Management

يمكنك التحكم في بيانات حسابك وتخصيص إعداداتك الشخصية من صفحة "الإعدادات":

  • الملف الشخصي: تعديل الاسم، البريد الإلكتروني، وتغيير كلمة المرور.
  • الأمان والمصادقة (2FA): تفعيل المصادقة الثنائية لحماية حسابك عبر تطبيق Authenticator.
  • الجلسات النشطة: مراجعة الأجهزة المسجلة لحسابك وتسجيل الخروج منها في حال الحاجة.