كيفاش تحوّل ريلز إنستغرام لنظام يومي للبحث على المحتوى باستعمال Claude Code

شنو كيدير Instagram Research Tool

Instagram Research Tool كيحوّل الريلز المحفوظة والبحوث المتخصصة لمكتبة بحث قابلة للبحث. باستعمال Claude Code، يقدر يحلّل النص المفرّغ ديال الريل، والـhook، والفورما، والزاوية، وأرقام الأداء، والبنية البصرية، واللحظات اللي غالباً كتخلي الناس يوقفو التمرير.

كيصاوب حتى تقرير يومي على المحتوى اللي كيدير أداء استثنائي، وكيبرز الريلز اللي كيتفوقو بشكل غير عادي فالمجال ديالك. كل تحليل كيسالي بـhook جديد وسكريبت مكتوب بالأسلوب الموصوف فملف voice.md ديالك، بلا ما ينسخ صاحب المحتوى الأصلي.

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

شنو خاصك

• Claude Code
• Node.js 18 ولا أحدث
• مصدر واحد للبيانات، بحال Sandcastles ولا Apify ولا yt-dlp ولا البيانات ديالك
• اختياري: ffmpeg لتحليل بصري إطار بإطار
• اختياري: Whisper للتفريغ المحلي إلا كان المزوّد ديالك ما كيوفّرش النص المفرّغ
• اختياري: iPhone لحفظ الريلز باستعمال زر المشاركة

المشروع ما فيه حتى dependency ديال npm. إلا بغيتي تستخرج الإطارات، نصّب ffmpeg بهاد الأمر brew install ffmpeg. وللتفريغ المحلي، نصّب Whisper بهاد الأمر pipx install openai-whisper.

اختار مصدر البيانات

مزوّد البيانات كيجيب المواد الأصلية بحال ملفات الفيديو، والكابشنات، والنصوص المفرّغة، وأرقام الأداء. Claude Code كيدير التحليل، وبهذا تقدر تبدّل المزوّد بلا ما تبدّل طريقة التحليل.

• Sandcastles: مزوّد MCP مؤدى عليه، كيوفّر بيانات تحليل الريلز، ونصوص مفرّغة بالتوقيت، وتحليل الـhook، والبحث على المحتوى ذي الأداء الاستثنائي. الـMCP كيتطلب خطة Pro ولا أعلى.
• Apify: كيوفّر بيانات الريلز وملفات الفيديو عبر actors مؤدى عليهم حسب كل نتيجة. كيدعم أبحاث الهاشتاغات اليومية، وكيصنّفها حسب عدد المشاهدات فالساعة بدل نقطة الأداء الاستثنائي.
• yt-dlp: خيار مجاني للروابط العمومية الفردية ديال Instagram وTikTok وYouTube Shorts. يقدر يستعمل Whisper المحلي للنصوص المفرّغة، ولكن عدد مشاهدات Instagram ممكن ما يكونش متاح.
• أي مصدر: استعمل ملف فيديو، ولا تصدير من خدمة أخرى، ولا الأرقام اللي كتدخلها بيدك.

تقدر تستعمل مزوّدين مختلفين لمهام مختلفة، بحال yt-dlp للريلز الفردية وApify ولا Sandcastles للبحوث اليومية. التعليمات الخاصة بكل مزوّد كاينة فمجلد providers ديال المستودع.

ثبّت المشروع وشغّل معالج الإعداد

1. نسخ المستودع ودخل للمجلد ديالو:

git clone https://github.com/manthanpatelll/instagram-research-tool.git
cd instagram-research-tool
claude

1. شغّل معالج الإعداد الأول داخل Claude Code:

/research-setup

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

المستودع كيخزّن الإعدادات الرئيسية ديالك فـconfig.json، وأبحاث المجال ديالك فـniche.json، وتعليمات الكتابة ديالك فـvoice.md. راجع هاد الملفات من بعد الإعداد إلا بغيتي تحسّن النتائج يدوياً.

جرّب مسارات العمل النموذجية أولاً

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

npm run library
npm run sample-report
npm run selftest

• npm run library كيفتح مكتبة نموذجية للريلز.
• npm run sample-report كيفتح تقرير نموذجي على المحتوى ذي الأداء الاستثنائي.
• npm run selftest كيشغّل اختبارات بلا اتصال. التشغيل الناجح كيسالي برمز الخروج 0.

حلّل ريل واحد

منين يكمل الإعداد، مرّر رابط ريل عمومي لمهارة بحث الريلز:

/reel-research <reel link>

الأداة كتجيب البيانات الأصلية المتاحة، وكتوحّد الصيغة ديالها، وكتفرّغ الفيديو من النص عند الحاجة، وكتستعمل الإطارات المستخرجة للتحليل البصري. النتيجة كتتحفظ كملف JSON فـlibrary/reels/ وكتزاد لمكتبة المتصفح.

التحليل العادي كيشمل:

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

عالج الريلز المحفوظة من صندوق الوارد

إلا استعملتي طريقة iPhone الاختيارية، ضغط على Share فالريل واختار Save to Research. الاختصار كيكتب الرابط فملف ديال صندوق الوارد داخل iCloud Drive، واللي يقدر يتزامن مع Mac ديالك.

باش تعالج الروابط المحفوظة، شغّل:

/reel-research inbox

الأداة كتقرا الروابط الجديدة، وكتحللها بالمزوّد اللي اخترتي، وكتزيد النتائج للمكتبة. بلا iPhone، تقدر تلصق الروابط مباشرة فـClaude Code ولا توجّه inboxPath فـconfig.json لملف نصي آخر كيتزامن مع الحاسوب ديالك.

صاوب تقرير يومي على المحتوى ذي الأداء الاستثنائي

وركفلو ديال البحث على المحتوى المختلف كيقلب فالنّيتش اللي مكوّن، كيصفي النتائج، كيدمج التكرارات، وكيصنّف الريلز اللي كيتوافقو مع الشروط. افتراضياً، كيراجع الساعات الـ24 اللي فاتت وكيستبعد الريلز اللي عندها أقل من 2,000 مشاهدة. إلا كانو أقل من 15 ريل كيتوافقو مع الشروط، يقدر يوسّع الفترة حتى لـ48 ساعة.

/outliers

التقرير كيتحفظ فـ reports/ وكيحلّ كصفحة HTML. Claude Code حتى هو كيشـرح أفضل 10 نتائج فالشات وكيقترح زاوية فكرة للمحتوى ديالك.

إلى بغيتي فترة بحث أوسع، استعمل:

/outliers --48h

البحث اليومي الافتراضي كيستعمل الاستعلامات الموجودة فـ niche.json. رتّب هاد الاستعلامات فمجموعات كتعكس الطريقة اللي كيستعملو بها المبدعين فالنّيتش ديالك الكلمات لوصف الريلز وكتابة العناوين ديالها.

فهم مراحل المعالجة

المشروع كيتبع تسلسل واضح من البيانات المصدر حتى لنتيجة البحث:

1. رابط ديال ريل، ملف فيديو، أو تصدير من المصدر كيدخل للوركفلو.
2. المزوّد المختار كيوفّر الأرقام، العناوين، الفيديوهات، أو النصوص المفرّغة.
3. الأداة كتستعمل النص المفرّغ من عند المزوّد، أو كترجع لـ Whisper المحلي ملي كتكون إعدادات التفريغ مضبوطة على auto.
4. frames.mjs كيستعمل ffmpeg باش ينشئ لوحات معاينة للمراجعة البصرية.
5. Claude Code كيحلّل الخطّاف، الفورما، الزاوية، العناصر البصرية، ولحظات الاحتفاظ بالمشاهد.
6. التحليل الكامل كيتحفظ بصيغة JSON وكيبان عبر out/library.html.
7. وركفلو البحث على المحتوى المختلف كيحفظ بيانات البحث الخام، كيصفيها، كيرتّبها، وكيبني تقرير HTML.

ضبط الإعدادات المهمة

حلّ config.json باش تبدّل إعدادات الوركفلو:

• provider كيختار مصدر الريلز الفردية: sandcastles، apify، ytdlp، أو any.
• searchProvider كيختار Sandcastles أو Apify للبحوث اليومية.
• inboxPath كيحدّد ملف صندوق الوارد المتزامن.
• windowHours كيتحكّم فالفترة العادية للبحث على المحتوى المختلف.
• maxWindowHours كيحدّد شحال يقدر التقرير يوسّع فترة البحث.
• minViews كيحيد النتائج ذات المشاهدات القليلة من التقارير.
• transcription كيتحكّم واش يتستعمل النص المفرّغ من المصدر أو Whisper المحلي.
• myHandle كيخزّن، بشكل اختياري، اسم الحساب ديالك فـ Instagram.

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

أتمتة البحث الصباحي ديالك

المستودع فيه إرشادات لأتمتة وركفلو صندوق الوارد والبحث على المحتوى المختلف باستعمال cron أو macOS launchd. الأمثلة المعنية كتشغّل أوامر بحال:

claude -p "/reel-research inbox"
claude -p "/outliers"

شوف docs/iphone-shortcut.md باش تعرف إعداد المشاركة من iPhone وأمثلة الأتمتة اليومية الاختيارية. راجع أي أمر مبرمج قبل ما تفعّلو، خصوصاً إلا كان المزوّد اللي اخترتي كيفرض رسوم على كل نتيجة أو كل تحليل.

استعمل البحث بلا نسخ

الأداة مصمّمة لدراسة الأفكار، ماشي لإعادة نشر المحتوى. استعمل الموضوع، الزاوية، والفورما ديال الريل كبحث، ومن بعد زِد التجربة، النتائج، المنتجات، أو وجهة النظر ديالك.

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

الخلاصة

Instagram Research Tool كيجمع Claude Code مع مزوّد بيانات باش يخلي البحث على الريلز قابل للتكرار. من بعد الإعداد، تقدر تحفظ الريلز من الهاتف ديالك، تحلّلها وحدة بوحدة، تراجع تقرير يومي على المحتوى المختلف، وتطوّر نصوص أصلية انطلاقاً من فورمات وزوايا مجرّبة.

بدا بالأوامر النموذجية، شغّل /research-setup، ومن بعد حسّن niche.json وvoice.md باش يولي البحث مناسب للجمهور ديالك ولأسلوب الكتابة ديالك.