New: Earn 20% as an AgentAlley affiliate. Share your link and earn on every sale you refer. Join now New: Earn 20% as an affiliate. Join now

Local SEO and Google Business Profile audit: diagnose why

Local SEO & Google Business Profile Audit

by nowork-studio · MIT license · ★ 3,853 on GitHub · updated Sep 24

Local SEO & Google Business Profile Audit cover

Local SEO and Google Business Profile audit: diagnose why a business isn't ranking in the local pack / map results and produce a fix plan. Covers GBP completeness, NAP (name/address/phone) consistency across the site and citations,…

---
name: local-seo
argument-hint: "<business name or website URL, e.g. https://example.com or 'Dolly Solutions Bangkok'>"
description: >
  Local SEO and Google Business Profile audit: diagnose why a business isn't ranking
  in the local pack / map results and produce a fix plan. Covers GBP completeness,
  NAP (name/address/phone) consistency across the site and citations, local pack and
  "near me" ranking factors, review velocity and responses, local landing pages,
  service-area pages, and LocalBusiness JSON-LD. Use whenever the user asks about
  local rankings, map results, Google Maps ranking, NAP consistency, store/branch
  pages, or multi-location SEO. Trigger on: "local SEO", "Google Business Profile",
  "GBP audit", "rank on Google Maps", "local pack", "map pack", "near me ranking",
  "NAP", "local citations", "my business isn't on the map", "why don't I show up on
  Google Maps", "store locator SEO", "multi-location SEO", "service area pages", or
  any location-based ranking question. For full-site (non-local) audits use
  /seo-analysis; for a single URL use /seo-page.
---

Overview

You are a senior local-SEO strategist. Your job is to find why a business is not winning local-pack / Google Maps visibility for its target locations, and to hand back a concrete, prioritized fix plan.

Manual install (npx, ZIP)
Claude Codenpx skills add nowork-studio/notfair-plugin --skill local-seo -g -a claude-code
Claude Code (manual)mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/nowork-studio/notfair-plugin/tar.gz/5229d2163795 \ | tar -xz -C ~/.claude/skills --strip-components=2 notfair-plugin-5229d2163795/seo/local-seo
Windows (PowerShell)New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/68cff1bf5930e3cdb6b3/local-seo.zip" -OutFile "$env:TEMP\local-seo.zip"; Expand-Archive "$env:TEMP\local-seo.zip" -DestinationPath "$HOME\.claude\skills" -Force
Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md6.6 KB
Read the files here
nowork-studio/5229d211 file
Shared references1SKILL.md reads these from elsewhere in the repo. Not in the ZIP.Get them on GitHub ↗
SKILL.md
Show the full text153 lines

Local SEO & Google Business Profile Audit

You are a senior local-SEO strategist. Your job is to find why a business is not winning local-pack / Google Maps visibility for its target locations, and to hand back a concrete, prioritized fix plan.

Local ranking is driven by three pillars — Relevance, Distance, and Prominence. This skill evaluates the signals the business actually controls (everything except the searcher's physical distance) and turns gaps into actions.

Credit: capability inspired by the open-source claude-seo project (MIT, Agrici Daniel). Implementation is original to NotFair.


Step 0 — Scope the target

Collect, asking only for what's missing:

  • Business website ($SITE_URL) — the canonical domain.
  • Target locations — city/district names the business wants to rank in (e.g. "กรุงเทพฯ, นนทบุรี"). Default to locations found on the site if not given.
  • Primary category — what the business sells (e.g. "ระบบคิว", "ประตูอัตโนมัติ").
  • Single or multi-location? — one storefront vs. many branches vs. service-area business (no walk-in address).

If the user names a business but no URL, ask for the domain — every check below anchors on the live site.


Phase 0 — Preflight & data

Read and follow ../shared/preamble.md for script discovery and GSC auth.

GSC is optional here. If connected, pull queries containing the location names and "near me" to see current local query performance. If not connected, the on-page and schema checks below still run on the live HTML.


Phase 1 — NAP consistency (the #1 silent killer)

Inconsistent Name / Address / Phone across the web suppresses local ranking and confuses Google about which entity to trust.

  1. Crawl the site for every occurrence of the business name, address, and phone (header, footer, contact page, schema). Normalize and compare them.
  2. Flag any mismatch: abbreviations ("ถ." vs "ถนน"), phone format (02-xxx vs +66 2 xxx), suite/floor differences, Thai vs English address.
  3. Confirm the exact same NAP string appears in the LocalBusiness schema, the footer, and the contact page. One canonical format, everywhere.

Output: a NAP table (location | source | value | matches canonical? ✅/❌).


Phase 2 — Google Business Profile completeness

Audit each profile (the user may need to read fields from their GBP dashboard — ask them to paste what's set if you can't see it publicly):

  • Primary category correct and as specific as possible; relevant secondary categories added.
  • Name = real-world business name (no keyword stuffing — that risks suspension).
  • Hours set, including holiday hours; website + booking/LINE links.
  • Description uses target services + locations naturally.
  • Photos: cover, logo, ≥10 recent interior/product/team photos.
  • Products/Services populated with prices where relevant.
  • Q&A seeded; Posts published in the last 30 days.
  • Attributes (e.g. "มีที่จอดรถ", "รับบัตรเครดิต") set.

Score each profile 0–100 on completeness and list the exact empty fields.


Phase 3 — Reviews health

Reviews are a top prominence signal.

  • Quantity & velocity — count and rough rate vs. the top-3 local competitors. A stalled review count (none in 90 days) is a ranking drag.
  • Average rating and distribution.
  • Owner responses — are reviews answered, including negatives? Response rate matters. Flag unanswered negatives as urgent.
  • Keywords in reviews — do reviews mention the service + city? Suggest a (non-incentivized, policy-compliant) ask script in Thai for customers.

Phase 4 — Local landing pages & service-area pages

For multi-location or service-area businesses:

  • Is there a dedicated, indexable page per location/branch with unique content, embedded map, local NAP, and local LocalBusiness schema? (Not one thin page listing all branches.)
  • Service-area pages: unique value per area, not spun duplicates (doorway pages risk a manual action). Check for near-duplicate content across area pages.
  • Internal links from the homepage/menu to each location page.
  • Title/H1 include "{service} {location}" naturally.

Phase 5 — LocalBusiness schema

Validate JSON-LD on the homepage and each location page:

  • Correct @type (LocalBusiness or a specific subtype, e.g. Store, HomeAndConstructionBusiness).
  • name, address (PostalAddress), telephone, geo (lat/lng), openingHoursSpecification, url, image, priceRange, areaServed.
  • sameAs linking the GBP, social, and LINE profiles.
  • aggregateRating only if real, on-site reviews back it (don't fabricate — Google can issue a structured-data manual action).

If schema is missing or thin, hand off to /schema-markup-generator to produce it, or emit a ready-to-paste block here.


Phase 6 — Report

Produce a scored report:

  1. Local Health Score (0–100) with the three-pillar breakdown.
  2. Top 5 fixes, ordered by impact × effort, each with the concrete change.
  3. NAP table and per-profile completeness from Phases 1–2.
  4. 30-day local plan — week-by-week (e.g. W1 fix NAP + schema, W2 GBP photos
    • posts, W3 review ask campaign, W4 location pages).

Keep recommendations falsifiable: state the expected signal each fix improves, so the user can verify it later. Write the report in the user's language (Thai for Thai businesses; English Google/SEO terms kept as-is).

1---
2name: local-seo
3argument-hint: "<business name or website URL, e.g. https://example.com or 'Dolly Solutions Bangkok'>"
4description: >
5 Local SEO and Google Business Profile audit: diagnose why a business isn't ranking
6 in the local pack / map results and produce a fix plan. Covers GBP completeness,
7 NAP (name/address/phone) consistency across the site and citations, local pack and
8 "near me" ranking factors, review velocity and responses, local landing pages,
9 service-area pages, and LocalBusiness JSON-LD. Use whenever the user asks about
10 local rankings, map results, Google Maps ranking, NAP consistency, store/branch
11 pages, or multi-location SEO. Trigger on: "local SEO", "Google Business Profile",
12 "GBP audit", "rank on Google Maps", "local pack", "map pack", "near me ranking",
13 "NAP", "local citations", "my business isn't on the map", "why don't I show up on
14 Google Maps", "store locator SEO", "multi-location SEO", "service area pages", or
15 any location-based ranking question. For full-site (non-local) audits use
16 /seo-analysis; for a single URL use /seo-page.
17---
18 
19# Local SEO & Google Business Profile Audit
20 
21You are a senior local-SEO strategist. Your job is to find why a business is not
22winning local-pack / Google Maps visibility for its target locations, and to hand
23back a concrete, prioritized fix plan.
24 
25Local ranking is driven by three pillars — **Relevance**, **Distance**, and
26**Prominence**. This skill evaluates the signals the business actually controls
27(everything except the searcher's physical distance) and turns gaps into actions.
28 
29> Credit: capability inspired by the open-source `claude-seo` project
30> (MIT, Agrici Daniel). Implementation is original to NotFair.
31 
32---
33 
34## Step 0 — Scope the target
35 
36Collect, asking only for what's missing:
37 
38- **Business website** (`$SITE_URL`) — the canonical domain.
39- **Target locations** — city/district names the business wants to rank in
40 (e.g. "กรุงเทพฯ, นนทบุรี"). Default to locations found on the site if not given.
41- **Primary category** — what the business sells (e.g. "ระบบคิว", "ประตูอัตโนมัติ").
42- **Single or multi-location?** — one storefront vs. many branches vs.
43 service-area business (no walk-in address).
44 
45If the user names a business but no URL, ask for the domain — every check below
46anchors on the live site.
47 
48---
49 
50## Phase 0 — Preflight & data
51 
52Read and follow `../shared/preamble.md` for script discovery and GSC auth.
53 
54GSC is optional here. If connected, pull queries containing the location names and
55"near me" to see current local query performance. If not connected, the on-page
56and schema checks below still run on the live HTML.
57 
58---
59 
60## Phase 1 — NAP consistency (the #1 silent killer)
61 
62Inconsistent Name / Address / Phone across the web suppresses local ranking and
63confuses Google about which entity to trust.
64 
651. Crawl the site for every occurrence of the business name, address, and phone
66 (header, footer, contact page, schema). Normalize and compare them.
672. Flag **any** mismatch: abbreviations ("ถ." vs "ถนน"), phone format
68 (`02-xxx` vs `+66 2 xxx`), suite/floor differences, Thai vs English address.
693. Confirm the **exact same** NAP string appears in the LocalBusiness schema, the
70 footer, and the contact page. One canonical format, everywhere.
71 
72Output: a NAP table (location | source | value | matches canonical? ✅/❌).
73 
74---
75 
76## Phase 2 — Google Business Profile completeness
77 
78Audit each profile (the user may need to read fields from their GBP dashboard —
79ask them to paste what's set if you can't see it publicly):
80 
81- **Primary category** correct and as specific as possible; relevant secondary
82 categories added.
83- **Name** = real-world business name (no keyword stuffing — that risks suspension).
84- **Hours** set, including holiday hours; **website** + **booking/LINE** links.
85- **Description** uses target services + locations naturally.
86- **Photos**: cover, logo, ≥10 recent interior/product/team photos.
87- **Products/Services** populated with prices where relevant.
88- **Q&A** seeded; **Posts** published in the last 30 days.
89- **Attributes** (e.g. "มีที่จอดรถ", "รับบัตรเครดิต") set.
90 
91Score each profile 0–100 on completeness and list the exact empty fields.
92 
93---
94 
95## Phase 3 — Reviews health
96 
97Reviews are a top prominence signal.
98 
99- **Quantity & velocity** — count and rough rate vs. the top-3 local competitors.
100 A stalled review count (none in 90 days) is a ranking drag.
101- **Average rating** and distribution.
102- **Owner responses** — are reviews answered, including negatives? Response rate
103 matters. Flag unanswered negatives as urgent.
104- **Keywords in reviews** — do reviews mention the service + city? Suggest a
105 (non-incentivized, policy-compliant) ask script in Thai for customers.
106 
107---
108 
109## Phase 4 — Local landing pages & service-area pages
110 
111For multi-location or service-area businesses:
112 
113- Is there a **dedicated, indexable page per location/branch** with unique content,
114 embedded map, local NAP, and local LocalBusiness schema? (Not one thin page
115 listing all branches.)
116- **Service-area pages**: unique value per area, not spun duplicates (doorway
117 pages risk a manual action). Check for near-duplicate content across area pages.
118- Internal links from the homepage/menu to each location page.
119- Title/H1 include "{service} {location}" naturally.
120 
121---
122 
123## Phase 5 — LocalBusiness schema
124 
125Validate JSON-LD on the homepage and each location page:
126 
127- Correct `@type` (`LocalBusiness` or a specific subtype, e.g. `Store`,
128 `HomeAndConstructionBusiness`).
129- `name`, `address` (PostalAddress), `telephone`, `geo` (lat/lng),
130 `openingHoursSpecification`, `url`, `image`, `priceRange`, `areaServed`.
131- `sameAs` linking the GBP, social, and LINE profiles.
132- `aggregateRating` only if real, on-site reviews back it (don't fabricate —
133 Google can issue a structured-data manual action).
134 
135If schema is missing or thin, hand off to `/schema-markup-generator` to produce it,
136or emit a ready-to-paste block here.
137 
138---
139 
140## Phase 6 — Report
141 
142Produce a scored report:
143 
1441. **Local Health Score** (0–100) with the three-pillar breakdown.
1452. **Top 5 fixes**, ordered by impact × effort, each with the concrete change.
1463. **NAP table** and **per-profile completeness** from Phases 1–2.
1474. **30-day local plan** — week-by-week (e.g. W1 fix NAP + schema, W2 GBP photos
148 + posts, W3 review ask campaign, W4 location pages).
149 
150Keep recommendations falsifiable: state the expected signal each fix improves, so
151the user can verify it later. Write the report in the user's language (Thai for
152Thai businesses; English Google/SEO terms kept as-is).
153 
View all files on GitHub →

Details

Updated
Sep 24, 2026
License
MIT
Stars on the repo
★ 3,853
Checked
Source
nowork-studio/notfair-plugin ↗
Creator
nowork-studio · 61 listings
View creator

Similar skills

See all →
SkillThe Lighthouse Agentic Browsing fractionAgentic Browsing ReadinessAgriciDaniel/claude-seo · by AgriciDanielAudit and fix agent readiness: the Lighthouse Agentic Browsing fraction, accessibility tree for agents, robots.txt and Content-Signal for AI agents, WAF treatment of agent traffic, llms.txt, Markdown delivery, ai-catalog.json, /.well-known discovery files, and WebMCP tools. Exclude AI citability and brand signals (seo-geo) and commerce protocol depth (seo-ecommerce).★ 17.4k GitHub starsSkillReferring domains, anchor text distributionBacklink Profile AnalysisAgriciDaniel/claude-seo · by AgriciDanielBacklink profile analysis: referring domains, anchor text distribution, toxic link detection, competitor gap analysis. Works with free APIs (Moz, Bing Webmaster, Common Crawl) and DataForSEO extension. Use when user says backlinks, link profile, referring domains, anchor text, toxic links, link gap, link building, disavow, or backlink audit.★ 17.4k GitHub starsSkillConnect a CMS to notfair SEO tools/setup-cmsnowork-studio/notfair-plugin · by nowork-studioConnect a CMS to notfair SEO tools. Guides users through configuring WordPress, Strapi, Contentful, or Ghost — tests the connection, and writes credentials to .env.local. Once set up, seo-analysis automatically cross- references CMS content against Google Search Console data. Use whenever the user says "connect my CMS", "set up WordPress", "configure Strapi", "add Contentful", "connect Ghost", or "CMS setup". Also trigger if the user asks why no CMS data appears in a seo-analysis report.★ 3.9k GitHub starsSkillBacklink profile for any domainBacklink checkRyze-AI-Adgent/open-seo-mcp-skills · by Ryze-AI-AdgentBacklink profile for any domain — referring domains, authority, anchors, new/lost links, and a side-by-side vs a competitor. Use when asked "check my backlinks", "backlink profile of X", "who links to them", or "link gap vs competitor".★ 3.1k GitHub starsSkillOptimize Core Web Vitals for better page experienceCore Web Vitals optimizationaddyosmani/web-quality-skills · by addyosmaniOptimize Core Web Vitals (LCP, INP, CLS) for better page experience using field and lab evidence. Use when asked to "improve Core Web Vitals", "fix LCP", "reduce CLS", "optimize INP", "page experience optimization", or "fix layout shifts".★ 2.8k GitHub starsSkillRun an SEO page observation-action-review loopRun the SEO page looptsingyuai/growth-lab · by tsingyuaiRun an SEO page observation-action-review loop with persistent Memory by coordinating demand research, page creation, adversarial review, image generation, IndexNow submission, and performance review. Use when taking an SEO page from opportunity discovery through publication, measurement, iteration, or continuing a previous SEO loop from Memory.★ 2k GitHub stars

More from nowork-studio

SkillConnect a CMS to notfair SEO tools/setup-cmsnowork-studio/notfair-plugin · by nowork-studioConnect a CMS to notfair SEO tools. Guides users through configuring WordPress, Strapi, Contentful, or Ghost — tests the connection, and writes credentials to .env.local. Once set up, seo-analysis automatically cross- references CMS content against Google Search Console data. Use whenever the user says "connect my CMS", "set up WordPress", "configure Strapi", "add Contentful", "connect Ghost", or "CMS setup". Also trigger if the user asks why no CMS data appears in a seo-analysis report.★ 3.9k GitHub starsSkillGenerate and A/B test Google Ads copyAd Copy Generator + A/B Testernowork-studio/notfair-plugin · by nowork-studioGenerate and A/B test Google Ads copy. Use when asked to write ad copy, headlines, descriptions, create ad variants, test ad messaging, improve CTR, or generate RSA (Responsive Search Ad) components. Trigger on "ad copy", "write ads", "headlines", "descriptions", "RSA", "responsive search ad", "ad text", "ad creative", "improve CTR", "ad A/B test", "ad variants", "write me an ad", "ad variation experiment", or when the user wants to improve click-through rate on existing ads.★ 3.9k GitHub starsSkillPlan and review Amazon Ads with margin-aware ACoS, productAmazon Ads Planningnowork-studio/notfair-plugin · by nowork-studioPlan and review Amazon Ads with margin-aware ACoS, product, and search-term guardrails. Use for Amazon advertising, Sponsored Products, Sponsored Brands, Sponsored Display, ASIN targeting, Amazon ACoS, or Amazon Ads performance exports.★ 3.9k GitHub starsSkillBacklink / Off-Page SEO Auditnowork-studio/notfair-plugin · by nowork-studioBacklink / off-page SEO audit. Works WITHOUT a paid tool by default — it uses the Google Search Console Links report (your top linking sites, most-linked pages, and anchor text) plus any backlink export the user provides (Ahrefs / Semrush / Majestic / DataForSEO CSV). Analyzes referring-domain profile, anchor-text distribution (over-optimized / spammy patterns), most-linked pages vs. money pages (internal-linking opportunity), toxic/spam link signals, and link-building priorities. Use this skill when the user asks about backlinks, link building, off-page SEO, referring domains, anchor text, toxic/spam links, disavow, or their link profile. Trigger on: "backlinks", "backlink audit", "link building", "off- page SEO", "referring domains", "anchor text", "toxic links", "spam links", disavow file", "who links to me", "link profile", "domain authority". NOTE: rich third-party metrics (DR/DA, full link index) require a paid data source; this skill is explicit about what it can and can't see without one.★ 3.9k GitHub starsSkillScans a website to find broken linksBroken link checkernowork-studio/notfair-plugin · by nowork-studioScans a website to find broken links (404s, 500s). Crawls internal pages, identifies broken outbound links, and reports source pages for easy fixing. Use this when the user asks to "check for broken links", "find 404s", audit my links", or "is my site healthy".★ 3.9k GitHub starsSkillPlan and review ChatGPT Ads experiments without assuming adChatGPT Ads Planningnowork-studio/notfair-plugin · by nowork-studioPlan and review ChatGPT Ads experiments without assuming ad inventory, account access, or platform capabilities. Use for ChatGPT advertising, OpenAI ads, conversational ad concepts, ChatGPT campaign plans, or performance reviews from a verified export.★ 3.9k GitHub stars