# Google Reviews

Fetch Google review ratings and review counts for businesses via DataForSEO API.

- Repository: https://github.com/OpenClaudia/openclaudia-skills (724 stars)
- Category: Business
- License: MIT
- Last updated: 2026-10-29
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add OpenClaudia/openclaudia-skills --skill google-reviews -g -a claude-code -y`
Codex: `npx skills add OpenClaudia/openclaudia-skills --skill google-reviews -g -a codex -y`
Cursor: `npx skills add OpenClaudia/openclaudia-skills --skill google-reviews -g -a cursor -y`
Gemini CLI: `npx skills add OpenClaudia/openclaudia-skills --skill google-reviews -g -a gemini-cli -y`

## Description

Fetch Google review ratings and review counts for businesses via DataForSEO API. Use when the user asks to check Google reviews, get review counts, compare business ratings, audit Google Maps presence, or analyze competitor reviews.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

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

Example:
```bash
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:

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

JSON file format:
```json
[
  {"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)

```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:

The rest: https://github.com/OpenClaudia/openclaudia-skills/blob/HEAD/skills/google-reviews/SKILL.md