local-seo-optimizer

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.

First Run

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

""" 🔍 Local SEO Optimizer

What I'll do: Score your Google Business Profile against a 41-item checklist (31 factors scored by the script) 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. It matches the scorer's input shape (GBP checklist item ids scored 0=missing/1=partial/2=complete, plus the run_full_audit keyword arguments), so it can be saved to a file and passed straight to python3 scripts/local_seo_scorer.py <file>:

{
  "business_info": {
    "name": "Acme Coffee Roasters",
    "address": "123 Main Street, Brooklyn, NY 11201",
    "phone": "(718) 555-0123",
    "website": "https://acmecoffee.com"
  },
  "gbp_responses": {
    "business_name": 2, "primary_category": 2, "secondary_categories": 2,
    "address_verified": 2, "phone_number": 2, "website_url": 2,
    "business_hours": 2, "special_hours": 0, "description_written": 1,
    "description_keywords": 1, "description_location": 1,
    "logo_uploaded": 2, "cover_photo": 2, "interior_photos": 1,
    "exterior_photos": 1, "team_photos": 0, "product_photos": 1,
    "photos_recent": 0, "services_listed": 1, "products_added": 0,
    "attributes_set": 1, "highlights_selected": 0,
    "posts_regular": 0, "posts_with_images": 0, "posts_with_cta": 0,
    "review_count_target": 1, "average_rating": 2,
    "review_response_rate": 1, "negative_review_responses": 1,
    "messaging_enabled": 0, "messages_answered": 0
  },
  "review_data": {
    "review_count": 47, "average_rating": 4.3, "response_rate": 60,
    "recent_reviews_30d": 3, "industry_target": 100
  },
  "nap_data": {
    "total_citations": 3, "consistent_citations": 3, "has_duplicates": false
  },
  "on_page_data": {
    "has_nap_on_site": true, "has_location_pages": false,
    "has_local_schema": false, "has_local_keywords_titles": false,
    "is_mobile_friendly": true, "page_speed_score": 70
  },
  "citation_data": {
    "tier1_claimed": 3, "tier2_claimed": 0, "tier3_claimed": 0,
    "aggregators_submitted": 0
  },
  "content_data": {
    "has_google_posts_weekly": false, "has_local_blog_content": false,
    "has_local_landing_pages": false, "has_faq_content": false,
    "has_event_posts": false
  }
}