Agent skill

Whitespark Tool

by garrettjsmith in garrettjsmith/localseoskills

When the user wants citation gap analysis, managed citation building, review generation campaigns, or local rank tracking.

MITAuto-check passedMarketing & SEO

Install Whitespark Tool

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

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

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

At a glance

When the user wants citation gap analysis, managed citation building, review generation campaigns, or local rank tracking.

  • Works in 3 steps: Run Local Citation Finder for target… → Compare citation sources across all… → Identify directories where competitors…
  • Wants citation gap analysis
  • SKILL.md covers When to Use Whitespark vs…, Whitespark vs BrightLocal, Core Workflows and Whitespark APIs, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Whitespark Tool is an agent skill from garrettjsmith/localseoskills. When the user wants citation gap analysis, managed citation building, review generation campaigns, or local rank tracking. Trigger on "Whitespark," "citation finder," "where are my competitors listed," "citation gap," "build citations," "review generation tool," or "get more reviews." Note that Whitespark does NOT have an MCP server — it's dashboard-driven with limited API.

Its SKILL.md is about 2.6k 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 Citation management and Local SEO. It works with Model Context Protocol. 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 gap analysis
  • Managed citation building
  • Review generation campaigns
  • Local rank tracking

Example prompts

  • “Whitespark,”
  • “citation finder,”
  • “where are my competitors listed,”
  • “/whitespark-tool”

Workflow steps

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

  1. Run Local Citation Finder for target business AND 2-3 competitors
  2. Compare citation sources across all businesses
  3. Identify directories where competitors appear but user doesn't

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

    Links to these hosts (documentation or services it may open):

    • lrg.whitespark.ca
    • whitespark-api.apidocumentation.com

    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

Whitespark Tool loads about 2.6k tokens when it runs. Until then it costs about 98 tokens; SKILL.md has 1,299 words of instructions outside code blocks.

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

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). 1,299 words, ~2,586 tokens.

Download SKILL.mdSave it as .claude/skills/whitespark-tool/SKILL.md (or your agent's skills folder).
name
whitespark-tool
description
When the user wants citation gap analysis, managed citation building, review generation campaigns, or local rank tracking. Trigger on "Whitespark," "citation finder," "where are my competitors listed," "citation gap," "build citations," "review generation tool," or "get more reviews." Note that Whitespark does NOT have an MCP server — it's dashboard-driven with limited API.
metadata.version
1.1.0
metadata.author
Garrett Smith

Whitespark Tool

Note: Local SEO Data (localseodata-tool) now covers citation audits via citation_audit. Use Local SEO Data as default for citation data. Whitespark remains a preferred tool for citation building, rank tracking, and review generation campaigns (Reputation Builder).

Whitespark does NOT have an MCP server. Two of its products now expose REST APIs — the Local Rank Tracker and Local Ranking Grids (geogrids), both in beta — so an agent can pull ranking and grid data directly for those. Its citation products have no API and remain dashboard/managed, so for citations the agent's role is to guide what to do in Whitespark and interpret data the user provides. See the Whitespark APIs section below.

When to Use Whitespark vs Other Tools

You NeedUse WhitesparkUse Instead
Citation gap analysis (competitor vs you)✅ Local Citation FinderBrightLocal (also does this, has MCP)
Managed citation building (done-for-you)✅ Best quality serviceBrightLocal (also offers this)
Review generation campaigns (email/SMS)✅ Reputation Builder—
Review monitoring✅BrightLocal (has MCP, may be better for agent access)
Local rank tracking✅Local SEO Data, Local Falcon (geogrid is superior for local)
Citation accuracy audit⚠️ Can do itBrightLocal (better for NAP accuracy scoring)
Keyword research❌Local SEO Data, Semrush, Ahrefs
Backlink analysis❌Local SEO Data, Ahrefs
Technical audit❌Screaming Frog
Geogrid rankings✅Local SEO Data, Local Falcon

Whitespark vs BrightLocal

These two overlap significantly. Here's when to use which:

FeatureWhitesparkBrightLocal
Citation building quality✅ Higher quality (manual review)Good but more automated
Citation gap finder✅ More thorough✅ Also good
NAP accuracy scoringBasic✅ Better scoring system
MCP server available❌ No✅ Yes
Review generation✅ Reputation Builder✅ Also has this
White-label reportsBasic✅ Better reporting
Industry reputation✅ Citation specialists✅ All-in-one local SEO
PricingPer-serviceSubscription

Recommendation: If MCP connectivity matters (agent can pull data directly), use BrightLocal. If citation building quality is the priority and the user is willing to use the dashboard, Whitespark's managed service is excellent.

Core Workflows

Citation Gap Analysis

When: User wants to find directories where competitors are listed but they aren't.

What to do in Whitespark:

  1. Run Local Citation Finder for target business AND 2-3 competitors
  2. Compare citation sources across all businesses
  3. Identify directories where competitors appear but user doesn't

What the agent can do:

  • Guide the user on which competitors to check
  • Interpret the citation gap report when the user shares results
  • Prioritize which directories to target first

Citation priority framework:

  1. Tier 1 (must-have): Google, Apple, Bing, Yelp, Facebook, data aggregators
  2. Tier 2 (important): Industry-specific directories (Healthgrades, Avvo, Angi, etc.)
  3. Tier 3 (nice-to-have): Local directories, chamber of commerce, BBB
  4. Tier 4 (low priority): General web directories, niche sites
Managed Citation Building

When: Citation gaps identified and user wants help building them.

What Whitespark does:

  • Manual submission to directories (higher quality than automated tools)
  • Verification that listings are live and accurate
  • Ongoing maintenance options

What to tell the user:

  1. Provide exact NAP (must match GBP)
  2. Provide business description, categories, photos
  3. Specify target directories from the gap analysis
  4. Expect 2-4 week turnaround for most directories
  5. Re-audit in 6-8 weeks to verify everything is live and accurate
Review Generation (Reputation Builder)

When: User needs to systematically generate more Google reviews.

How Reputation Builder works:

  • Import customer list (email or phone)
  • Send automated review request via email or SMS
  • Directs happy customers to Google review page
  • Tracks who received requests, who left reviews

What the agent should guide:

  1. Timing: Send review requests 1-3 days after service completion
  2. Message: Keep it short, personal, include direct Google review link
  3. Volume: Steady stream (5-10/week) is better than burst of 50
  4. Filtering: Don't send to known unhappy customers (avoid negative reviews)
  5. Compliance: Don't incentivize reviews, don't gate (filter based on rating)

Review velocity targets by business type:

Business TypeMonthly Review TargetRationale
Restaurant15-30High transaction volume
Medical practice8-15Moderate patient volume
Home services5-10Lower transaction frequency
Legal3-5Fewer clients, harder to ask
B2B services2-4Low volume, high value
Local Rank Tracking

When: User uses Whitespark's rank tracker.

Whitespark's rank tracker is point-based (single location), not geogrid.

What the agent should know:

  • This shows ranking at ONE point for a keyword — not geographic coverage
  • For local businesses, Local Falcon geogrid is far more useful
  • Whitespark rank tracking is fine for organic keyword tracking alongside geogrid

Whitespark APIs

Two Whitespark products expose REST APIs. Both are beta — endpoints and response shapes may change — and neither is an MCP server, so calls are made directly or via a custom integration, not through an agent connector. There is no citation API; citation building and audits stay in the dashboard/managed service.

For citation data, LocalSEOData (citation_audit) is the default. For geogrid depth beyond what the grids API exposes, LocalSEOData (geogrid_scan) or Local Falcon give point-level data.

Show full SKILL.md (498 more words)Show less
Local Ranking Grids (Geogrid) API

Reference: https://lrg.whitespark.ca/api-docs

Built for reporting integration — pulling grid summaries and embedding grid visuals into reports/dashboards. It does not expose the underlying grid data points.

Auth: Bearer token in the Authorization header. Generate the token in-app under profile dropdown → API Access.

Endpoints:

  • GET /grids — paginated list of your ranking grids with summary metrics: visibility score, average rank, and review score. Pagination via page (default 1) and per_page (default 50, max 100). Response is data plus a meta object (current_page, last_page, per_page, total).
  • GET /grid/{grid_id}/download-screenshot/{mode} — returns the most recent screenshot for a grid; mode is with-metrics or without-metrics. grid_id is the UUID from the grid's URL. Returns 404 if no screenshot exists. Embeddable via <img>. Enable Automatic screenshots on the API access page so every completed scan refreshes this URL.

Not available via the API (dashboard only): individual data points within a grid, competitor data points, creating grids, and modifying grids or run schedules.

Use it for: embedding an always-current geogrid image and pulling visibility score / average rank / review score into a monthly report or portfolio rollup. Don't reach for it when you need per-point rankings or competitor grids — use geogrid_scan (LocalSEOData) or Local Falcon.

Local Rank Tracker API

Reference: https://whitespark-api.apidocumentation.com/rank-tracker-api-reference

Beta (v1.0.0, OpenAPI 3.0.0), with separate live and test base URLs. Auth: API key passed as a header.

Organized around three resource groups:

  • campaigns — list and read rank-tracking campaigns (a campaign is the container for a business's tracked keywords and locations)
  • campaign — operate on a single campaign
  • rankings — pull ranking results for tracked keywords

The underlying tracker covers Google and Bing across Local Pack, Maps, and organic, desktop and mobile, up to 100 positions, with geo-targeting and a weighted Visibility Score. Verify exact paths, parameters, and response schemas in the API reference above — the beta docs are the source of truth, and the "Download OpenAPI Document" link there provides the full schema. Beta questions go to troy@whitespark.ca.

Use it for: automating organic/Local Pack keyword-position and Visibility Score pulls into recurring reports alongside geogrid data. Don't reach for it when geographic coverage matters more than single-point positions — that's what the grids API and geogrid_scan are for.

What to Do Next

What You FoundNext ActionSkill
Citation gaps identifiedBuild missing citations, starting with Tier 1local-citations
Citations built, waiting for propagationWork on other optimization while waiting (4-8 weeks)gbp-optimization, review-management
Review generation campaign runningMonitor velocity and adjust messaging if response rate is lowreview-management
Citation data needs to go in a reportInclude in audit or monthly reportclient-deliverables, local-reporting
Need MCP-accessible citation dataUse BrightLocal insteadbrightlocal-tool
Need grid visuals or summary metrics in a reportPull via the Local Ranking Grids APIlocal-reporting, client-deliverables
Need keyword positions or Visibility Score in a reportPull via the Local Rank Tracker APIlocal-reporting

Default next step: Whitespark's strength is managed citation services. If you need automated, agent-accessible citation data, use BrightLocal. If you need the highest-quality citation building, use Whitespark's managed service.

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

Open the folder on GitHubat commit 405ce20

Compare with similar skills

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

Whitespark Tool compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Whitespark Tool this skillgarrettjsmith/localseoskills121—~2.6kAutomated safety check: PassMIT
Citation Source Gap Finderirinabuht12-oss/marketing-skills4.1k—~601Automated safety check: PassNone
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-table2291 repos~1.5kAutomated safety check: PassMIT

Similar skills

  • Citation Source Gap Finder

    irinabuht12-oss/marketing-skills

    Find the exact pages AI assistants cite when answering questions in your category, and identify which ones you can get into.

    4.1k GitHub stars~601 tokensUpdated 16 days ago
    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 1 repo~1.5k tokens
    Marketing & SEOAuto-check passed
  • SEO Content Audit

    seranking/seo-skills

    E-E-A-T + CITE quality audit for an EXISTING piece of content.

    161 GitHub stars~3k tokensUpdated 3 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.

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

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

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

    garrettjsmith/localseoskills

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

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

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

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

Questions about Whitespark Tool

What does Whitespark Tool do?

When the user wants citation gap analysis, managed citation building, review generation campaigns, or local rank tracking. Whitespark Tool is an agent skill from garrettjsmith/localseoskills. When the user wants citation gap analysis, managed citation building, review generation campaigns, or local rank tracking.

When should I use Whitespark Tool?

Whitespark Tool fits situations like: wants citation gap analysis; managed citation building; review generation campaigns; local rank tracking.

How do I install Whitespark Tool in Claude Code?

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

How do I install Whitespark Tool in Codex?

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

Can I use Whitespark 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 whitespark-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/whitespark-tool, .gemini/skills/whitespark-tool, .github/skills/whitespark-tool and .opencode/skills/whitespark-tool in your project.

What does Whitespark Tool need to run?

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

Does Whitespark Tool access the network?

SKILL.md names 2 domains. As links in the text: lrg.whitespark.ca and whitespark-api.apidocumentation.com. This is read from the text; nothing was executed.

Is Whitespark 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 Whitespark Tool use?

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

About 2.6k tokens (SKILL.md is roughly 10k 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 Whitespark Tool?

Skills that share tags, products or a category with Whitespark Tool: Citation Source Gap Finder (irinabuht12-oss/marketing-skills, 4.1k 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 Whitespark Tool?

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