google-reviews

Google Reviews

Fetch Google Maps ratings, review counts, and rating distributions for any business using the DataForSEO API.

When to Use This Skill

Use this skill when the user:

• Asks to check Google reviews for a business
• Wants to compare ratings across multiple businesses
• Needs Google review counts for a report or analysis
• Asks about a business's Google Maps presence
• Wants to audit competitor reviews

Tool Location

Global tools directory: ~/.agents/tools/

• Script: ~/.agents/tools/fetch-google-reviews.js
• Credentials (preferred): AISA_ONE_API_KEY in environment variables — proxies through aisa.one
• Credentials (fallback): DATAFORSEO_LOGIN and DATAFORSEO_PASSWORD in environment variables — direct to DataForSEO. The script auto-detects which one is set.

Usage

Single Business

cd ~/.agents/tools && node fetch-google-reviews.js "Business Name" "City,Province,Country"

Example:

cd ~/.agents/tools && node fetch-google-reviews.js "Trust Auto Sales" "Richmond,British Columbia,Canada"

Batch Mode

Create a JSON file with an array of businesses, then run:

cd ~/.agents/tools && node fetch-google-reviews.js --batch /path/to/businesses.json

JSON file format:

[
  {"keyword": "Business One", "location": "Vancouver,British Columbia,Canada"},
  {"keyword": "Business Two"}
]

• keyword (required): Business name to search
• location (optional): Defaults to "Richmond,British Columbia,Canada"

Output

Single Business (JSON)

{
  "keyword": "Trust Auto Sales",
  "title": "Trust Auto Sales",
  "rating": 4.2,
  "reviews": 677,
  "rating_distribution": {"1": 117, "2": 7, "3": 3, "4": 19, "5": 531},
  "address": "3691 Number 3 Rd, Richmond, BC V6X 2B8",
  "category": "Car dealer",
  "url": "https://trustauto.ca/"
}

Batch Mode

Prints a markdown table followed by full JSON:

| Business | Rating | Reviews | Address |
|----------|--------|---------|---------|
| Trust Auto Sales | 4.2 | 677 | 3691 Number 3 Rd, Richmond, BC V6X 2B8 |

Location Format

Use the DataForSEO location format: City,Province/State,Country

Examples:

• Richmond,British Columbia,Canada
• Vancouver,British Columbia,Canada
• Toronto,Ontario,Canada
• New York,New York,United States

API Details

• Uses DataForSEO business_data/google/my_business_info/live endpoint
• Routes through aisa.one proxy (api.aisa.one/apis/v1/dataforseo/..., Bearer auth) when AISA_ONE_API_KEY is set; falls back to direct api.dataforseo.com/v3/... (Basic auth) otherwise
• Synchronous (returns results immediately)
• Returns first matching business for the keyword + location
• Batch mode adds 200ms delay between requests to avoid rate limits

Important Notes

• If npm install hasn't been run yet: cd ~/.agents/tools && npm install
• The script loads credentials from both local .env and environment variables
• DataForSEO charges per API call -- be mindful with large batches