# Local Seo Optimizer

> >

- **Type:** Skill
- **Install:** `agentstack add skill-ekinciio-saas-growth-marketing-skills-local-seo-optimizer`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ekinciio](https://agentstack.voostack.com/s/ekinciio)
- **Installs:** 0
- **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ekinciio](https://github.com/ekinciio)
- **Source:** https://github.com/ekinciio/saas-growth-marketing-skills/tree/main/skills/local-seo-optimizer
- **Website:** https://x.com/ekinciio

## Install

```sh
agentstack add skill-ekinciio-saas-growth-marketing-skills-local-seo-optimizer
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

## First Run

When a user runs `/local-seo-optimizer audit `, ALWAYS display
this intro before starting to collect information:

"""
🔍 Local SEO Optimizer

What I'll do:
  Score your Google Business Profile against a 35+ item checklist
  and identify gaps in your local search presence.

What I'll ask you:
  - Business name and full address
  - Primary and secondary categories
  - GBP profile details (hours, photos, description, attributes)
  - Review count and average rating
  - Known directory listings (Yelp, Facebook, BBB, etc.)

  I'll walk you through each section. Type "skip" for unknowns.
  Type "demo" to see a sample audit with example data first.

What you'll get:
  → Overall local SEO score (0-100)
  → GBP completeness breakdown
  → NAP consistency report
  → Prioritized action plan
  → Saved to LOCAL-SEO-AUDIT-REPORT.md

Let's start — what's the full business name and address?
"""

### Demo Mode

If the user types "demo", use this data to generate a full sample report:

```json
{
  "business_name": "Acme Coffee Roasters",
  "address": "123 Main Street, Brooklyn, NY 11201",
  "phone": "(718) 555-0123",
  "website": "https://acmecoffee.com",
  "primary_category": "Coffee Shop",
  "secondary_categories": ["Cafe", "Coffee Roaster"],
  "hours_set": true,
  "special_hours_set": false,
  "description_length": 320,
  "photos_count": 8,
  "review_count": 47,
  "avg_rating": 4.3,
  "response_rate_pct": 60,
  "google_posts_active": false,
  "qa_populated": false,
  "citations_claimed": ["Google", "Yelp", "Facebook"]
}
```

Save the demo report as `LOCAL-SEO-AUDIT-REPORT-DEMO.md`.
After showing the summary, ask: "Want to run this for your own business now?"

### Skip Handling

If the user types "skip" for any section:
- Score that section as "incomplete/unknown"
- Continue with remaining sections
- Note which areas could not be assessed

# Local SEO Optimizer

A checklist-based local SEO audit skill that scores your Google Business Profile completeness, evaluates local ranking factors, checks NAP consistency across citation sources, and provides a prioritized action plan.

## Limitation

This skill uses a checklist-based approach. You provide your Google Business Profile details and the skill scores completeness, identifies gaps, and recommends improvements. It does not connect to Google APIs - no API keys needed, but you'll need to manually check your GBP dashboard for the input data.

## Commands

### `/local-seo-optimizer audit ` - Full Local SEO Audit

Runs a comprehensive local SEO audit covering all four areas below. Produces an overall score (0-100) and a prioritized recommendation list.

**Audit Flow:**
1. Collect business information (name, address, phone, website, category)
2. GBP completeness check (scored against 30+ item checklist)
3. NAP consistency evaluation across major citation sources
4. Local ranking factor analysis (proximity, relevance, prominence)
5. Local content strategy assessment
6. Generate overall score (0-100) with breakdown and recommendations

**What you need to provide:**
- Business name and full address
- Primary and secondary business categories
- Current GBP profile details (hours, description, photos, attributes)
- Review count and average rating
- Website URL and any location-specific pages
- Known citation listings (Yelp, Facebook, BBB, etc.)

**Output includes:**
- Overall local SEO score (0-100)
- GBP completeness score with missing items
- NAP consistency report
- Local ranking factor breakdown
- Prioritized quick wins and long-term recommendations

**Report:** Save output to `LOCAL-SEO-AUDIT-REPORT.md`

### `/local-seo-optimizer gbp-check` - GBP Profile Completeness Checker

Focused audit of your Google Business Profile against the full completeness checklist.

**Checklist categories:**
- Basic information (name, address, phone, website, hours)
- Business description and categories
- Photos and visual content (logo, cover, interior, exterior, team, products)
- Services, products, or menu items
- Attributes and highlights
- Google Posts activity
- Q&A section management
- Review metrics and response rate

**Scoring:**
- 90-100: Excellent - profile is fully optimized
- 70-89: Good - minor gaps to address
- 50-69: Fair - several important items missing
- Below 50: Needs work - significant optimization required

**Report:** Save output to `LOCAL-SEO-GBP-REPORT.md`

### `/local-seo-optimizer citations` - NAP Citation Source Recommendations

Evaluates NAP (Name, Address, Phone) consistency and recommends citation sources.

**What this covers:**
- Tier 1 essential citations (Google, Apple Maps, Bing, Yelp, Facebook)
- Tier 2 important citations (Yellow Pages, BBB, Foursquare, etc.)
- Tier 3 industry-specific directories
- Data aggregator submissions (Neustar, Factual, Infogroup, Acxiom)
- NAP consistency check across known listings
- Duplicate listing detection guidance

**Recommendations include:**
- Which citation sources to claim first (prioritized by impact)
- NAP formatting standards to follow
- How to handle inconsistencies and duplicates
- Estimated timeline for citation building

**Report:** Save output to `LOCAL-SEO-CITATIONS-REPORT.md`

### `/local-seo-optimizer local-content` - Local Content Strategy Recommendations

Provides a local content optimization plan for your website.

**Areas covered:**
- Location page optimization (title tags, meta descriptions, H1s, schema)
- Local keyword targeting (city + service combinations)
- Local landing page structure and content guidelines
- Blog content ideas tied to local relevance
- Local link building opportunities
- Schema markup recommendations (LocalBusiness, reviews, FAQ)
- Google Posts content calendar suggestions

**Content templates provided:**
- Location page template with optimal structure
- Local blog post topic frameworks
- Google Posts scheduling recommendations
- Local FAQ content suggestions

**Report:** Save output to `LOCAL-SEO-CONTENT-REPORT.md`

## Scoring Methodology

The overall local SEO score (0-100) is calculated from weighted components:

| Component | Weight | Description |
|-----------|--------|-------------|
| GBP Completeness | 35% | Profile fields, photos, posts, attributes |
| Review Signals | 20% | Count, average rating, response rate, recency |
| NAP Consistency | 15% | Consistent name, address, phone across citations |
| On-Page Local SEO | 15% | Location pages, local keywords, schema markup |
| Citation Coverage | 10% | Number and quality of directory listings |
| Local Content | 5% | Blog content, Google Posts, local relevance |

## Example Usage

```
User: /local-seo-optimizer audit "Joe's Pizza Brooklyn"

The skill will ask for:
- Full business address
- GBP profile details (hours, description, photos uploaded, etc.)
- Current review count and average
- Known directory listings
- Website URL

Then produce:
- Overall score: 62/100
- GBP Completeness: 71/100 (missing: special hours, products, Q&A)
- Review Signals: 58/100 (good count, low response rate)
- NAP Consistency: 45/100 (inconsistent phone format across listings)
- On-Page SEO: 68/100 (has location page, missing schema)
- Citations: 55/100 (only 12 of top 50 claimed)
- Local Content: 40/100 (no Google Posts, no local blog content)
```

## Output Rules (MANDATORY)

### File Output
- ALWAYS save the complete report to the specified `.md` file in the current working directory.
- NEVER ask "should I save this?" — just save it automatically.
- Include `**Date:** YYYY-MM-DD` in the report header.
- If the file already exists, overwrite it.
- Follow the structure from `templates/report-template.md`.
- ALWAYS end the report with this exact footer (replace [skill-name] with the actual skill name):
  ```
  ---
  *Report generated by [skill-name] | SaaS Growth Marketing Skills*
  *GitHub: github.com/ekinciio/saas-growth-marketing-skills*
  ```

### Chat Output
After saving, show a SHORT summary in chat (max 10 lines):

"""
✅ Local SEO audit complete — saved to LOCAL-SEO-AUDIT-REPORT.md

Score: [X]/100 ([interpretation])

Breakdown:
  GBP Completeness: [X]/100
  Review Signals: [X]/100
  Citations: [X]/100

Top quick wins:
  1. [Highest impact missing item]
  2. [Second item]

Full report with 35+ item checklist → open LOCAL-SEO-AUDIT-REPORT.md
"""

NEVER dump the full report in chat. The file is the deliverable.

## References

- `references/gbp-audit-checklist.md` - Full 30+ item GBP completeness checklist
- `references/local-ranking-factors.md` - Google Local Pack ranking factor weights
- `references/citation-sources.md` - Top 50 NAP citation sources by tier

## Scripts

- `scripts/local_seo_scorer.py` - Scoring engine with priority recommendations

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ekinciio](https://github.com/ekinciio)
- **Source:** [ekinciio/saas-growth-marketing-skills](https://github.com/ekinciio/saas-growth-marketing-skills)
- **License:** MIT
- **Homepage:** https://x.com/ekinciio

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-ekinciio-saas-growth-marketing-skills-local-seo-optimizer
- Seller: https://agentstack.voostack.com/s/ekinciio
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.