تحلیل نظرات یوتیوب با هوش مصنوعی جمنای و گزارش تلگرام

تحلیل احساسات و کلمات کلیدی نظرات یوتیوب با Gemini AI و گزارش‌دهی تلگرام

این گردش کار، تحلیل نظرات یوتیوب را برای احساسات و استخراج کلمات کلیدی با استفاده از Gemini AI از طریق OpenRouter خودکار می‌کند. سپس گزارش‌های خلاصه‌شده را به یک کانال تلگرام ارسال می‌کند. این ابزار برای تحلیلگران محتوا، مدیران شبکه‌های اجتماعی و بازاریابانی که به دنبال نظارت بر بازخورد مخاطبان در ویدیوهای یوتیوب فهرست شده در یک Google Sheet هستند، ایده‌آل است.

گردش کار به بلوک‌های منطقی زیر تقسیم شده است:

1. تریگر زمان‌بندی شده و دریافت داده ورودی: گردش کار را به صورت دوره‌ای آغاز می‌کند و داده‌های ویدیوی یوتیوب (شناسه ویدیو و URL) را از یک Google Sheet بازیابی می‌کند.

2. بازیابی و مسطح‌سازی نظرات یوتیوب: نظرات سطح بالا را برای هر ویدیو با استفاده از YouTube Data API دریافت کرده و پاسخ را به موارد نظر فردی پردازش می‌کند.

3. تحلیل احساسات و کلمات کلیدی با هوش مصنوعی: متن و فراداده هر نظر را به Gemini AI LLM ارسال می‌کند تا احساسات، امتیاز، کلمات کلیدی و زبان را طبقه‌بندی کند. سپس خروجی LLM را تجزیه و نرمال‌سازی می‌کند.

4. ذخیره‌سازی و تجمیع داده‌ها: داده‌های تحلیل شده نظر را به Google Sheets اضافه کرده و تعداد احساسات و کلمات کلیدی را برای هر ویدیو تجمیع می‌کند.

5. گزارش‌دهی از طریق تلگرام: داده‌های تجمیع شده را به یک گزارش مختصر خلاصه کرده و آن را به یک چت تلگرام پیکربندی شده ارسال می‌کند.

این گردش کار شامل مدیریت خطا، پردازش دسته‌ای برای مقیاس‌پذیری و تجزیه دقیق خروجی JSON برای اطمینان از سازگاری داده‌ها است.

---

جزئیات گردش کار

۱. تریگر زمان‌بندی شده و دریافت داده ورودی

این بلوک گردش کار را در یک برنامه زمانی مشخص آغاز کرده و شناسه‌ها و URLهای ویدیوی یوتیوب را از یک Google Sheet برای پردازش متوالی می‌خواند.

نودها:

• Schedule Trigger (Schedule Trigger):

* نقش: گردش کار را در فواصل منظم آغاز می‌کند (پیش‌فرض روزانه است، اما قابل سفارشی‌سازی است).

* پیکربندی: فرکانس اجرای مورد نظر خود را تنظیم کنید.

* ورودی: ندارد.

* خروجی: نود Get row(s) in sheet را فعال می‌کند.

* ملاحظات: زمان‌بندی نادرست می‌تواند منجر به اتمام سهمیه API یا مشکلات محدودیت نرخ شود.

• Get row(s) in sheet (Google Sheets - Read):

* نقش: ردیف‌ها را از یک Google Sheet مشخص حاوی لیست ویدیوهای یوتیوب برای تحلیل می‌خواند.

* پیکربندی: برای تعیین دقیق شیت، به documentId و sheetName نیاز دارد.

* ورودی: توسط Schedule Trigger فعال می‌شود.

* خروجی: ردیف‌های حاوی video_id، video_url و احتمالاً فیلدهای کلید API را به نود بعدی منتقل می‌کند.

* ملاحظات: از مجوزهای دسترسی صحیح شیت اطمینان حاصل کنید و شیت حاوی شناسه‌های ویدیوی معتبر باشد.

• Set YouTube API Key (Set):

* نقش: کلید API یوتیوب را به هر مورد برای فراخوانی‌های API بعدی اضافه می‌کند.

* پیکربندی: "YOUR_YOUTUBE_API_KEY" را با کلید API یوتیوب واقعی خود جایگزین کنید. توصیه: برای امنیت بهتر به جای کدنویسی سخت، از اعتبارنامه‌های n8n یا متغیرهای محیطی استفاده کنید.

* ورودی: ردیف‌ها از نود Get row(s) in sheet.

* خروجی: هر مورد با کلید API یوتیوب غنی شده و به مرحله پردازش دسته‌ای منتقل می‌شود.

* ملاحظات: کلید API نامعتبر یا گمشده باعث شکست درخواست‌های YouTube API می‌شود.

---

۲. بازیابی و مسطح‌سازی نظرات یوتیوب

برای هر ویدیو، این بلوک تا ۱۰۰ نظر سطح بالا را با استفاده از YouTube Data API دریافت کرده و پاسخ را به موارد نظر فردی با فراداده مرتبط مسطح می‌کند.

نودها:

• Loop Over Items (SplitInBatches):

* نقش: ویدیوها را به صورت جداگانه یا دسته‌ای پردازش می‌کند تا محدودیت‌های نرخ API را به طور مؤثر مدیریت کند.

* پیکربندی: اندازه دسته را بر اساس مقیاس گردش کار و محدودیت‌های API در صورت نیاز تنظیم کنید.

* ورودی: موارد حاوی video_id و کلید API.

* خروجی: موارد را برای پردازش موازی یا متوالی به دسته‌هایی تقسیم می‌کند. یک شاخه به نود HTTP Request برای دریافت نظر منجر می‌شود.

* ملاحظات: پردازش تعداد زیادی ویدیو ممکن است باعث تأخیر شود. تنظیم اندازه دسته بسیار مهم است.

• HTTP Request (httpRequest):

* نقش: نقطه پایانی commentThreads از YouTube Data API را برای بازیابی نظرات سطح بالا برای یک ویدیوی خاص فراخوانی می‌کند.

* پیکربندی:

* URL به طور پویا با استفاده از video_id و کلید API از نودهای قبلی ساخته می‌شود.

* متد درخواست: GET.

* توجه: این پیکربندی به دلیل محدودیت‌های API حداکثر ۱۰۰ نظر در هر ویدیو را دریافت می‌کند.

* ورودی: داده‌های ویدیو از نود Loop Over Items.

* خروجی: پاسخ خام JSON حاوی نظرات از YouTube API.

* ملاحظات: مشکلات احتمالی شامل محدودیت‌های سهمیه API، شناسه‌های ویدیوی نامعتبر، کلیدهای API گمشده، خطاهای شبکه یا پاسخ‌های API نامعتبر است.

• Code (Flattening) (Code - JavaScript):

* نقش: پاسخ JSON YouTube API را تجزیه می‌کند تا نظرات فردی را استخراج کند. این یک لیست مسطح از موارد نظر ایجاد می‌کند که هر کدام حاوی فیلدهایی مانند comment_id، video_id، author، text، like_count، published_at، author_channel_id و author_channel_url است.

* ورودی: پاسخ JSON از نود HTTP Request.

* خروجی: لیستی از موارد نظر آماده برای تحلیل هوش مصنوعی.

* ملاحظات: ساختارهای پاسخ غیرمنتظره یا فیلدهای گمشده را با استفاده از ناوبری ایمن و مقادیر پیش‌فرض به طور مؤثر مدیریت می‌کند.

• No Operation, do nothing (NoOp):

* نقش: این یک نود جایگزین است که معمولاً برای کنترل جریان یا وضوح در انشعاب گردش کار استفاده می‌شود. هیچ تأثیر عملکردی ندارد.

* ورودی: یک مسیر جایگزین از نود Loop Over Items.

* خروجی: ندارد.

---

۳. تحلیل احساسات و کلمات کلیدی با هوش مصنوعی

این بلوک متن و فراداده هر نظر را به یک مدل Gemini AI (از طریق OpenRouter) برای تحلیل احساسات و استخراج کلمات کلیدی ارسال می‌کند. سپس خروجی هوش مصنوعی را تأیید و نرمال‌سازی می‌کند.

نودها:

• OpenRouter Chat Model (`@n8n/n8n-nodes-langchain.l

---

تحلیل احساسات و کلمات کلیدی نظرات یوتیوب با Gemini AI و گزارش‌دهی تلگرام

این گردش کار، تحلیل نظرات یوتیوب را برای احساسات و استخراج کلمات کلیدی با استفاده از Gemini AI از طریق OpenRouter خودکار می‌کند. سپس گزارش‌های خلاصه‌شده را به یک کانال تلگرام ارسال می‌کند. این ابزار برای تحلیلگران محتوا، مدیران شبکه‌های اجتماعی و بازاریابانی که به دنبال نظارت بر بازخورد مخاطبان در ویدیوهای یوتیوب فهرست شده در یک Google Sheet هستند، ایده‌آل است.

گردش کار به بلوک‌های منطقی زیر تقسیم شده است:

1. تریگر زمان‌بندی شده و دریافت داده ورودی: گردش کار را به صورت دوره‌ای آغاز می‌کند و داده‌های ویدیوی یوتیوب (شناسه ویدیو و URL) را از یک Google Sheet بازیابی می‌کند.

2. بازیابی و مسطح‌سازی نظرات یوتیوب: نظرات سطح بالا را برای هر ویدیو با استفاده از YouTube Data API دریافت کرده و پاسخ را به موارد نظر فردی پردازش می‌کند.

3. تحلیل احساسات و کلمات کلیدی با هوش مصنوعی: متن و فراداده هر نظر را به Gemini AI LLM ارسال می‌کند تا احساسات، امتیاز، کلمات کلیدی و زبان را طبقه‌بندی کند. سپس خروجی LLM را تجزیه و نرمال‌سازی می‌کند.

4. ذخیره‌سازی و تجمیع داده‌ها: داده‌های تحلیل شده نظر را به Google Sheets اضافه کرده و تعداد احساسات و کلمات کلیدی را برای هر ویدیو تجمیع می‌کند.

5. گزارش‌دهی از طریق تلگرام: داده‌های تجمیع شده را به یک گزارش مختصر خلاصه کرده و آن را به یک چت تلگرام پیکربندی شده ارسال می‌کند.

این گردش کار شامل مدیریت خطا، پردازش دسته‌ای برای مقیاس‌پذیری و تجزیه دقیق خروجی JSON برای اطمینان از سازگاری داده‌ها است.

---

جزئیات گردش کار

۱. تریگر زمان‌بندی شده و دریافت داده ورودی

این بلوک گردش کار را در یک برنامه زمانی مشخص آغاز کرده و شناسه‌ها و URLهای ویدیوی یوتیوب را از یک Google Sheet برای پردازش متوالی می‌خواند.

نودها:

• Schedule Trigger (Schedule Trigger):

* نقش: گردش کار را در فواصل منظم آغاز می‌کند (پیش‌فرض روزانه است، اما قابل سفارشی‌سازی است).

* پیکربندی: فرکانس اجرای مورد نظر خود را تنظیم کنید.

* ورودی: ندارد.

* خروجی: نود Get row(s) in sheet را فعال می‌کند.

* ملاحظات: زمان‌بندی نادرست می‌تواند منجر به اتمام سهمیه API یا مشکلات محدودیت نرخ شود.

• Get row(s) in sheet (Google Sheets - Read):

* نقش: ردیف‌ها را از یک Google Sheet مشخص حاوی لیست ویدیوهای یوتیوب برای تحلیل می‌خواند.

* پیکربندی: برای تعیین دقیق شیت، به documentId و sheetName نیاز دارد.

* ورودی: توسط Schedule Trigger فعال می‌شود.

* خروجی: ردیف‌های حاوی video_id، video_url و احتمالاً فیلدهای کلید API را به نود بعدی منتقل می‌کند.

* ملاحظات: از مجوزهای دسترسی صحیح شیت اطمینان حاصل کنید و شیت حاوی شناسه‌های ویدیوی معتبر باشد.

• Set YouTube API Key (Set):

* نقش: کلید API یوتیوب را به هر مورد برای فراخوانی‌های API بعدی اضافه می‌کند.

* پیکربندی: "YOUR_YOUTUBE_API_KEY" را با کلید API یوتیوب واقعی خود جایگزین کنید. توصیه: برای امنیت بهتر به جای کدنویسی سخت، از اعتبارنامه‌های n8n یا متغیرهای محیطی استفاده کنید.

* ورودی: ردیف‌ها از نود Get row(s) in sheet.

* خروجی: هر مورد با کلید API یوتیوب غنی شده و به مرحله پردازش دسته‌ای منتقل می‌شود.

* ملاحظات: کلید API نامعتبر یا گمشده باعث شکست درخواست‌های YouTube API می‌شود.

---

۲. بازیابی و مسطح‌سازی نظرات یوتیوب

برای هر ویدیو، این بلوک تا ۱۰۰ نظر سطح بالا را با استفاده از YouTube Data API دریافت کرده و پاسخ را به موارد نظر فردی با فراداده مرتبط مسطح می‌کند.

نودها:

• Loop Over Items (SplitInBatches):

* نقش: ویدیوها را به صورت جداگانه یا دسته‌ای پردازش می‌کند تا محدودیت‌های نرخ API را به طور مؤثر مدیریت کند.

* پیکربندی: اندازه دسته را بر اساس مقیاس گردش کار و محدودیت‌های API در صورت نیاز تنظیم کنید.

* ورودی: موارد حاوی video_id و کلید API.

* خروجی: موارد را برای پردازش موازی یا متوالی به دسته‌هایی تقسیم می‌کند. یک شاخه به نود HTTP Request برای دریافت نظر منجر می‌شود.

* ملاحظات: پردازش تعداد زیادی ویدیو ممکن است باعث تأخیر شود. تنظیم اندازه دسته بسیار مهم است.

• HTTP Request (httpRequest):

* نقش: نقطه پایانی commentThreads از YouTube Data API را برای بازیابی نظرات سطح بالا برای یک ویدیوی خاص فراخوانی می‌کند.

* پیکربندی:

* URL به طور پویا با استفاده از video_id و کلید API از نودهای قبلی ساخته می‌شود.

* متد درخواست: GET.

* توجه: این پیکربندی به دلیل محدودیت‌های API حداکثر ۱۰۰ نظر در هر ویدیو را دریافت می‌کند.

* ورودی: داده‌های ویدیو از نود Loop Over Items.

* خروجی: پاسخ خام JSON حاوی نظرات از YouTube API.

* ملاحظات: مشکلات احتمالی شامل محدودیت‌های سهمیه API، شناسه‌های ویدیوی نامعتبر، کلیدهای API گمشده، خطاهای شبکه یا پاسخ‌های API نامعتبر است.

• Code (Flattening) (Code - JavaScript):

* نقش: پاسخ JSON YouTube API را تجزیه می‌کند تا نظرات فردی را استخراج کند. این یک لیست مسطح از موارد نظر ایجاد می‌کند که هر کدام حاوی فیلدهایی مانند comment_id، video_id، author، text، like_count، published_at، author_channel_id و author_channel_url است.

* ورودی: پاسخ JSON از نود HTTP Request.

* خروجی: لیستی از موارد نظر آماده برای تحلیل هوش مصنوعی.

* ملاحظات: ساختارهای پاسخ غیرمنتظره یا فیلدهای گمشده را با استفاده از ناوبری ایمن و مقادیر پیش‌فرض به طور مؤثر مدیریت می‌کند.

• No Operation, do nothing (NoOp):

* نقش: این یک نود جایگزین است که معمولاً برای کنترل جریان یا وضوح در انشعاب گردش کار استفاده می‌شود. هیچ تأثیر عملکردی ندارد.

* ورودی: یک مسیر جایگزین از نود Loop Over Items.

* خروجی: ندارد.

---

۳. تحلیل احساسات و کلمات کلیدی با هوش مصنوعی

این بلوک متن و فراداده هر نظر را به یک مدل Gemini AI (از طریق OpenRouter) برای تحلیل احساسات و استخراج کلمات کلیدی ارسال می‌کند. سپس خروجی هوش مصنوعی را تأیید و نرمال‌سازی می‌کند.

نودها:

• OpenRouter Chat Model (`@n8n/n8n-nodes-langchain.l