Agent skill

Google Reviews

by OpenClaudia in OpenClaudia/openclaudia-skills

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

MITAuto-check: notes

Install Google Reviews

skills CLI
$ npx skills add OpenClaudia/openclaudia-skills --skill google-reviews -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install OpenClaudia/openclaudia-skills google-reviews --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/OpenClaudia/openclaudia-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/google-reviews .claude/skills/google-reviews && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
google-reviews
GitHub stars
713
Token cost
~820 tokens
SKILL.md length
246 words
Files
1
Skills in repo
74
Repo updated
First seen
Licence
MIT

At a glance

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

  • The user asks to check Google reviews
  • SKILL.md covers When to Use This Skill, Tool Location, Usage and Output, plus 3 more sections
  • Calls node and npm; reaches trustauto.ca; needs AISA_ONE_API_KEY and DATAFORSEO_PASSWORD
  • Get review counts

What it does

Google Reviews is an agent skill from OpenClaudia/openclaudia-skills. 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.

Its SKILL.md is about 820 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Google Maps Platform. The repository describes itself as: 77 open-source marketing skills for Claude Code, Codex, and other AI coding agents. SEO, content, email, ads, analytics, and growth. The licence is MIT.

When your agent uses it

  • The user asks to check Google reviews
  • Get review counts
  • Compare business ratings
  • Audit Google Maps presence

Example prompts

  • “/google-reviews”

Requirements

  • Node.js
  • A credential in AISA_ONE_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 28bf209. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • node
    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • trustauto.ca

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • AISA_ONE_API_KEY
    • DATAFORSEO_PASSWORD

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Google Reviews loads about 820 tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 246 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~62
When it runs · the whole SKILL.md, loaded when a task matches
~820

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:108
    cript loads credentials from both local `.env` and environment variables

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from OpenClaudia/openclaudia-skills at commit 28bf209, republished under its MIT licence (© OpenClaudia). 246 words, ~820 tokens.

Download SKILL.mdSave it as .claude/skills/google-reviews/SKILL.md (or your agent's skills folder).
name
google-reviews
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.

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

© OpenClaudia, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/google-reviews of OpenClaudia/openclaudia-skills.

Open the folder on GitHubat commit 28bf209

Compare with similar skills

Google Reviews next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Google Reviews compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Google Reviews this skillOpenClaudia/openclaudia-skills713—~820Automated safety check: NotesMIT
Google Maps Lead Scrapergosom/google-maps-scraper6.4k—~1.8kAutomated safety check: WarnMIT
Google Maps ScraperMahanaicoach/google-maps-scraper-kit1.3k—~2.8kAutomated safety check: PassMIT
Google Mapscablate/mcp-google-map469—~909Automated safety check: PassMIT
Draw Imageai-sns/ai-sns332—~778Automated safety check: PassMIT
Android Maps Ktxgooglemaps/android-maps-ktx360—~897Automated safety check: PassApache-2.0

Similar skills

  • Google Maps Lead Scraper

    gosom/google-maps-scraper

    Turns a plain request such as finding dentists in a city into a local Google Maps crawl run with Docker, then monitors it and helps you work with the results.

    6.4k GitHub stars~1.8k tokensUpdated 16 days ago
    Data & AnalyticsAuto-check: warnings
  • Google Maps Scraper

    Mahanaicoach/google-maps-scraper-kit

    Scrape Google Maps business listings (name, address, phone, website, rating, reviews, lat/lng, hours, emails) via the local gosom google-maps-scraper REST API.

    1.3k GitHub stars~2.8k tokensUpdated 5 days ago
    Data & AnalyticsAuto-check passed
  • Google Maps

    cablate/mcp-google-map

    Search places, resolve addresses, compare routes, inspect neighborhoods, and retrieve geographic or environmental facts through the standalone @cablate/mcp-google-map CLI.

    469 GitHub stars~909 tokensUpdated 13 days ago
    Marketing & SEOAuto-check passed
  • Draw Image

    ai-sns/ai-sns

    Generate an image from a text prompt using an OpenAI-compatible image generation API (gpt-image-1-mini or compatible).

    332 GitHub stars~778 tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • Android Maps Ktx

    googlemaps/android-maps-ktx

    Provides idiomatic Kotlin extension (KTX) patterns, reactive Flow event streams, and multi-subscriber shareIn rules for Google Maps SDK for Android and its Utility Library.

    360 GitHub stars~897 tokensUpdated 2 days ago
    MobileAuto-check passed
  • Local Places

    geezerrrr/motive

    Search for places (restaurants, cafes, etc.) via Google Places API proxy on localhost.

    115 GitHub starsUsed in 5 repos~635 tokens
    Auto-check: notes

More from OpenClaudia/openclaudia-skills

All 74 skills in this repo
  • Competitor Traffic Report

    OpenClaudia/openclaudia-skills

    Build an interactive competitive-traffic report for any company and its rivals — monthly visits (SimilarWeb), organic search traffic and Domain Rating (Ahrefs) — as one self-contained HTML page with…

    713 GitHub stars~1.2k tokensUpdated 22 days ago
    Auto-check passed
  • Geo Difficulty

    OpenClaudia/openclaudia-skills

    Score how hard a keyword is to rank for in the AI-search era — page-level URL Rating of real competitors (not just domain DR), Ahrefs keyword difficulty, and whether a given site already ranks or is…

    713 GitHub stars~694 tokensUpdated 22 days ago
    Auto-check passed
  • Gsc Portfolio Audit

    OpenClaudia/openclaudia-skills

    Audit EVERY Google Search Console property at once — rank all sites by clicks and impressions with period-over-period deltas, then diff keywords per site to surface what is newly ranking, rising…

    713 GitHub stars~1k tokensUpdated 22 days ago
    Auto-check passed
  • Similarweb Traffic

    OpenClaudia/openclaudia-skills

    Fetch website traffic estimates (monthly visits, traffic sources, top countries, keywords, engagement, ranks) for any domain from SimilarWeb.

    713 GitHub stars~882 tokensUpdated 22 days ago
    Auto-check passed
  • Ahrefs Python

    OpenClaudia/openclaudia-skills

    Manages Ahrefs API usage in Python using ahrefs-python library.

    713 GitHub stars~1.9k tokensUpdated 22 days ago
    Auto-check passed
  • Ab Test Setup

    OpenClaudia/openclaudia-skills

    Design, plan, and analyze A/B tests with statistical rigor. An agent skill from OpenClaudia/openclaudia-skills.

    713 GitHub stars~1.7k tokensUpdated 22 days ago
    Auto-check passed

Questions about Google Reviews

What does Google Reviews do?

Fetch Google review ratings and review counts for businesses via DataForSEO API. Google Reviews is an agent skill from OpenClaudia/openclaudia-skills. Fetch Google review ratings and review counts for businesses via DataForSEO API.

When should I use Google Reviews?

Google Reviews fits situations like: the user asks to check Google reviews; get review counts; compare business ratings; audit Google Maps presence.

How do I install Google Reviews in Claude Code?

Run `npx skills add OpenClaudia/openclaudia-skills --skill google-reviews -a claude-code`. Or copy the skill folder (skills/google-reviews in OpenClaudia/openclaudia-skills) into .claude/skills/google-reviews in your project. Claude Code loads it when a task matches its description.

How do I install Google Reviews in Codex?

Run `npx skills add OpenClaudia/openclaudia-skills --skill google-reviews -a codex`. Or copy the skill folder (skills/google-reviews in OpenClaudia/openclaudia-skills) into .agents/skills/google-reviews in your project. Codex loads it when a task matches its description.

Can I use Google Reviews in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add OpenClaudia/openclaudia-skills --skill google-reviews -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/google-reviews, .gemini/skills/google-reviews, .github/skills/google-reviews and .opencode/skills/google-reviews in your project.

What does Google Reviews need to run?

Going by SKILL.md and its folder, Google Reviews needs the command-line tools its instructions call (node and npm) and credentials named AISA_ONE_API_KEY and DATAFORSEO_PASSWORD. Our summary lists: Node.js; A credential in AISA_ONE_API_KEY.

Does Google Reviews access the network?

SKILL.md names 1 domain. In commands or code: trustauto.ca; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Google Reviews safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Google Reviews use?

Google Reviews is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Google Reviews use?

About 820 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Google Reviews?

Skills that share tags, products or a category with Google Reviews: Google Maps Lead Scraper (gosom/google-maps-scraper, 6.4k stars), Google Maps Scraper (Mahanaicoach/google-maps-scraper-kit, 1.3k stars), Google Maps (cablate/mcp-google-map, 469 stars) and Draw Image (ai-sns/ai-sns, 332 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Google Reviews?

OpenClaudia (a GitHub organization) maintains it in OpenClaudia/openclaudia-skills, which has 713 GitHub stars. The repository holds 74 skills in this directory. The repository was last updated on September 18, 2026.

Source: OpenClaudia/openclaudia-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.