Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

NDDimension/reviewradar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

3 Commits

Repository files navigation

πŸ“‘ ReviewRadar β€” AI-Powered Google Review Intelligence Platform

Automatically monitor, analyze, and act on Google reviews for any business β€” powered by AI, delivered as a live dashboard.

A production-grade reputation intelligence system built on n8n + Gemini AI + Google Sheets + Looker Studio. Monitors multiple businesses simultaneously, scores every review with AI, fires multi-channel alerts for critical feedback, and delivers weekly executive reports β€” all running autonomously, 24/7.


n8n Gemini Looker Studio Google Sheets Slack WhatsApp Twilio


🎬 Live Demo

Watch Demo

Live Dashboard


🧩 The Problem It Solves

Local businesses β€” restaurants, clinics, hotels, salons β€” receive Google reviews constantly. Most owners:

  • Discover 1-star reviews days later, by accident
  • Have no visibility into patterns: is "slow service" a recurring complaint every weekend?
  • Pay 100ドル–500ドル/month for SaaS tools like ReviewTrackers or Yext to do this
  • Have zero actionable intelligence β€” just a raw list of reviews

ReviewRadar replaces all of that with a custom-built, AI-powered system the business owns outright β€” for a one-time setup cost.


βš™οΈ System Architecture

[Google Maps]
 ↓
[SERPAPI β€” Review Fetcher]
 ↓
[n8n β€” Automation Engine]
 ↓
[Gemini AI β€” Review Analysis]
 ↙ ↓ β†˜
[Gmail] [Slack] [WhatsApp] ← Instant alerts for urgent reviews
 ↓
[Google Sheets β€” Data Warehouse]
 ↙ β†˜
[All Reviews] [Testimonials] [Weekly Summary]
 ↓
[Looker Studio β€” Live Dashboard]
 ↓
[Weekly AI Report β€” Email per business]

πŸ”„ Workflows

Workflow 1 β€” Review Watcher (Runs on schedule, fully autonomous)

  1. Reads all monitored businesses from the Businesses sheet (Name + SERP Data ID + Owner Email)
  2. Fetches latest Google Maps reviews for each business via SERPAPI
  3. Deduplicates against existing records using Review ID matching β€” skips already-processed reviews
  4. For each new review, Gemini AI produces structured analysis:
    • sentiment: positive / negative
    • category: Food / Service / Staff / Cleanliness / Other
    • urgency: 1–5 numeric score
    • draft_response: AI-written professional owner reply
  5. Routes based on urgency:
    • πŸ”΄ Urgency 4–5 / Rating 1–2: Fires 3 simultaneous alerts β€” Gmail + Slack + WhatsApp (Twilio)
    • 🟒 Positive / Rating 4–5: Appends to Testimonials sheet
  6. All reviews logged to All Reviews sheet with full structured data

Workflow 2 β€” Weekly Intelligence Report (Every Monday, 8:00 AM)

  1. Reads all reviews from the All Reviews sheet
  2. Groups and aggregates reviews by business using a JavaScript Code node
  3. Gemini AI analyzes each business group and produces:
    • Average rating
    • Top 3 recurring complaint themes
    • Top 3 praise themes
    • One specific, actionable recommendation
  4. Business-wise separator splits output β€” each business owner gets their own individual report email
  5. Results saved to Weekly Summary sheet for trend tracking over time

Dashboard β€” 3-Page Looker Studio (Live, auto-updating)

Page 1 β€” Executive Dashboard

  • KPI cards: Total Reviews, Average Rating, Businesses Monitored, Urgent Reviews
  • Reviews by Business (bar chart)
  • Average Rating by Business (comparative bar)
  • Review Volume Over Time (time-series)
  • Business filter to isolate individual locations

Page 2 β€” Customer Insights

  • Sentiment Distribution (pie: positive vs negative)
  • Top Review Categories (bar: Food, Service, Staff, Cleanliness, Other)
  • Recent Reviews table with full data

Page 3 β€” AI Executive Reports

  • Per-business: Top Complaints, Top Praise, AI-generated Recommendations
  • Designed for owners and decision-makers

πŸ› οΈ Tech Stack

Tool Role
n8n Automation engine (2 workflows)
SERPAPI Google Maps review fetching
Google Gemini AI Review analysis, categorization, report generation
Google Sheets Data warehouse (4 tabs)
Gmail Owner alerts + weekly report delivery
Slack Urgent review channel notifications
Twilio WhatsApp critical review alerts
Looker Studio Live business intelligence dashboard

πŸ“Š Live Results

Built and tested on real businesses:

Business Reviews Avg Rating Urgent Alerts
Cozy Restaurant 8 3.88 βœ… Triggered
McDonald's (Mehsana) 8 3.88 βœ… Triggered

Sentiment split: 75% positive, 25% negative across 16 reviews


πŸ“ Repository Structure

reviewradar/
β”‚
β”œβ”€β”€ workflows/
β”‚ β”œβ”€β”€ ReviewRadar_Watcher.json ← Main review fetching + alerting workflow
β”‚ └── ReviewRadar_Weekly_Report.json ← Monday report generation workflow
β”‚
β”œβ”€β”€ assets/
β”‚ β”œβ”€β”€ looker-studio.pdf ← PDF of Looker Studio Dashboard
β”‚ └── workflow-canvas.png ← n8n workflow screenshot
β”‚
β”œβ”€β”€ README.md
└── setup-guide.md

πŸš€ Quick Setup

See setup-guide.md for full configuration instructions.

You will need:

  • n8n account (cloud or self-hosted)
  • SERPAPI account + API key (100 free searches/month)
  • Google Gemini API key (free at aistudio.google.com)
  • Google account (Sheets + Gmail + Calendar)
  • Slack workspace (for alert channel)
  • Twilio account (for WhatsApp alerts β€” free trial available)
  • Looker Studio account (free with Google account)

πŸ’‘ Customization Options

  • Add more businesses β€” just add rows to the Businesses sheet
  • Swap WhatsApp for Telegram notifications
  • Add a Notion database as secondary data store
  • Connect to HubSpot CRM to log review data against contacts
  • Add a "Response Sent" tracker column for closed-loop management
  • Extend AI categories for specific industries (e.g., "Wait Time" for restaurants, "Bedside Manner" for clinics)

πŸ“¬ Hire Me

I build custom review monitoring and reputation intelligence systems for agencies and multi-location businesses.


πŸ“„ License

This project is released under a proprietary license.

The repository is provided for portfolio and evaluation purposes only. Commercial use, redistribution, resale, and client deployment are prohibited without explicit written permission from the author.


Built by Dhanraj Sharma β€” AI Automation Specialist Ex-ISRO Research Intern | B.Tech AI/ML, Gujarat

About

AI-powered Google review monitoring platform with real-time Gmail, Slack & WhatsApp alerts, weekly AI intelligence reports, and a live Looker Studio dashboard. Built with n8n, Gemini AI, SERPAPI, and Google Sheets.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

Contributors

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /