الدليل

كيفية استخدام commentpull

Download the browser extension, install it, and extract Facebook comments in a few clicks. YouTube works without the extension; Instagram support through the extension is coming soon.

commentpull في المرحلة التجريبية (Beta)

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

المصدر المتاح — تحقّق من الكود بنفسك

المشروع كاملاً، بما في ذلك الموقع وإضافة المتصفح هذه، متاح للعموم على GitHub. لا يتعين عليك تصديق كلامنا حول ما يفعله — اقرأ الكود بنفسك أو اطلب من شخص تثق به أن يفعل: github.com/Arthurdotself/CommentPull.

كيف يعمل

  • Facebook — uses the CommentPull browser extension. It reads the comments Facebook already shows to your logged-in account, inside your browser, and hands them to this page. No Facebook password or token is shared with us.
  • Instagram — coming soon. It is planned to work the same way as Facebook, through the browser extension.
  • YouTube — you paste your own YouTube Data API key and your browser talks to Google directly.

تحتاج عملية فيسبوك فقط إلى الإضافة. توضح الخطوات أدناه كيفية تشغيلها.

1

نزّل الإضافة

نزّل الإضافة كملف ZIP (يحتوي فقط على مجلد browser-extension) وفك ضغطه في مكان ستحتفظ به. الكود المصدري الكامل متاح أيضاً في مستودع GitHub العام.

تنزيل ZIP عرض على GitHub

تفضّل سطر الأوامر؟ نفّذ git clone https://github.com/Arthurdotself/CommentPull.git.

بعد فك الضغط، الإضافة هي المجلد المسمى browser-extension — الذي يحتوي على الملف manifest.json.

2

ثبّتها في متصفحك

تعمل في Chrome ومتصفحات Chromium الأخرى مثل Edge وBrave وOpera.

  1. افتح صفحة الإضافات: اكتب chrome://extensions في شريط العنوان (edge://extensions في Edge، وbrave://extensions في Brave).
  2. فعّل وضع المطوّر (Developer mode) (المفتاح في الزاوية العلوية).
  3. اضغط Load unpacked (تحميل إضافة غير مضغوطة) واختر مجلد browser-extension.
  4. اضغط أيقونة القطعة (puzzle) في شريط الأدوات وثبّت «CommentPull Lab» ليسهل فتحها.

مهم أن تعرف: الإضافة ليست موجودة في متجر Chrome الإلكتروني بعد، لذلك قد يعرض متصفحك تنبيه «وضع المطوّر» عند التشغيل — وهذا طبيعي. أبقِ المجلد في المكان الذي فككت فيه الضغط (يحمّل المتصفح الإضافة منه)، واضغط أيقونة إعادة التحميل على الإضافة بعد تحديث الملفات. لا يتم دعم Safari وFirefox حالياً.

Extension not detected yet

بعد تثبيت الإضافة أو إعادة تحميلها، حدّث هذه الصفحة. يتحول هذا المؤشر إلى الأخضر عندما تعمل.

3

استخرج التعليقات

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

For YouTube, paste your YouTube Data API key — it doesn't need the extension. Instagram support is coming soon.

الوضع اليدوي (اختياري)

يمكنك أيضاً تشغيل الإضافة بنفسك: افتح منشوراً على فيسبوك، واضغط أيقونة الإضافة، وحدّد حداً أقصى، ثم اضغط «Start collecting» (أو «Snapshot visible» لالتقاط سريع). ثم استورد النتائج المحفوظة أدناه.

استيراد النتائج من الإضافة

تبقى النتائج في متصفحك — لا يتم رفع أي شيء.

No results imported yet.

استكشاف الأخطاء وإصلاحها

  • «لم يتم اكتشاف الإضافة» — تأكد من تفعيلها في صفحة الإضافات، ثم حدّث commentpull. وإذا حدّثت الملفات للتو، فاضغط أيقونة إعادة تحميل الإضافة أولاً.
  • صفر تعليقات أو عدد قليل جداً — يغيّر فيسبوك بنية صفحاته كثيراً، لذلك قد يتأخر المجمِّع عن التغييرات. افتح نافذة الإضافة، واضغط Debug info (ينسخ تقريراً لا يحتوي على نص أي تعليق) وأرفقه ببلاغ على GitHub.
  • تتوقف العملية مبكراً — يجب أن يبقى تبويب فيسبوك مفتوحاً وأن تبقى مسجلاً دخولك. تستغرق المنشورات الكبيرة جداً وقتاً؛ ويمكنك تحديد حد أقصى في نافذة الإضافة.
  • لا يمكنك رؤية المنشور — تقرأ الإضافة فقط ما يعرضه فيسبوك لحسابك أنت. ولا تتجاوز تسجيل الدخول أو إعدادات الخصوصية.

ما تستطيع الإضافة فعله وما لا تستطيعه

  • تعمل فقط على facebook.com وعلى صفحات commentpull.com. صلاحياتها الوحيدة هي activeTab وstorage.
  • لا ترسل أي طلبات شبكة من تلقاء نفسها: تُحفظ التعليقات المجموعة في التخزين المحلي للإضافة وتُمرَّر إلى صفحة commentpull المفتوحة في متصفحك. يمكنك مسحها في أي وقت من لوحة الاستيراد أعلاه.
  • تمرّر الصفحة وتضغط فقط عناصر التحكم الموجودة فيها مثل «عرض المزيد من التعليقات» و«الردود» وقائمة ترتيب التعليقات حتى تُحمَّل تعليقات أكثر. ولا تحتوي على أي كود يقرأ كلمة مرورك أو ملفات تعريف الارتباط أو رسائلك، أو ينشر أو يعجب أو يعلّق نيابةً عنك — ويمكنك التأكد من ذلك في الكود المصدري.
  • قد يخالف الجمع الآلي شروط فيسبوك. استخدمها فقط على المحتوى المسموح لك بعرضه ومعالجته، واقرأ الشروط وسياسة الخصوصية.

يمكن التحقق من كل عبارة من هذه العبارات في الكود المصدري — وهذا هو سبب إبقائه عاماً.