# Google Reviews

> Obtiene calificaciones y número de reseñas de Google para negocios usando la API de DataForSEO.

Fuente: https://skillsagentes.com/skills/openclaudia/openclaudia-skills/google-reviews
Markdown: https://skillsagentes.com/skills/openclaudia/openclaudia-skills/google-reviews.md

Repositorio: https://github.com/OpenClaudia/openclaudia-skills
Autor: OpenClaudia
Licencia: MIT
Actualizado: el mes pasado
Coste de contexto: 58 tok instalada, 821 tok al activarse, 821 tok con todos los archivos del bundle
Bundle: 1 archivo, 3 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add OpenClaudia/openclaudia-skills --skill google-reviews --agent claude-code
# Cursor
npx -y skills add OpenClaudia/openclaudia-skills --skill google-reviews --agent cursor
# Codex
npx -y skills add OpenClaudia/openclaudia-skills --skill google-reviews --agent codex
# Gemini CLI
npx -y skills add OpenClaudia/openclaudia-skills --skill google-reviews --agent gemini
# Windsurf
npx -y skills add OpenClaudia/openclaudia-skills --skill google-reviews --agent windsurf
# Cline
npx -y skills add OpenClaudia/openclaudia-skills --skill google-reviews --agent cline
```

## Qué hace

- Consulta las calificaciones, número de reseñas y distribución de estrellas de un negocio en Google Maps vía la API de DataForSEO
- Permite comparar varios negocios a la vez en modo batch usando un archivo JSON
- Genera una tabla en markdown con los resultados junto con el JSON completo

## Cuándo usarla

- El usuario pide revisar las reseñas de Google de un negocio
- Quiere comparar calificaciones entre varios negocios
- Necesita el conteo de reseñas de Google para un reporte o análisis
- Quiere auditar la presencia en Google Maps de competidores

## Qué la activa

- "Revisa las reseñas de Google de Trust Auto Sales en Richmond"
- "Compara las calificaciones de Google de estos 5 negocios"
- "Dame el número de reseñas y rating de este negocio en Google Maps"

## Antes de instalar

- Requiere `AISA_ONE_API_KEY` o las credenciales `DATAFORSEO_LOGIN`/`DATAFORSEO_PASSWORD`, y haber corrido `npm install` en ~/.agents/tools.
- Necesita en el PATH: node
- makes network requests

## Archivos

- SKILL.md — 3 KB

## SKILL.md

Reproducido tal cual desde OpenClaudia/openclaudia-skills bajo MIT. Esta sección es el documento original y está en inglés.

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

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

## Dónde encaja

- Categoría: [Datos y analítica](https://skillsagentes.com/categorias/datos-analitica.md) — Consulta, limpia y visualiza datos sin salir del agente.
- Creador: [OpenClaudia](https://skillsagentes.com/creators/openclaudia.md) — 76 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Competitor Traffic Report](https://skillsagentes.com/skills/openclaudia/openclaudia-skills/competitor-traffic-report.md): Genera un informe HTML autocontenible de tráfico competitivo: visitas mensuales (SimilarWeb), tráfico orgánico y Domain Rating (Ahrefs), con gráficos ranked, tendencias y tabla de datos.
- [Brand Dev](https://skillsagentes.com/skills/openclaudia/openclaudia-skills/brand-dev.md): Obtiene datos de marca (nombre, descripción, logos, industria) desde la API de brand.dev y guarda los logos localmente.
- [Gsc Portfolio Audit](https://skillsagentes.com/skills/openclaudia/openclaudia-skills/gsc-portfolio-audit.md): Audita TODAS las propiedades de Google Search Console a la vez: ranking por clics e impresiones con deltas, y diff de keywords por sitio (nuevas, suben, bajan, perdidas, o bien rankeadas sin clics).
- [Wechat Moments](https://skillsagentes.com/skills/openclaudia/openclaudia-skills/wechat-moments.md): Clasifica y resume el feed de WeChat Moments (朋友圈) del usuario para que los eventos reales y la información genuina destaquen sobre la promoción, ponderando según cuánto le escribe el usuario a cada autor.
- [Podcast Edit](https://skillsagentes.com/skills/openclaudia/openclaudia-skills/podcast-edit.md): Edita audio o video de podcast: recorta charla previa/posterior, quita muletillas, corta silencios, mejora el audio y aplica el mismo corte a una versión en video.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)