
انسٹاگرام ریسرچ ٹول کیا کرتا ہے
انسٹاگرام ریسرچ ٹول محفوظ کردہ ریلز اور مخصوص موضوعات کی تلاش کو ایک قابلِ تلاش تحقیقی لائبریری میں تبدیل کرتا ہے۔ Claude Code کے ذریعے یہ کسی ریل کے ٹرانسکرپٹ، ہُک، فارمیٹ، زاویے، کارکردگی کے اعداد، بصری ساخت اور ممکنہ طور پر اسکرول روکنے والے لمحات کا تجزیہ کر سکتا ہے۔
یہ روزانہ ایک آؤٹ لائر رپورٹ بھی تیار کرتا ہے، جس میں آپ کے نِش میں غیر معمولی طور پر اچھی کارکردگی دکھانے والی ریلز نمایاں کی جاتی ہیں۔ ہر تجزیے کے اختتام پر آپ کی voice.md فائل میں بیان کردہ انداز میں ایک نیا ہُک اور اسکرپٹ لکھا جاتا ہے، اصل تخلیق کار کی نقل نہیں کی جاتی۔

تیار کردہ لائبریری آپ کے براؤزر میں کھلتی ہے، جہاں آپ تحقیق کی گئی ریلز کا موازنہ کر سکتے ہیں اور فلم بندی سے پہلے آئیڈیاز دوبارہ دیکھ سکتے ہیں۔
آپ کو کیا چاہیے
- Claude Code
- Node.js 18 یا اس کے بعد کا ورژن
- ایک ڈیٹا سورس، جیسے Sandcastles، Apify، yt-dlp، یا آپ کا اپنا ڈیٹا
- اختیاری: فریم بہ فریم بصری تجزیے کے لیے ffmpeg
- اختیاری: مقامی ٹرانسکرپشن کے لیے Whisper، جب آپ کا فراہم کنندہ ٹرانسکرپٹ فراہم نہ کرے
- اختیاری: Share بٹن کے ذریعے ریلز محفوظ کرنے کے لیے iPhone
اس پروجیکٹ میں npm کی کوئی dependency نہیں ہے۔ اگر آپ فریم نکالنا چاہتے ہیں تو brew install ffmpeg کے ذریعے ffmpeg انسٹال کریں۔ مقامی ٹرانسکرپشن کے لیے pipx install openai-whisper کے ذریعے Whisper انسٹال کریں۔
ڈیٹا سورس منتخب کریں
ڈیٹا فراہم کنندہ ویڈیو فائلیں، کیپشنز، ٹرانسکرپٹس اور کارکردگی کے اعداد جیسے ماخذ مواد حاصل کرتا ہے۔ تجزیہ Claude Code کرتا ہے، اس لیے آپ تجزیے کے ورک فلو میں تبدیلی کیے بغیر فراہم کنندگان تبدیل کر سکتے ہیں۔
- Sandcastles: ایک بامعاوضہ MCP فراہم کنندہ، جو ریل بریک ڈاؤن ڈیٹا، ٹائم شدہ ٹرانسکرپٹس، ہُک کا تجزیہ اور آؤٹ لائر تلاش فراہم کرتا ہے۔ MCP کے لیے Pro پلان یا اس سے اعلیٰ پلان درکار ہے۔
- Apify: بامعاوضہ، فی نتیجہ actors کے ذریعے ریل کا ڈیٹا اور ویڈیو فائلیں فراہم کرتا ہے۔ یہ روزانہ ہیش ٹیگ تلاشوں کو سپورٹ کرتا ہے، جن کی درجہ بندی آؤٹ لائر اسکور کے بجائے فی گھنٹہ ویوز کی بنیاد پر ہوتی ہے۔
- yt-dlp: انفرادی عوامی Instagram، TikTok اور YouTube Shorts لنکس کے لیے ایک مفت آپشن ہے۔ یہ ٹرانسکرپٹس کے لیے مقامی Whisper استعمال کر سکتا ہے، لیکن Instagram کے ویو کاؤنٹس دستیاب نہ بھی ہوں۔
- کوئی بھی سورس: ویڈیو فائل، کسی دوسری سروس سے ایکسپورٹ، یا وہ اعداد استعمال کریں جو آپ خود درج کریں۔
آپ مختلف کاموں کے لیے مختلف فراہم کنندگان استعمال کر سکتے ہیں، مثلاً انفرادی ریلز کے لیے yt-dlp اور روزانہ کی تلاشوں کے لیے Apify یا Sandcastles۔ فراہم کنندہ سے متعلق ہدایات repository کی providers ڈائریکٹری میں موجود ہیں۔
سیٹ اپ وزرڈ انسٹال کریں اور چلائیں
- repository کو کلون کریں اور اس کی ڈائریکٹری میں جائیں:
git clone https://github.com/manthanpatelll/instagram-research-tool.git
cd instagram-research-tool
claude- Claude Code کے اندر پہلی بار چلنے والا وزرڈ شروع کریں:
/research-setupوزرڈ پوچھتا ہے کہ آپ کون سا فراہم کنندہ استعمال کرنا چاہتے ہیں، مطلوبہ سروس سے کنیکٹ ہوتا ہے، آپ کے نِش کے بارے میں سوال کرتا ہے، روزانہ کی تلاش کے سوالات تیار کرتا ہے اور آپ کے تین کیپشنز سے آپ کے تحریری انداز کو سیکھتا ہے۔ یہ اختیاری iPhone شیئر ورک فلو کے مراحل میں بھی رہنمائی کرتا ہے اور خودکار ٹیسٹ چلاتا ہے۔
repository آپ کی بنیادی ترتیبات config.json میں، نِش کی تلاشیں niche.json میں اور تحریری رہنمائی voice.md میں محفوظ کرتی ہے۔ اگر آپ نتائج کو دستی طور پر بہتر بنانا چاہتے ہیں تو سیٹ اپ کے بعد ان فائلوں کا جائزہ لیں۔
پہلے نمونہ ورک فلوز دریافت کریں

آپ کسی فراہم کنندہ سے کنیکٹ کیے بغیر پروجیکٹ کا جائزہ لے سکتے ہیں۔ شامل نمونے مصنوعی ڈیٹا استعمال کرتے ہیں اور حقیقی تخلیق کاروں کی نمائندگی نہیں کرتے۔
npm run library
npm run sample-report
npm run selftestnpm run libraryنمونہ ریل لائبریری کھولتا ہے۔npm run sample-reportنمونہ آؤٹ لائر رپورٹ کھولتا ہے۔npm run selftestآف لائن چیکس چلاتا ہے۔ کامیاب رن code 0 کے ساتھ ختم ہوتا ہے۔
انفرادی ریل کا تجزیہ کریں
سیٹ اپ مکمل ہونے کے بعد، عوامی ریل لنک کو ریل ریسرچ اسکل کے حوالے کریں:
/reel-research <reel link>ٹول دستیاب ماخذ ڈیٹا حاصل کرتا ہے، اسے معمول کے مطابق ترتیب دیتا ہے، ضرورت پڑنے پر ویڈیو کا ٹرانسکرپشن کرتا ہے اور بصری تجزیے کے لیے نکالے گئے فریم استعمال کرتا ہے۔ نتیجہ library/reels/ میں JSON فائل کے طور پر محفوظ ہوتا ہے اور براؤزر لائبریری میں شامل کر دیا جاتا ہے۔
ایک عام بریک ڈاؤن میں شامل ہوتا ہے:
- ویوز، لائکس، تبصرے، انگیجمنٹ ریٹ، دستیاب ہونے پر آؤٹ لائر اسکور، اور پوسٹ کرنے کی تاریخ
- ٹائم اسٹیمپ والا ٹرانسکرپٹ
- ابتدائی ہُک، ہُک کی قسم، الفاظ کی تعداد، ادائیگی کا دورانیہ، مؤثر الفاظ اور اس کے مؤثر ہونے کی وضاحت
- ریل کا زمرہ، بصری لے آؤٹ، رفتار اور فارمیٹ
- موضوع، مخصوص زاویہ، عام اعتقاد اور متضاد دعویٰ
- اسکرین پر موجود متن اور برقرار رکھنے کے مقصد کے ساتھ شاٹ بہ شاٹ بصری ٹائم لائن
- ٹائم اسٹیمپس کے ساتھ اسکرول روکنے والے دو سے پانچ ممکنہ لمحات
- آپ کی آواز میں لکھا ہوا نیا ہُک اور مکمل اسکرپٹ
ان باکس سے محفوظ شدہ ریلز پر کارروائی کریں
اگر آپ اختیاری iPhone ورک فلو استعمال کرتے ہیں تو کسی ریل پر Share دبائیں اور Save to Research منتخب کریں۔ یہ شارٹ کٹ لنک کو iCloud Drive کی ایک ان باکس فائل میں لکھتا ہے، جسے آپ کے Mac کے ساتھ ہم وقت ساز کیا جا سکتا ہے۔
محفوظ شدہ لنکس پر کارروائی کرنے کے لیے چلائیں:
/reel-research inboxٹول نئے لنکس پڑھتا ہے، آپ کے منتخب کردہ فراہم کنندہ کے ذریعے ان کا تجزیہ کرتا ہے اور نتائج کو لائبریری میں شامل کرتا ہے۔ iPhone کے بغیر آپ لنکس براہِ راست Claude Code میں پیسٹ کر سکتے ہیں یا config.json میں inboxPath کو کسی دوسری ایسی ٹیکسٹ فائل کی طرف اشارہ کر سکتے ہیں جو آپ کے کمپیوٹر کے ساتھ ہم وقت ساز ہوتی ہو۔
روزانہ آؤٹ لائر رپورٹ تیار کریں
آؤٹ لائر ورک فلو آپ کے ترتیب دیے گئے نِچ کو تلاش کرتا ہے، نتائج کو فلٹر کرتا ہے، ڈپلیکیٹس کو یکجا کرتا ہے، اور معیار پر پورا اترنے والی ریلز کی درجہ بندی کرتا ہے۔ ڈیفالٹ طور پر یہ گزشتہ 24 گھنٹوں کا جائزہ لیتا ہے اور 2,000 سے کم ویوز والی ریلز کو خارج کر دیتا ہے۔ اگر 15 سے کم ریلز معیار پر پوری اتریں تو مدت کو بڑھا کر 48 گھنٹے تک کیا جا سکتا ہے۔
/outliersرپورٹ reports/ کے تحت محفوظ ہوتی ہے اور HTML صفحے کے طور پر کھلتی ہے۔ Claude Code چیٹ میں بہترین 10 نتائج کی وضاحت بھی کرتا ہے اور آپ کے مواد کے لیے ایک آئیڈیا اینگل تجویز کرتا ہے۔

تلاش کی وسیع مدت کے لیے استعمال کریں:

/outliers --48hڈیفالٹ روزانہ کی تلاش niche.json میں موجود کوئریز استعمال کرتی ہے۔ ان کوئریز کو ایسے کلسٹرز میں منظم کریں جو اس بات کی عکاسی کریں کہ آپ کے نِچ کے تخلیق کار حقیقت میں ریلز کے کیپشن اور وضاحتیں کیسے لکھتے ہیں۔
پروسیسنگ پائپ لائن کو سمجھیں
پروجیکٹ ماخذ ڈیٹا سے تحقیقی نتائج تک ایک واضح ترتیب کی پیروی کرتا ہے:
- ریل کا لنک، ویڈیو فائل، یا ماخذ ایکسپورٹ ورک فلو میں شامل ہوتا ہے۔
- منتخب کردہ فراہم کنندہ نمبرز، کیپشنز، ویڈیوز، یا ٹرانسکرپٹس فراہم کرتا ہے۔
- ٹول فراہم کنندہ کا ٹرانسکرپٹ استعمال کرتا ہے، یا جب ٹرانسکرپشن
autoپر سیٹ ہو تو مقامی Whisper پر منتقل ہو جاتا ہے۔ frames.mjsبصری جائزے کے لیے کانٹیکٹ شیٹس بنانے کی خاطر ffmpeg استعمال کرتا ہے۔- Claude Code ہُک، فارمیٹ، اینگل، بصری عناصر، اور ریٹینشن کے لمحات کا تجزیہ کرتا ہے۔
- مکمل بریک ڈاؤن JSON کے طور پر محفوظ ہوتا ہے اور
out/library.htmlکے ذریعے دکھایا جاتا ہے۔ - آؤٹ لائر ورک فلو خام تلاش کا ڈیٹا محفوظ کرتا ہے، اسے فلٹر اور درجہ بند کرتا ہے، اور 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 دیکھیں۔ کسی بھی شیڈول کردہ کمانڈ کو فعال کرنے سے پہلے اس کا جائزہ لیں، خاص طور پر اگر آپ کا منتخب کردہ فراہم کنندہ ہر نتیجے یا تجزیے کے حساب سے فیس لیتا ہو۔
تحقیق کو نقل کیے بغیر استعمال کریں
یہ ٹول مواد دوبارہ پوسٹ کرنے کے بجائے آئیڈیاز کا مطالعہ کرنے کے لیے بنایا گیا ہے۔ ریل کے موضوع، اینگل، اور فارمیٹ کو تحقیق کے طور پر استعمال کریں، پھر اپنا تجربہ، نتائج، مصنوعات، یا نقطۂ نظر شامل کریں۔
تیار کردہ My version سیکشن آپ کی آواز میں نیا متن تیار کرنے کے لیے ہے۔ یہ تخلیق کار کی سطریں، لطیفے، یا کہانیاں دوبارہ استعمال نہیں کرتا، اور پروجیکٹ محفوظ کرنے سے پہلے نقل شدہ فقروں کی جانچ کرتا ہے۔ ڈاؤن لوڈ کی گئی ویڈیوز تجزیے کے لیے آپ کے کمپیوٹر پر رہتی ہیں اور انہیں دوبارہ اپ لوڈ نہیں کیا جانا چاہیے۔
نتیجہ
Instagram Research Tool، Claude Code کو ڈیٹا فراہم کنندہ کے ساتھ ملا کر ریل تحقیق کو قابل تکرار بناتا ہے۔ سیٹ اپ کے بعد آپ اپنے فون سے ریلز محفوظ کر سکتے ہیں، انفرادی طور پر ان کا تجزیہ کر سکتے ہیں، روزانہ کی آؤٹ لائر رپورٹ کا جائزہ لے سکتے ہیں، اور آزمودہ فارمیٹس اور اینگلز سے اصل اسکرپٹس تیار کر سکتے ہیں۔
نمونہ کمانڈز سے آغاز کریں، /research-setup چلائیں، پھر niche.json اور voice.md کو بہتر بنائیں تاکہ تحقیق آپ کے سامعین اور تحریری انداز سے مطابقت رکھے۔
