Agent skill

Brightlocal Tool

by garrettjsmith in garrettjsmith/localseoskills

When the user wants citation audits, citation building, review monitoring across platforms, GBP audit scoring, or white-label local SEO reports.

MITAuto-check passedMarketing & SEO

Install Brightlocal Tool

skills CLI
$ npx skills add garrettjsmith/localseoskills --skill brightlocal-tool -a claude-code

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

GitHub CLI
$ gh skill install garrettjsmith/localseoskills brightlocal-tool --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/brightlocal-tool .claude/skills/brightlocal-tool && 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
brightlocal-tool
GitHub stars
114
Token cost
~1.8k tokens
SKILL.md length
821 words
Files
1
Skills in repo
38
Repo updated
First seen
Licence
MIT

At a glance

When the user wants citation audits, citation building, review monitoring across platforms, GBP audit scoring, or white-label local SEO reports.

  • Works in 4 steps: Citation Tracker: All found citations… → Accuracy scores: NAP match percentage… → Directory coverage: Which directories… → …
  • Wants citation audits
  • SKILL.md covers When to Use BrightLocal vs…, Core Workflows, Interpreting Citation Data and What to Do Next
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Brightlocal Tool is an agent skill from garrettjsmith/localseoskills. When the user wants citation audits, citation building, review monitoring across platforms, GBP audit scoring, or white-label local SEO reports. Trigger on "citation audit," "check my citations," "NAP consistency," "where am I listed," "BrightLocal," "directory listings," "review monitoring," or "client report."

Its SKILL.md is about 1.8k 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 and Citation management. 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 citation audits
  • Citation building
  • Review monitoring across platforms
  • GBP audit scoring

Example prompts

  • “citation audit,”
  • “check my citations,”
  • “NAP consistency,”
  • “/brightlocal-tool”

Workflow steps

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

  1. Citation Tracker: All found citations for the business
  2. Accuracy scores: NAP match percentage per directory
  3. Directory coverage: Which directories have listings vs which don't
  4. Duplicate detection: Multiple listings on the same directory

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

Brightlocal Tool loads about 1.8k tokens when it runs. Until then it costs about 83 tokens; SKILL.md has 821 words of instructions outside code blocks.

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

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). 821 words, ~1,772 tokens.

Download SKILL.mdSave it as .claude/skills/brightlocal-tool/SKILL.md (or your agent's skills folder).
name
brightlocal-tool
description
When the user wants citation audits, citation building, review monitoring across platforms, GBP audit scoring, or white-label local SEO reports. Trigger on "citation audit," "check my citations," "NAP consistency," "where am I listed," "BrightLocal," "directory listings," "review monitoring," or "client report."
metadata.version
1.0.0
metadata.author
Garrett Smith

BrightLocal Tool

Note: LocalSEOData (localseodata-tool) now covers citation audits (citation_audit), multi-platform reviews (multi_platform_reviews), and reputation auditing (reputation_audit). Use LocalSEOData as default for data pulls. BrightLocal remains useful for citation building/submission and review monitoring dashboards.

BrightLocal has an official MCP server. When connected, use it for citation management, review aggregation, GBP auditing, and client reporting. This is your primary citation intelligence tool.

When to Use BrightLocal vs Other Tools

You NeedUse BrightLocalUse Instead
Citation audit (where is this business listed?)✅ Best for this—
NAP consistency check across directories✅ Best for this—
Citation building (submit to directories)✅ Managed serviceWhitespark (alternative)
Review monitoring across multiple platforms✅—
GBP profile audit/scoring✅—
White-label client reports✅—
Keyword search volume❌Semrush, Ahrefs
Backlink analysis❌Ahrefs
Geogrid rankings❌Local Falcon
Live SERP data❌SerpAPI
Technical site audit❌Screaming Frog

Core Workflows

Citation Audit

When: User asks "where am I listed?" or "are my citations consistent?" or this is part of a local SEO audit.

What to pull:

  1. Citation Tracker: All found citations for the business
  2. Accuracy scores: NAP match percentage per directory
  3. Directory coverage: Which directories have listings vs which don't
  4. Duplicate detection: Multiple listings on the same directory

How to interpret:

  • Accuracy score above 90%: Good — minor fixes needed
  • Accuracy score 70-90%: Moderate issues — old phone numbers, address variations
  • Accuracy score below 70%: Serious problems — inconsistent data confusing Google
  • Missing from major directories (Google, Yelp, Facebook, Apple Maps, Bing): Critical gaps
  • Duplicates on same directory: Splitting ranking signals — need to merge or remove

Priority directories to check:

  1. Google Business Profile (the #1 citation)
  2. Apple Maps / Apple Business Connect
  3. Bing Places
  4. Yelp
  5. Facebook
  6. Industry-specific directories (Healthgrades, Avvo, Angi, etc.)
  7. Data aggregators (Data Axle, Neustar/Localeze, Foursquare)
Citation Building

When: Audit reveals missing directories or user needs new citations built.

BrightLocal offers managed citation building — they submit to directories on your behalf.

What to specify:

  • Business NAP (must be exactly consistent with GBP)
  • Categories
  • Description
  • Photos
  • Target directories (or let BrightLocal recommend based on industry)

Timeline: Most submissions process in 2-4 weeks. Some directories take longer.

After building: Re-audit in 6-8 weeks to verify submissions were accepted and data is accurate.

Review Monitoring

When: User wants to track reviews across Google, Yelp, Facebook, and industry platforms.

What to pull:

  1. Review feed: All reviews across connected platforms
  2. Review count and rating per platform
  3. New review alerts: Recent reviews needing responses
  4. Sentiment trends: Rating direction over time

What to look for:

  • Platforms where reviews are accumulating but no one is responding
  • Rating discrepancies between platforms (4.8 on Google but 3.2 on Yelp — investigate)
  • Review velocity compared to competitors
  • Negative review patterns (recurring complaints = operational issue)
GBP Audit

When: Need a quick health check on the Google Business Profile.

What BrightLocal checks:

  • Profile completeness (photos, description, hours, categories, attributes)
  • NAP consistency with website and citations
  • Review response rate
  • Post activity
  • Category accuracy

Scoring: BrightLocal generates an audit score. Use this as a starting point, then apply gbp-optimization skill for the detailed playbook.

Show full SKILL.md (315 more words)Show less
Client Reporting

When: Need to generate a client-facing report.

What to include:

  • Citation health score and changes
  • Review summary (count, rating, new reviews)
  • GBP audit score
  • Ranking data (if using BrightLocal's rank tracker)

Note: BrightLocal reports are white-labelable. For agencies, brand them before sending.

Interpreting Citation Data

NAP Consistency Scoring
ScoreStatusAction
95-100%ExcellentMonitor quarterly
85-94%GoodFix remaining inconsistencies
70-84%Needs workPrioritize top directories, fix data aggregators
Below 70%CriticalFull citation cleanup needed before other optimization
Common Citation Issues
IssueWhat Causes ItHow to Fix
Old phone numberBusiness changed numbers, aggregators have old dataUpdate aggregators first (Data Axle, Neustar, Foursquare), then individual directories
Old addressBusiness moved, aggregators propagated old addressSame — fix at aggregator level
Name variations"Smith Plumbing" vs "Smith Plumbing LLC" vs "Smith's Plumbing"Standardize to match GBP exactly
Duplicate listingsMultiple submissions over time, or auto-generated listingsClaim and merge or request removal
Wrong categoryDirectory auto-assigned categoryManually update on each directory
Aggregator Priority

Fix data aggregators FIRST — they feed data to hundreds of downstream directories:

  1. Data Axle (formerly Infogroup) — feeds the most directories
  2. Neustar/Localeze — second-largest aggregator
  3. Foursquare — feeds Apple Maps and many apps
  4. Yelp — both a directory and a data source for Apple Maps

What to Do Next

What You FoundNext ActionSkill
NAP inconsistencies across directoriesFix aggregators first, then individual directorieslocal-citations
Missing from key directoriesBuild citations on missing directorieslocal-citations
Low review count on GoogleBuild review generation strategyreview-management
GBP audit shows incomplete profileOptimize the profilegbp-optimization
Citations clean but still not rankingCitations aren't the issue — check other factorsgeogrid-analysis, local-seo-audit
Need to present findings to clientPackage citation report with recommendationsclient-deliverables

Default next step: Citation cleanup is a slow process (4-8 weeks for aggregator changes to propagate). Start the cleanup, then work on other optimization while waiting.

© 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/brightlocal-tool of garrettjsmith/localseoskills.

Open the folder on GitHubat commit 405ce20

Compare with similar skills

Brightlocal Tool 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.

Brightlocal Tool compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Brightlocal Tool this skillgarrettjsmith/localseoskills114—~1.8kAutomated safety check: PassMIT
SEO Localseranking/seo-skills160—~4.9kAutomated safety check: PassMIT
Page Play Builderaaron-he-zhu/aaron-marketing-skills2.9k—~3.6kAutomated safety check: PassApache-2.0
Geo Site Diagnoseyaojingang/GEOHub164—~515Automated safety check: PassAGPL-3.0
Geo Diagnoseyaojingang/GEOHub164—~434Automated safety check: PassAGPL-3.0
SEO ProfoundAgriciDaniel/claude-seo18k1 repos~441Automated safety check: PassMIT

Similar skills

  • SEO Local

    seranking/seo-skills

    Local SEO audit for brick-and-mortar, service-area, and multi-location businesses.

    160 GitHub stars~4.9k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • Page Play Builder

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "build programmatic SEO pages", "generate pages at scale", "rank on a high-authority third-party site", "borrow domain authority", "build a vs /…

    2.9k GitHub stars~3.6k tokensUpdated today
    Marketing & SEOAuto-check passed
  • Geo Site Diagnose

    yaojingang/GEOHub

    Crawl one public website from a supplied URL, select up to ten representative page types, score evidence-lined GEO readiness, and generate a standalone visual HTML report.

    164 GitHub stars~515 tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Geo Diagnose

    yaojingang/GEOHub

    Diagnose a brand, website, or page for evidence-backed GEO gaps and opportunities from user-supplied URLs, HTML, or evidence.

    164 GitHub stars~434 tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • SEO Profound

    AgriciDaniel/claude-seo

    Profound LLM citation tracker (extension). An agent skill from AgriciDaniel/claude-seo.

    18k GitHub starsUsed in 1 repo~441 tokens
    Marketing & SEOAuto-check passed
  • Geo Measure

    yaojingang/GEOHub

    Measure GEO visibility from an approved, file-backed engine observation bundle.

    164 GitHub stars~348 tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed

More from garrettjsmith/localseoskills

All 38 skills in this repo
  • Gbp API Automation

    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.

    114 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Gbp Posts

    garrettjsmith/localseoskills

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

    114 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.

    114 GitHub stars~3.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Brief

    garrettjsmith/localseoskills

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

    114 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.

    114 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.

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

Questions about Brightlocal Tool

What does Brightlocal Tool do?

When the user wants citation audits, citation building, review monitoring across platforms, GBP audit scoring, or white-label local SEO reports. Brightlocal Tool is an agent skill from garrettjsmith/localseoskills. When the user wants citation audits, citation building, review monitoring across platforms, GBP audit scoring, or white-label local SEO reports.

When should I use Brightlocal Tool?

Brightlocal Tool fits situations like: wants citation audits; citation building; review monitoring across platforms; GBP audit scoring.

How do I install Brightlocal Tool in Claude Code?

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

How do I install Brightlocal Tool in Codex?

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

Can I use Brightlocal Tool 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 brightlocal-tool -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/brightlocal-tool, .gemini/skills/brightlocal-tool, .github/skills/brightlocal-tool and .opencode/skills/brightlocal-tool in your project.

What does Brightlocal Tool need to run?

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

Does Brightlocal Tool 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 Brightlocal Tool 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 Brightlocal Tool use?

Brightlocal Tool 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 Brightlocal Tool use?

About 1.8k tokens (SKILL.md is roughly 7.1k 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 Brightlocal Tool?

Skills that share tags, products or a category with Brightlocal Tool: SEO Local (seranking/seo-skills, 160 stars), Page Play Builder (aaron-he-zhu/aaron-marketing-skills, 2.9k stars), Geo Site Diagnose (yaojingang/GEOHub, 164 stars) and Geo Diagnose (yaojingang/GEOHub, 164 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Brightlocal Tool?

garrettjsmith (a GitHub user) maintains it in garrettjsmith/localseoskills, which has 114 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.