تحلیل خودکار نظرات گوگل با SerpAPI و GPT-4

تحلیل و خلاصه‌سازی نظرات گوگل با SerpAPI، GPT-4 و Google Sheets

این گردش کار فرآیند استخراج، تحلیل و خلاصه‌سازی نظرات Google Maps را برای لیستی از کسب‌وکارها با استفاده از SerpAPI، GPT-4 و Google Sheets خودکار می‌کند. این گردش کار برای تحقیقات بازار، تحلیل رقابتی یا جمع‌آوری بازخورد مشتری در مقیاس ایده‌آل است.

ویژگی‌های کلیدی:

• دریافت خودکار داده: نظرات کسب‌وکار را مستقیماً از Google Maps از طریق SerpAPI بازیابی می‌کند.
• تحلیل مبتنی بر هوش مصنوعی: از GPT-4 برای تحلیل احساسات و استخراج کلمات کلیدی از نظرات استفاده می‌کند.
• یکپارچه‌سازی یکپارچه: برای ورودی (لیست کسب‌وکار) و خروجی (نظرات تحلیل‌شده) با Google Sheets ادغام می‌شود.
• پاک‌سازی و فیلتر کردن داده: داده‌های خام را پردازش می‌کند، اطلاعات مرتبط را استخراج می‌کند و متن نظراتی که در دسترس نیست را مدیریت می‌کند.
• خروجی واضح: نظرات با موفقیت تحلیل‌شده را از مواردی که به دلیل عدم وجود متن نادیده گرفته شده‌اند، جدا می‌کند.

---

تشریح گردش کار

این گردش کار به بلوک‌های منطقی تقسیم شده است که هر کدام وظیفه خاصی را انجام می‌دهند:

۱. ورودی و راه‌اندازی

• Manual Trigger: اجرای گردش کار را آغاز می‌کند.
• Sticky Notes: راهنمایی جامع، دستورالعمل‌ها و کمک‌های بصری برای درک و استفاده از گردش کار ارائه می‌دهد.
• Pull Sample Restaurants (Google Sheets): لیستی از نام مشاغل را از یک Google Sheet مشخص می‌خواند.

۲. کسب و پردازش داده

• Get Data (HTTP Request): نقطه پایانی Google Maps در SerpAPI را برای دریافت نظرات هر کسب و کار پرس و جو می‌کند.
• Cleans It Up (Code): پاسخ SerpAPI را تجزیه و تحلیل می‌کند، جزئیات کلیدی نظر (متن، رتبه، تاریخ) را استخراج کرده و آنها را برای پردازش بیشتر آماده می‌کند.
• If review text is NOT empty (If): نظراتی را که فاقد محتوای متنی هستند فیلتر کرده و آنها را به یک فرآیند ثبت جداگانه هدایت می‌کند.

۳. تحلیل هوش مصنوعی

• Analyze Review Sentiment (LangChain OpenAI): نظرات متنی را برای تحلیل احساسات (مثبت، خنثی، منفی) و استخراج کلمات کلیدی به GPT-4 ارسال می‌کند. خروجی به صورت JSON ساختار یافته است.

۴. خروجی داده

• Export Data (Google Sheets): نظرات با موفقیت تحلیل شده، از جمله احساسات و کلمات کلیدی تولید شده توسط هوش مصنوعی را به یک تب مشخص در Google Sheet اضافه می‌کند.
• Failed Reviews (Google Sheets): نظراتی را که به دلیل متن از دست رفته نادیده گرفته شده‌اند، در یک تب جداگانه در Google Sheet ثبت می‌کند و دلیل نادیده گرفتن را نشان می‌دهد.

---

جزئیات گره به گره

۱. ورودی و راه‌اندازی

#### Manual Trigger

• نوع: n8n-nodes-base.manualTrigger
• نقش: شروع دستی گردش کار.
• خروجی: گره "Pull Sample Restaurants" را فعال می‌کند.

#### Sticky Notes

• نوع: n8n-nodes-base.stickyNote
• نقش: ارائه مستندات درون‌خطی، دستورالعمل‌ها و زمینه.

* Sticky Note1: نمای کلی گردش کار، دستورالعمل‌های استفاده و الزامات.

* Sticky Note: توضیح مرحله خراشیدن نقشه‌های گوگل.

* Sticky Note2: جزئیات مربوط به پاکسازی داده‌ها، فیلتر کردن و مدیریت نظرات خالی.

* Sticky Note3: توضیح فرآیند تجزیه و تحلیل و خروجی هوش مصنوعی.

* Sticky Note4: تصویر فرمت ورودی Google Sheets.

* Sticky Note5: تصویر فرمت خروجی Google Sheets.

#### Pull Sample Restaurants

• نوع: n8n-nodes-base.googleSheets
• نقش: خواندن لیستی از نام مشاغل از یک Google Sheet.
• پیکربندی:

* از یک سند Google Sheet خاص (شناسه: 1mJRBu96urKkUAUMz1chcipgKlqw6UhKcSLzF0xp_D6w) می‌خواند.

* یک شیت خاص (GID: 0) را هدف قرار می‌دهد.

* به اعتبارنامه‌های Google OAuth2 نیاز دارد.

• ورودی: توسط ماشه دستی فعال می‌شود.
• خروجی: لیست نام مشاغل را به گره "Get Data" ارسال می‌کند.

۲. کسب و پردازش داده

#### Get Data

• نوع: n8n-nodes-base.httpRequest
• نقش: واکشی داده‌های نقشه‌های گوگل، از جمله نظرات، با استفاده از SerpAPI.
• پیکربندی:

* متد: GET

* URL: نقطه پایانی جستجوی نقشه‌های گوگل SerpAPI.

* پارامترهای کوئری:

* engine: google_maps

* type: search

* q: به طور پویا بر اساس نام کسب و کار ورودی تنظیم می‌شود.

* api_key: از طریق اعتبارنامه‌ها یا پارامتر ارائه می‌شود (نیاز به کلید معتبر SerpAPI دارد).

• ورودی: نام کسب و کار از "Pull Sample Restaurants".
• خروجی: پاسخ خام JSON از SerpAPI حاوی place_results و نظرات.
• موارد لبه: محدودیت‌های نرخ API، کلید API نامعتبر، عدم یافتن نتایج، قطع شدن شبکه.

#### Cleans It Up

• نوع: n8n-nodes-base.code
• نقش: تجزیه پاسخ خام SerpAPI، استخراج فیلدهای مرتبط نظر و فیلتر کردن نظرات فاقد متن.
• پیکربندی: کد سفارشی جاوا اسکریپت برای:

* دسترسی ایمن به place_results و نظرات.

* استخراج حداکثر ۱۰ نظر مرتبط برای هر کسب و کار.

* استخراج فیلدها: نام کسب و کار، متن نظر، امتیاز ستاره و تاریخ ارسال.

* ایجاد اشیاء JSON ساده شده برای هر نظر.

• ورودی: پاسخ خام JSON از "Get Data".
• خروجی: آرایه‌ای از اشیاء نظر پاکسازی شده.
• موارد لبه: place_results گمشده، عدم وجود نظر، فیلدهای نظر فردی گمشده.

#### If review text is NOT empty

• نوع: n8n-nodes-base.if
• نقش: فیلتر کردن نظرات بر اساس وجود متن نظر.
• پیکربندی: بررسی می‌کند که آیا فیلد reviewText یک رشته خالی نیست.
• ورودی: اشیاء نظر پاکسازی شده از "Cleans It Up".
• خروجی:

* شاخه True: نظرات دارای متن به "Analyze Review Sentiment" می‌روند.

* شاخه False: نظرات بدون متن به "Failed Reviews" می‌روند.

۳. تحلیل هوش مصنوعی

#### Analyze Review Sentiment

• نوع: @n8n/n8n-nodes-langchain.openAi
• نقش: استفاده از GPT-4 برای تحلیل احساسات نظر و استخراج کلمات کلیدی.
• پیکربندی:

* مدل: gpt-4-turbo

* Prompt: قالبی که به هوش مصنوعی دستور می‌دهد احساسات را تجزیه و تحلیل کرده و ۳-۵ کلمه کلیدی/موضوع را از متن نظر استخراج کند و به نام کسب و کار اشاره کند. خروجی باید JSON با کلیدهای sentiment، keywords و restaurant (توجه داشته باشید املای صحیح) باشد.

* اعتبارنامه‌ها: به اعتبارنامه‌های OpenAI API نیاز دارد.

• ورودی: نظرات با متن غیر خالی از گره "If" (شاخه true).
• خروجی: نتایج تجزیه و تحلیل هوش مصنوعی (احساسات و کلمات کلیدی) برای هر نظر.
• موارد لبه: محدودیت‌های نرخ API، ورودی بدشکل، خرابی API، خطاهای تجزیه JSON.

۴. خروجی داده

#### Export Data

• نوع: n8n-nodes-base.googleSheets
• نقش: افزودن نظرات با موفقیت تحلیل شده به یک Google Sheet.
• پیکربندی:

* سند: همان سند Google Sheet ورودی.

* شیت: تب با شناسه 1346480145 (نام "table").

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

* اعتبارنامه‌ها: Google Sheets OAuth2.

• ورودی: نظرات تجزیه و تحلیل شده توسط هوش مصنوعی از "Analyze Review Sentiment".
• خروجی: داده‌ها را به تب مشخص شده Google Sheet اضافه می‌کند.

#### Failed Reviews (e.g. review text = empty)

• نوع: n8n-nodes-base.googleSheets
• نقش: ثبت نظراتی که به دلیل خالی بودن متن نظر رد شده‌اند.
• پیکربندی:

* سند: همان سند Google Sheet.

* شیت: تب با شناسه 1253412439 (نام "skipped reviews").

* ستون‌ها: شامل امتیاز ستاره، نام کسب و کار، متن نظر و علامت‌گذاری کلمات کلیدی/احساسات به عنوان "Skipped (no reviewText)".

* اعتبارنامه‌ها: Google Sheets OAuth2.

• ورودی: نظرات فیلتر شده توسط گره "If" (شاخه false).
• خروجی: داده‌ها را به تب Google Sheet "skipped reviews" اضافه می‌کند.

---

جدول خلاصه