Google Business Optimizer

Automate your Google Business Profile and save 5-10 hours every week.

---

The Problem

Small business owners waste 5-10 hours per week manually managing their Google Business Profile:

• Responding to reviews - Checking daily, crafting responses, monitoring ratings
• Updating business info - Holiday hours, special events, temporary closures
• Tracking competitors - Manual research to see how you stack up
• Monitoring rankings - Checking where you appear in local search results

That's 20-40 hours per month spent on tasks that could be automated.

---

The Solution

Google Business Optimizer automates your entire Google Business Profile workflow:

✨ What It Does

Feature	What You Get
Review Automation	Auto-respond to reviews, get alerts for new reviews, track sentiment trends
Smart Updates	Bulk update hours, post updates, sync across multiple locations
Competitor Intel	Track competitor ratings, reviews, and ranking changes
Rank Tracking	Monitor your position for key local search terms

---

Commands

reviews

Manage and respond to customer reviews automatically.

# Check for new reviews
google-business-optimizer reviews --check

# Auto-respond to all new reviews
google-business-optimizer reviews --respond --template=professional

# Get review analytics
google-business-optimizer reviews --stats --last-30-days

# List reviews needing response
google-business-optimizer reviews --pending

Templates: professional, friendly, short, detailed

---

update-hours

Update business hours and special hours in bulk.

# Set regular hours
google-business-optimizer update-hours --location="Main St" \
  --monday="9:00-17:00" --tuesday="9:00-17:00" ...

# Set holiday hours
google-business-optimizer update-hours --holiday --date="2024-12-25" --closed

# Set special hours for event
google-business-optimizer update-hours --special --date="2024-07-04" --hours="10:00-14:00"

# Apply to all locations
google-business-optimizer update-hours --all-locations --holiday --date="2024-01-01" --closed

---

competitors

Monitor your competitors' Google Business Profiles.

# Add competitors to track
google-business-optimizer competitors --add "Competitor Business Name"

# Run competitor analysis
google-business-optimizer competitors --analyze

# Get weekly report
google-business-optimizer competitors --report --format=email

# Compare ratings
google-business-optimizer competitors --compare --metric=rating

---

rank-track

Track your ranking for local search keywords.

# Add keywords to track
google-business-optimizer rank-track --add "coffee shop near me"
google-business-optimizer rank-track --add "best pizza downtown"

# Check current rankings
google-business-optimizer rank-track --check

# View ranking history
google-business-optimizer rank-track --history --days=30

# Get ranking report
google-business-optimizer rank-track --report --keyword="coffee shop near me"

---

Setup

1. Get Your Google API Credentials

1. Go to Google Cloud Console
2. Create a new project or select existing
3. Enable Google Business Profile API
4. Create OAuth 2.0 credentials
5. Download your credentials.json

2. Configure the Skill

google-business-optimizer config --credentials=/path/to/credentials.json
google-business-optimizer config --location-id="YOUR_LOCATION_ID"

3. Authorize

google-business-optimizer auth --login

---

Pricing

Plan	Price	Features
FREE	$0	1 location, 50 reviews/month, basic responses
PRO	$19/mo	5 locations, unlimited reviews, AI responses, competitor tracking (5)
AGENCY	$49/mo	Unlimited locations, unlimited reviews, white-label reports, API access, priority support

---

Automation (HEARTBEAT)

This skill integrates with OpenClaw's heartbeat system for hands-off automation:

• Daily: Check for new reviews and auto-respond
• Weekly: Competitor analysis report
• Monthly: Ranking report with trend analysis

See HEARTBEAT.md for configuration.

---

Environment Variables

Variable	Description	Required
GBP_API_KEY	Google Business Profile API key	Yes
GBP_LOCATION_ID	Your business location ID	Yes
GBP_ACCOUNT_ID	Your Google account ID	Yes
OPENAI_API_KEY	For AI-generated responses (PRO+)	No
SLACK_WEBHOOK	For notifications	No
EMAIL_TO	For report delivery	No

---

Examples

Auto-Respond to All New Reviews

google-business-optimizer reviews --respond-all --template=friendly

Set Holiday Hours for All Locations

google-business-optimizer update-hours --all-locations \
  --holiday --date="2024-12-25" --date="2024-12-26" --date="2025-01-01" --closed

Weekly Competitor Report

google-business-optimizer competitors --report --format=pdf --email=owner@business.com

Track 10 Local Keywords

for keyword in "coffee shop" "cafe near me" "best espresso" "latte art" "pastry shop"; do
  google-business-optimizer rank-track --add "$keyword"
done

---

Support

• 📧 Email: support@google-business-optimizer.local
• 📖 Docs: https://docs.google-business-optimizer.local
• 💬 Discord: https://discord.gg/gbp-optimizer

---

Changelog

v1.0.0

• Initial release
• Review automation with templates
• Business hours management
• Competitor tracking
• Rank tracking
• HEARTBEAT automation support