لا تصبح بيانات تحسين محركات البحث مفيدة فعلاً إلا عندما تقود إلى قرار. تعرض Google Search Console وBing Webmaster Tools النقرات ومرات الظهور ونسبة النقر إلى الظهور ومتوسط الترتيب، لكنني أردت طريقة قابلة للتكرار تحول هذه الأرقام إلى عمل واضح: صفحات تحتاج إلى تحسين، مقالات ينبغي كتابتها، روابط داخلية يجب إضافتها، وروابط قديمة تستحق النقل.

من هنا أنشأت المشروع المفتوح المصدر GSC + Bing to Obsidian SEO Pipeline. وهو أداة سطر أوامر مكتوبة بلغة TypeScript تجمع بيانات أداء البحث وتحول مساحة Obsidian إلى قاعدة معرفة عملية لتحسين محركات البحث.

لماذا أنشأت هذا المشروع؟

أدير أكثر من خاصية بحث: موقعاً أساسياً، ومحتوى داعماً، وخصائص قديمة قد تحتفظ بتاريخ مهم. مراجعة كل لوحة تحكم بمفردها تجعل رؤية العلاقة بين هذه المصادر صعبة.

كنت أريد إجابات عن أسئلة عملية أكثر:

  • ما الكلمات غير المرتبطة بالعلامة التجارية التي تحتل المراتب من 5 إلى 20؟
  • ما الصفحات التي تحصل على مرات ظهور كثيرة ونسبة نقر منخفضة؟
  • أين يمكن إضافة رابط من مقال في المدونة إلى صفحة أساسية؟
  • هل تتنافس عدة صفحات على هدف البحث نفسه؟
  • هل ما زالت خاصية قديمة تظهر لكلمات تستحق النقل إلى الموقع الحالي؟

وأردت الاحتفاظ بالدليل الخام أيضاً. يجب أن تكون كل توصية قابلة للتتبع إلى كلمة بحث وصفحة وفترة زمنية ومجموعة محددة من المقاييس.

كيف يعمل المسار؟

يمر المشروع بأربع مراحل رئيسية.

1. قراءة خصائص البحث المضبوطة

تُعرّف كل خاصية كمصدر له معرّف واسم ورابط ونوع ونمط اختياري للتعرف إلى كلمات العلامة التجارية. ويمكن للنوع أن يميز بين الموقع الأساسي والمدونة والموقع القديم وأي مصدر مخصص آخر.

تبقى المعلومات الحساسة محلياً. تُستبعد بيانات الدخول ومفاتيح API ومسارات Obsidian وملفات المصادر الحقيقية من Git، بينما توضح ملفات أمثلة آمنة طريقة الإعداد.

2. جلب بيانات البحث اليومية

بالنسبة إلى Google، تستخدم الأداة Search Console API وتطلب عدة صور للفترة نفسها: الكلمات، والصفحات، وعلاقة الكلمة بالصفحة، والبلدان، والأجهزة، والصفوف المؤرخة. وتدعم جلب النتائج على دفعات من 25 ألف صف.

تُجلب الفترات يوماً بعد يوم. وهكذا تتكون لقطات يومية يمكن مراجعتها قبل دمجها في ملفات للفترة والسنة. وعند الدمج، تُحسب نسبة النقر ومتوسط الترتيب الموزون من جديد بدلاً من حساب متوسط لقيم هي في الأصل متوسطات.

أضاف التحديث الأخير دعم Bing Webmaster Tools. وبما أن واجهته تختلف عن Google، يجلب المهايئ إحصاءات الكلمات والصفحات وعلاقات الصفحة بالكلمة، ثم يوحدها ضمن الأعمدة الأساسية نفسها ويحدد محرك البحث في كل صف. تبقى بيانات Google وBing منفصلة داخل SEO/GSC/ وSEO/Bing/، لذلك يمكن مقارنتها من دون خلطها عن طريق الخطأ.

3. حفظ ملفات CSV الخام

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

تتحول مساحة Obsidian إلى أرشيف ومساحة عمل في الوقت نفسه:

SEO/
  GSC/
    sources/<source-id>/raw/daily/
    sources/<source-id>/raw/ranges/
    sources/<source-id>/raw/yearly/
    sources/<source-id>/reports/
    sources/<source-id>/ideas/
    combined/
  Bing/
    sources/
    combined/

تتيح المستويات اليومية والدورية والسنوية فحص يوم واحد أو دراسة مدة حملة أو بناء جدول تحليلي لسنة كاملة.

4. تحويل المقاييس إلى خطوات عملية

تستبعد طبقة التقارير كلمات العلامة التجارية عندما يكون المرشح مضبوطاً، ثم تبحث عن إشارتين مفيدتين:

  • علاقة كلمة وصفحة لديها مرات ظهور مرتفعة ونسبة نقر أقل من 2%؛
  • كلمة لديها 50 مرة ظهور على الأقل وترتيب من 5 إلى 20.

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

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

الأوامر التي أستخدمها

بعد تجهيز الإعدادات المحلية، أستطيع التحقق من صلاحية الوصول من دون تنزيل البيانات:

pnpm gsc:verify
pnpm bing:verify

ثم يمكنني جلب آخر 30 يوماً لكل المصادر المفعلة:

pnpm gsc:pull -- --all --last-days 30
pnpm bing:pull -- --all --last-days 30

لا يحتاج التحليل المحلي إلى الاتصال بـGoogle مرة أخرى، بل يعيد بناء التقارير من ملفات CSV اليومية المحفوظة في Obsidian:

pnpm gsc:analyze -- --all --from 2026-06-01 --to 2026-06-30
pnpm gsc:rebuild

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

كيف تطور المشروع؟

أنشأت النسخة العملية الأولى في 25 حزيران 2026. كانت تدعم تسجيل الدخول إلى Google وجمع البيانات وتصدير CSV وإنشاء تقارير Markdown والتحليل المحلي واستخراج النتائج المشتركة بين المصادر.

في 30 حزيران، نقلت تعريفات المصادر الحقيقية إلى ملف gsc-sources.json محلي يتجاهله Git، وحسّنت أمثلة الإعداد والشرح، وأضفت صورة البنية المستخدمة في هذا المقال. جعلت هذه التعديلات مشاركة المستودع أكثر أماناً وفهمه أسهل.

في 12 تموز، وسعت المشروع ليدعم Bing Webmaster Tools. أضاف التحديث أوامر مستقلة للتحقق والجلب، ومهايئاً خاصاً بواجهة Bing، وتخزيناً يراعي محرك البحث، ومخرجات متوافقة مع الأبعاد التي يوفرها Bing. تُحفظ الملفات الفارغة عمداً عندما لا يعيد Bing صفوفاً مطابقة أو لا يوفر بُعداً مقابلاً لما لدى Google؛ فهي سجل تدقيق يوضح غياب النتيجة بدلاً من إخفائه.

ما الذي تعلمته؟

الجزء الأهم في المشروع ليس الاتصال بواجهة API، بل نموذج البيانات المحيط به.

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

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

الشيفرة المصدرية ودليل الإعداد متاحان على GitHub.