كيفاش تدير أوديت لحضور العلامة التجارية فمحركات الذكاء الاصطناعي باستعمال EEO

شنو هو EEO؟

EEO كتعني Everything Engine Optimization، وهو مصطلح شامل كيغطي SEO وAEO وGEO وLLMO. هاد المشروع كيساعد العلامات التجارية تفهم وتحسّن الطريقة اللي كاتبان بها فالأجوبة اللي كتنشئها محركات الذكاء الاصطناعي.

EEO كيجمع بين ثلاثة ديال القدرات المرتابطة:

• تدقيق EEO: كيسول محركات الذكاء الاصطناعي أسئلة اللي يقدرو يطرحوها المشترين الحقيقيين، ومن بعد كيقيس مدى ظهور العلامة التجارية فالأجوبة الراجعة. التقارير كتشمل الأجوبة الأصلية باش يمكن تفقدها.
• سجل العلامات التجارية: كيخزن بطاقات علامات تجارية قابلة للقراءة آلياً وكتتبع مخطط eeo.brand.v1. العلامات التجارية تقدر تطالب بالبطاقات ديالها من خلال التحقق من النطاق فطلب سحب عام.
• مولّد المواقع: كيحوّل بطاقات العلامات التجارية لموقع ثابت فيه llms.txt وJSON-LD وملف robots.txt كيسمح لزواحف الذكاء الاصطناعي بالوصول.

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

علاش الظهور ديال العلامة التجارية فـالذكاء الاصطناعي مهم

ملي كيطلب شي مشترٍ من محرك ذكاء اصطناعي توصية، الجواب كيتجمع من المعلومات اللي قراها النموذج، بحال المقالات والتقييمات وصفحات القوائم. الوصف ديال العلامة التجارية براسو يقدر ما يوصلش للنموذج فصيغة منظمة.

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

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

المستودع كيوفر عدة مداخل. اختار اللي كيناسب الهدف ديالك:

• استعمل eeo-local.html لتدقيق سريع من المتصفح بلا ما تثبت والو.
• استعمل cli.cjs للفحوصات القابلة للتكرار، والتدقيقات الجماعية، ومجموعات البيانات، وإعادة الاختبارات المبرمجة.
• استعمل صورة Docker باش تشغل موقع علامات تجارية مجتمعي محلياً.
• استعمل server.cjs ومشروع web/ لنسخة ويب مستضافة ذاتياً من أداة التدقيق.
• استعمل GitHub Action أو خادم MCP أو إضافة Chrome ملي بغيتي تدمج التدقيقات فـسيرورات التطوير أو البحث.

دير تدقيق بملف واحد

1. نزّل الأداة وحلّها

نزّل eeo-local.html من المستودع وحلّو فالمتصفح. هاد النسخة ما كتحتاجش Node.js ولا تثبيت الحزم ولا خادم.

2. اختار المحركات ودخل المفاتيح

اختار المحركات من الكتالوج، اللي فيه 26 إعداداً مسبقاً، من بينها 11 محركاً أصلياً من الصين. لسّق مفاتيح API المطلوبة من طرف المحركات المختارة. الأداة كاتخلي هاد المفاتيح فـlocalStorage ديال المتصفح.

3. عمّر استمارة العلامة التجارية

دخل معلومات العلامة التجارية واختار المجال المناسب. من بعد شغّل التدقيق. EEO كيسول أسئلة موجهة للمشترين وكيقيّم شحال كاتبان العلامة التجارية بشكل بارز فالأجوبة.

4. تفقد التقرير وصدّرو

التقرير فيه تنقيط من S حتى D، ونقط الوعي والذكر، وتفصيل حسب كل محرك، وكل جواب أصلي. تقدر تصدّر النتيجة بصيغة JSON أو تطبعها فـPDF باش تشاركها وتراجعها.

دير التدقيقات من CLI

سيرورة سطر الأوامر كتحتاج Node 18 أو أحدث. الـCLI ما فيه حتى خطوة لتثبيت الاعتماديات فالسيرورة الأساسية ديالو.

1. أنشئ ملف الإعدادات

نسخ إعدادات المثال وعمّر إعدادات المحركات ومفاتيح API اللي ناوي تستعمل:

cp config.example.json config.json

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

2. فحص علامة تجارية وحدة

دير تدقيق لعلامة تجارية وحدة بإدخال الاسم والمجال:

node cli.cjs check 蜜雪冰城 --industry 餐饮

الـCLI كيبعث طلبات التدقيق المهيأة وكيخرج نتائج الظهور الموافقة.

3. دير تدقيق جماعي

حط أسماء العلامات التجارية فملف نصي، اسم واحد فكل سطر، وكتب النتائج فـCSV:

node cli.cjs batch brands.txt --csv result.csv

هاد الشي مفيد ملي كتقارن بين عدة علامات تجارية أو كتنشئ سيرورة تقارير قابلة للتكرار.

4. دير تدقيق لمجموعة بيانات

استعمل أمراً مبنياً على مجموعة بيانات ملي بغيتي تعالج علامات تجارية من فئة صناعية:

node cli.cjs dataset 白酒 --limit 10

الخيار --limit كيخلي التجربة صغيرة. استعمل node cli.cjs --help باش تشوف جميع الأوامر المتاحة، ومن بينها watch لإعادة الاختبارات المبرمجة.

شغّل موقع علامات تجارية مجتمعي بـDocker

سيرورة Docker كتنشئ موقع علامات تجارية من datasets/brands-1k.json. ما كتحتاجش مفاتيح API حيث كاتعرض معلومات العلامات التجارية المنشأة عوض ما تدير تدقيق لمحرك.

docker build -t eeo-community .
docker run -p 8080:80 eeo-community

من بعد ما يبدا الحاوي، حلّ http://localhost:8080. الموقع كيوفر صفحة لكل علامة تجارية وكيشمل دعم llms.txt وJSON-LD وrobots.txt لزواحف الذكاء الاصطناعي.

إعداد Docker هادا مختلف على خادم التدقيق المستضاف ذاتياً. بالنسبة لخادم التدقيق، تفقد server.cjs وconfig.example.json. واجهة الويب تقدر تبنيها بهاد الأوامر:

cd web
npm install
npm run build

كاينة حتى واجهة ويب مبنية من قبل فـpublic/.

فهم بنية المستودع

• eeo-local.html هي أداة تدقيق فملف واحد فيها 26 إعداد مسبق للمحركات.
• cli.cjs كتوفر مسارات check وbatch وdataset وwatch.
• core.cjs فيها محرك التدقيق المشترك اللي كيستعملوه CLI وخادم MCP وGitHub Action.
• server.cjs هي نسخة الخادم المستضاف محلياً، بينما web/ فيها المصدر ديال React وVite.
• action/ فيها GitHub Action باش تشغّل تدقيقات ظهور العلامات التجارية فـ CI.
• mcp/ فيها خادم MCP الخاص بـ Claude Desktop وCursor وWindsurf.
• extension/ فيها إضافة Chrome MV3 للفحص السريع.
• datasets/ فيها المجموعة الكاملة ديال العلامات التجارية وبيانات البداية المنتقاة.
• platform/ فيها سكريبتات التحقق من الادعاءات وإنهاء العملية.
• standards/taxonomy/ فيها خصائص القطاعات وبنوك أسئلة المشترين.
• tools/ فيها مولدات المواقع وllms.txt والمخططات والفهارس.

طالب ببطاقة علامة تجارية أو زيد بطاقة جديدة

طالب ببطاقة موجودة

خاص العلامات التجارية تقلب أولاً فـ datasets/ على بطاقة موجودة. مسطرة المطالبة مشروحة فـ platform/README.md، وكتستعمل التحقق من النطاق عبر طلب سحب عمومي.

هاد المسطرة كتوفّر سجلاً واضحاً كيبين بلي العلامة التجارية كتتحكم فالنطاق الموثّق المرتابط بالبطاقة.

زيد علامة ناقصة

إلا ما كانتش العلامة مدرجة، أنشئ بطاقة وقدّمها حسب CONTRIBUTING.md. تبّع المخطط وقواعد المساهمة ديال المستودع قبل ما تفتح طلب السحب.

مسارات متقدمة ونصائح للمساهمة

ربط نقاط نهاية AI المتوافقة

مراقبو المحركات يقدرو يقترحو إعدادات مسبقة جديدة فكتالوج الكشف. CLI والخادم المستضاف محلياً وخادم MCP يقدرو حتى هما يتاصلو بنقاط نهاية متوافقة مع OpenAI عبر config.json. راجع إرشادات المساهمة قبل ما تزيد إعداداً مسبقاً أو تبدّل سلوك الكشف.

أتمتة التدقيقات المتكررة

استعمل الأمر watch ديال CLI لإعادة الاختبارات المجدولة. وبالنسبة لأتمتة المستودع، فالمجلد action/ كيوفّر GitHub Action يقدر يشغّل تدقيقات الظهور فـ CI. المستودع فيه حتى مسارات للتحقق من الادعاءات وإنهائها، وللتدقيقات الذاتية الشهرية.

استعمل خادم MCP فأدوات AI

خادم MCP متوفر لـ Claude Desktop وCursor وWindsurf. كيعاود يستعمل محرك التدقيق المشترك، وكيخلّي العملاء المتوافقين يوصلو لقدرات التدقيق ديال المشروع عبر تكامل MCP. كوّنو باستعمال نفس إعدادات المحرك والمفاتيح العامة المشروحة فـ config.example.json.

وسّع تصنيفات القطاعات

المساهمون فالتصنيفات يقدرو يزيدو مكتبات خصائص القطاعات وبنوك أسئلة المشترين تحت standards/taxonomy/. قواعد القبول موثقة فـ README ديال التصنيف. إضافة اسم بديل لقطاع كتتوصّف كمساهمة أولى سهلة.

ولّد موارد النشر القابلة للقراءة آلياً

أدوات توليد المواقع تقدر تحوّل بطاقات العلامات التجارية لموقع معلومات ثابت. المخرجات المولّدة معمولة باش تسهّل على المحركات والأدوات الأخرى اكتشاف معلومات العلامات التجارية عبر llms.txt وJSON-LD وقواعد الزحف.

خلي التدقيقات قابلة للفهم

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

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

الخلاصة

EEO كتوفر مساراً مفتوحاً لقياس الطريقة اللي كتوصف بها العلامات التجارية من طرف محركات AI، ولنشر معلومات العلامات التجارية فصيغة منظمة. بدا بـ eeo-local.html لتدقيق بلا تثبيت، وانتقل لـ CLI للخدمة الدفعية أو المجدولة، واستعمل Docker أو الخادم المستضاف محلياً ملي تحتاج نسخة محلية للمجتمع.

من بعد ما تفهم المسار الأساسي، تقدر تطالب ببطاقات العلامات التجارية، وتساهم ببيانات التصنيفات، وتزيد إعدادات مسبقة للمحركات، وتدمج التدقيقات فـ CI، أو تربط خادم MCP بأدوات تطوير AI المتوافقة. المشروع منشور بموجب ترخيص Apache 2.0، بينما ملفات المعيار والتصنيف كتستعمل التراخيص الموثقة فالمستودع.