New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Gbp API Automation

by garrettjsmith in garrettjsmith/localseoskills

When the user wants to programmatically manage Google Business Profiles at scale via API, automate GBP updates, build GBP management tools, or integrate GBP data into their systems.

MITAuto-check passedMarketing & SEO

Install Gbp API Automation

skills CLI
$ npx skills add garrettjsmith/localseoskills --skill gbp-api-automation -a claude-code

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

GitHub CLI
$ gh skill install garrettjsmith/localseoskills gbp-api-automation --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/garrettjsmith/localseoskills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/gbp-api-automation .claude/skills/gbp-api-automation && 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
gbp-api-automation
GitHub stars
120
Token cost
~2.1k tokens
SKILL.md length
832 words
Files
1
Skills in repo
38
Repo updated
First seen
Licence
MIT

At a glance

When the user wants to programmatically manage Google Business Profiles at scale via API, automate GBP updates, build GBP management tools, or integrate GBP data into their systems.

  • Works in 5 steps: Google Cloud project → Enable relevant Business Profile APIs → OAuth 2.0 credentials (service account… → …
  • Wants to programmatically manage Google Business Profiles at scale via API
  • SKILL.md covers API Landscape Overview, Authentication & Setup, Common Automation Patterns and Suspension Risk from API Usage, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Gbp API Automation is an agent skill from garrettjsmith/localseoskills. When the user wants to programmatically manage Google Business Profiles at scale via API, automate GBP updates, build GBP management tools, or integrate GBP data into their systems. Also use when the user mentions "GBP API," "Google Business Profile API," "bulk GBP management," "automate GBP," "GBP integration," or "programmatic GBP." For manual GBP optimization, see gbp-optimization. For multi-location strategy, see multi-location-seo.

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

It sits in Marketing & SEO, covering Local SEO. The repository describes itself as: Open-source Claude SEO tool for local search visibility — skills, tool integrations, and automation templates that turn Claude into a Local SEO expert. The licence is MIT.

When your agent uses it

  • Wants to programmatically manage Google Business Profiles at scale via API
  • Automate GBP updates
  • Build GBP management tools
  • Integrate GBP data into their systems

Example prompts

  • “GBP API,”
  • “Google Business Profile API,”
  • “bulk GBP management,”
  • “/gbp-api-automation”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Google Cloud project
  2. Enable relevant Business Profile APIs
  3. OAuth 2.0 credentials (service account or web app flow)
  4. GBP account access (Owner or Manager role)
  5. API quota approval (for higher limits)

What it can do on your machine

Read from SKILL.md and the folder at commit 405ce20. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Gbp API Automation loads about 2.1k tokens when it runs. Until then it costs about 115 tokens; SKILL.md has 832 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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 garrettjsmith/localseoskills at commit 405ce20, republished under its MIT licence (© garrettjsmith). 832 words, ~2,098 tokens.

Download SKILL.mdSave it as .claude/skills/gbp-api-automation/SKILL.md (or your agent's skills folder).
name
gbp-api-automation
description
When the user wants to programmatically manage Google Business Profiles at scale via API, automate GBP updates, build GBP management tools, or integrate GBP data into their systems. Also use when the user mentions "GBP API," "Google Business Profile API," "bulk GBP management," "automate GBP," "GBP integration," or "programmatic GBP." For manual GBP optimization, see gbp-optimization. For multi-location strategy, see multi-location-seo.
metadata.version
1.0.0
metadata.author
Garrett Smith

GBP API & Automation

You are an expert in Google Business Profile API capabilities and programmatic management at scale. Your goal is to help businesses and agencies automate GBP operations for 10-500+ locations efficiently and safely.

API Landscape Overview

Google has split GBP functionality across multiple APIs:

Google My Business API (Legacy)
  • Being deprecated in favor of newer APIs
  • Some endpoints still active during transition
  • Check current deprecation status before building
Current APIs (as of early 2026)

Business Profile API

  • Account and location management
  • Location verification
  • Read/update business information

Business Information API

  • Categories, attributes, chains
  • Location details CRUD operations
  • Search for locations

Business Profile Performance API

  • Impressions, actions, direction requests
  • Search keyword data
  • Historical performance metrics

My Business Notifications API

  • Webhook notifications for profile changes
  • Review notifications
  • Question notifications

My Business Q&A API

  • Read and respond to Q&A

My Business Lodging API

  • Hotel-specific data and features

My Business Verifications API

  • Initiate and complete verification
What Requires Separate APIs
  • Reviews: Read via API, but responding requires different access
  • Posts: GBP post creation via API
  • Photos: Upload and manage media
  • Insights: Performance data extraction

Authentication & Setup

Requirements
  1. Google Cloud project
  2. Enable relevant Business Profile APIs
  3. OAuth 2.0 credentials (service account or web app flow)
  4. GBP account access (Owner or Manager role)
  5. API quota approval (for higher limits)
Access Levels
  • Owner: Full API access, can manage users
  • Manager: Most operations except ownership transfer
  • Communications Manager: Limited to posts, Q&A, reviews
Rate Limits
  • Default quotas are restrictive for bulk operations
  • Request quota increases through Google Cloud Console
  • Batch requests to reduce API calls
  • Implement exponential backoff for rate limit errors
  • Cache responses where appropriate

Common Automation Patterns

Bulk Information Updates
For each location:
  1. Read current data
  2. Compare to master database
  3. Patch only changed fields
  4. Log changes for audit

Caution: Updating too many locations simultaneously can trigger automated review. Stagger updates across hours/days.

Automated Posting
For each location:
  1. Generate post from template + location variables
  2. Attach location-specific photo
  3. Create post via API
  4. Log post ID and timestamp
  5. Schedule next post

Cadence: 1-3 posts per location per week. Don't post identical content across all locations simultaneously.

Review Monitoring
On schedule (hourly/daily):
  1. Fetch new reviews for all locations
  2. Classify sentiment and urgency
  3. Route negative reviews for immediate response
  4. Queue positive reviews for batch response
  5. Track metrics (count, rating, velocity)
Performance Data Extraction
Monthly:
  1. Pull performance metrics for all locations
  2. Aggregate into reporting database
  3. Generate comparison reports
  4. Flag locations with declining metrics
Verification Management
For new locations:
  1. Create location
  2. Initiate verification
  3. Track verification status
  4. Retry if verification expires
  5. Alert on failures

Suspension Risk from API Usage

High-Risk Actions
  • Bulk name changes (even legitimate ones trigger review)
  • Mass category changes
  • Rapid creation of many new locations
  • Updating address for many locations simultaneously
  • Automated content that looks templated/spammy
Risk Mitigation
  • Stagger bulk operations over days/weeks
  • Change one major field at a time (don't batch name + address + category)
  • Monitor for suspension flags after bulk operations
  • Keep detailed audit logs of all API changes
  • Test changes on a small batch before full deployment
  • Avoid making changes during known Google update periods
Safe Operations (Low Suspension Risk)
  • Reading/exporting data
  • Updating hours
  • Adding photos
  • Creating posts (reasonable cadence)
  • Responding to reviews
  • Updating descriptions
  • Adding services/products

Third-Party Platforms

For teams that don't want to build custom API integrations:

Location Management Platforms
  • Yext: Enterprise location data management
  • Uberall: Multi-location marketing platform
  • Rio SEO: Enterprise local marketing
  • Synup: Location management and analytics
  • BrightLocal: Agency-focused local SEO tools
GBP-Specific Tools
  • Whitespark: Listing management and tracking
  • Local Viking: GBP management and posting
  • Publer / Loomly: Social + GBP posting
Show full SKILL.md (349 more words)Show less
Build vs. Buy Decision
FactorBuild CustomUse Platform
Locations50+ with specific needsAny count
BudgetDev resources availableMonthly SaaS budget
CustomizationNeed unique workflowsStandard workflows OK
MaintenanceCan maintain ongoingWant managed solution
Data ownershipNeed raw data accessReports sufficient

Data Architecture for Multi-Location

Master Location Database

Essential fields:

  • Location ID (internal)
  • Google Place ID
  • GBP account/location reference
  • Business name (canonical)
  • Address (USPS-formatted)
  • Phone (E.164 format)
  • Primary category
  • Additional categories
  • Service areas
  • Hours (regular + special)
  • Website URL
  • Status (active, suspended, pending)
  • Last updated timestamp
Sync Logic
Master DB → API → GBP
         ↑
API reads ← GBP (detect unauthorized edits)

Monitor for discrepancies between your master data and what's live on GBP. Google and users can suggest edits that override your data.

Monitoring & Alerting

What to Monitor
  • Unauthorized edits: Someone (Google or users) changed your data
  • Suspension events: Location suspended or disabled
  • Review alerts: New reviews (especially negative)
  • Verification status: Locations losing verification
  • Performance anomalies: Sudden drops in impressions or actions
  • API errors: Failed operations, rate limits, auth issues
Alert Priority
  • P0 (immediate): Suspension, verification loss, business name change
  • P1 (same day): Negative review, address edit suggestion, hours change
  • P2 (next business day): Performance drop, new Q&A, positive review
  • P3 (weekly review): Photo suggestions, attribute changes, category suggestions

Task-Specific Questions

  1. How many locations need API management?
  2. What operations need automation? (updates, posts, reviews, reporting)
  3. Build custom or use a platform?
  4. What's the current tech stack?
  5. Who manages the Google Cloud project and API credentials?
  6. What's the change management process for bulk updates?

What to Do Next

What You FoundNext ActionSkill
API is set up, need to know WHAT to optimizeDefine optimization standards per locationgbp-optimization
Need to automate posts across locationsBuild post templates with location variablesgbp-posts
API operations triggered a suspensionStop API calls immediately, follow recovery processgbp-suspension-recovery
Need to extract performance data for reportsPull metrics via API and feed into reportinglocal-reporting
Need to manage reviews at scaleSet up review monitoring and response workflowsreview-management

Default next step: API is a delivery mechanism. Define your optimization strategy first (gbp-optimization, multi-location-seo), then automate it.

© garrettjsmith, 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/gbp-api-automation of garrettjsmith/localseoskills.

Open the folder on GitHubat commit 405ce20

Compare with similar skills

Gbp API Automation 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.

Gbp API Automation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gbp API Automation this skillgarrettjsmith/localseoskills120—~2.1kAutomated safety check: PassMIT
FLOW SEO FrameworkAgriciDaniel/claude-seo19k2 repos~1.4kAutomated safety check: PassMIT
Google Mapscablate/mcp-google-map469—~909Automated safety check: PassMIT
Google Maps Local SEOcablate/mcp-google-map469—~633Automated safety check: PassMIT
Google Maps Travel Planningcablate/mcp-google-map469—~710Automated safety check: PassMIT
SEO Project Setuppetera2c/simple-table2292 repos~1.5kAutomated safety check: PassMIT

Similar skills

  • FLOW SEO Framework

    AgriciDaniel/claude-seo

    Brings the FLOW framework's stage-specific SEO prompts into the agent, from keyword discovery through backlinks, on-page work and conversion to local SEO, loaded on demand.

    19k GitHub starsUsed in 2 repos~1.4k tokens
    Marketing & SEOAuto-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

  • Google Maps Local SEO

    cablate/mcp-google-map

    Analyze Google Business Profile visibility, geographic grid rankings, local search keywords, and nearby competitors through the standalone Google Maps CLI.

    469 GitHub stars~633 tokensUpdated 13 days ago
    Marketing & SEOAuto-check passed

  • Google Maps Travel Planning

    cablate/mcp-google-map

    Build evidence-backed day trips, multi-day itineraries, and efficient stop sequences with Google Maps data through the standalone CLI.

    469 GitHub stars~710 tokensUpdated 13 days ago
    Marketing & SEOAuto-check passed

  • SEO Project Setup

    petera2c/simple-table

    Set up a durable local SEO workspace with project context, notes, goals, positioning, preferences, MCP checks, and Search Console data intake.

    229 GitHub starsUsed in 2 repos~1.5k tokens
    Marketing & SEOAuto-check passed

  • Universal SEO Analysis

    AgriciDaniel/claude-seo

    Hub for site-wide SEO work: audits, technical checks, schema, content quality, local, hreflang and AI-search readiness, run through slash commands.

    19k GitHub stars~4.9k tokensUpdated 5 days ago
    Marketing & SEOAuto-check passed

More from garrettjsmith/localseoskills

All 38 skills in this repo

  • Gbp Posts

    garrettjsmith/localseoskills

    When the user wants to create, schedule, or optimize Google Business Profile posts.

    120 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed

  • Local Content Briefs

    garrettjsmith/localseoskills

    Generate complete semantic content briefs for local SEO content — location pages, service pages, blog posts, FAQ content, and pillar pages.

    120 GitHub stars~3.5k tokensUpdated 1 mo ago
    Auto-check passed

  • Brief

    garrettjsmith/localseoskills

    Manages persistent work state (briefs) for local SEO engagements.

    120 GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check: warnings

  • Local Content Strategy

    garrettjsmith/localseoskills

    Build a complete local content strategy from keyword research output.

    120 GitHub stars~2.8k tokensUpdated 1 mo ago
    Auto-check passed

  • Local Falcon Tool

    garrettjsmith/localseoskills

    When the user wants to run a geogrid scan, check existing scan reports, track ranking trends over time, monitor GBP changes via Falcon Guard, or analyze reviews.

    120 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed

  • Local Keyword Research

    garrettjsmith/localseoskills

    When the user wants to research keywords for a local business, find local search opportunities, build a keyword map for location pages, or understand local search intent.

    120 GitHub stars~4.7k tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Gbp API Automation

What does Gbp API Automation do?

When the user wants to programmatically manage Google Business Profiles at scale via API, automate GBP updates, build GBP management tools, or integrate GBP data into their systems. Gbp API Automation is an agent skill from garrettjsmith/localseoskills. When the user wants to programmatically manage Google Business Profiles at scale via API, automate GBP updates, build GBP management tools, or integrate GBP data into their systems.

When should I use Gbp API Automation?

Gbp API Automation fits situations like: wants to programmatically manage Google Business Profiles at scale via API; automate GBP updates; build GBP management tools; integrate GBP data into their systems.

How do I install Gbp API Automation in Claude Code?

Run `npx skills add garrettjsmith/localseoskills --skill gbp-api-automation -a claude-code`. Or copy the skill folder (skills/gbp-api-automation in garrettjsmith/localseoskills) into .claude/skills/gbp-api-automation in your project. Claude Code loads it when a task matches its description.

How do I install Gbp API Automation in Codex?

Run `npx skills add garrettjsmith/localseoskills --skill gbp-api-automation -a codex`. Or copy the skill folder (skills/gbp-api-automation in garrettjsmith/localseoskills) into .agents/skills/gbp-api-automation in your project. Codex loads it when a task matches its description.

Can I use Gbp API Automation 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 garrettjsmith/localseoskills --skill gbp-api-automation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gbp-api-automation, .gemini/skills/gbp-api-automation, .github/skills/gbp-api-automation and .opencode/skills/gbp-api-automation in your project.

What does Gbp API Automation need to run?

SKILL.md names no scripts, command-line tools or credentials: Gbp API Automation is instructions for the agent only.

Does Gbp API Automation access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Gbp API Automation safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Gbp API Automation use?

Gbp API Automation 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 Gbp API Automation use?

About 2.1k tokens (SKILL.md is roughly 8.4k 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 Gbp API Automation?

Skills that share tags, products or a category with Gbp API Automation: FLOW SEO Framework (AgriciDaniel/claude-seo, 19k stars), Google Maps (cablate/mcp-google-map, 469 stars), Google Maps Local SEO (cablate/mcp-google-map, 469 stars) and Google Maps Travel Planning (cablate/mcp-google-map, 469 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gbp API Automation?

garrettjsmith (a GitHub user) maintains it in garrettjsmith/localseoskills, which has 120 GitHub stars. The repository holds 38 skills in this directory. The repository was last updated on August 15, 2026.

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