How mohdtalal3/google-review-automation works
Google Review Automation combines a password-protected Flask dashboard with a separate polling worker. Users configure businesses and account pools, then queue review jobs with ratings, formats, and languages. The worker loads each business’s pending jobs and configuration, and the bot generates review text with Gemini before automating the Maps posting flow; results and failures are tracked in SQLite. The repository also documents a Donut Browser/Playwright bot variant, but the sampled worker uses the SeleniumBase bot. Relationships involving unsampled route and bot code are limited to documented or indexed evidence.
Main entry points: app.py Web dashboard · bot.py SeleniumBase bot · bot_donut.py Donut bot variant · db.py SQLite state
Components 16
Dashboard
- Web dashboard
app.py - Login view
templates/login.html - Dashboard view
templates/dashboard.html - Business view
templates/business.html
Job Processing
- Job worker
worker.py - Review job queue
db.py
Review Automation
- SeleniumBase bot
bot.py - Review generation
bot.py - Donut bot variant
bot_donut.py
Persistent State
- SQLite state
db.py
Other components
- Dashboard user
- Gemini API
- Chrome browser
- Google Maps
- Donut Browser API
- Playwright CDP
Connections 18
- Dashboard user → Web dashboard: manages
README.md - Web dashboard → Login view: renders
app.py - Web dashboard → Dashboard view: renders
app.py - Web dashboard → Business view: renders
app.py - Web dashboard → SQLite state: reads and writes
app.py - Web dashboard → Review job queue: queues
app.py - Review job queue → SQLite state: persists jobs
db.py - Job worker → SQLite state: polls and updates
worker.py - Job worker → SeleniumBase bot: dispatches jobs
worker.py - SeleniumBase bot → SQLite state: reads jobs; records results
bot.py - SeleniumBase bot → Review generation: generates text
bot.py - Review generation → Gemini API: requests text
bot.py - SeleniumBase bot → Chrome browser: automates
bot.py - Chrome browser → Google Maps: posts review
- Donut bot variant → Donut Browser API: manages profiles
bot_donut.py - Donut bot variant → Playwright CDP: connects via CDP
bot_donut.py - Donut bot variant → Google Maps: automates posting
bot_donut.py - Job worker → Donut bot variant: alternative implementation
bot_donut.py