Files
our-claude-skills/ourdigital-custom-skills/12-seo-local-audit/code/CLAUDE.md
Andrew Yim eea49f9f8c refactor(skills): Restructure skills to dual-platform architecture
Major refactoring of ourdigital-custom-skills with new numbering system:

## Structure Changes
- Each skill now has code/ (Claude Code) and desktop/ (Claude Desktop) versions
- New progressive numbering: 01-09 General, 10-19 SEO, 20-29 GTM, 30-39 OurDigital, 40-49 Jamie

## Skill Reorganization
- 01-notion-organizer (from 02)
- 10-18: SEO tools split into focused skills (technical, on-page, local, schema, vitals, gsc, gateway)
- 20-21: GTM audit and manager
- 30-32: OurDigital designer, research, presentation
- 40-41: Jamie brand editor and audit

## New Files
- .claude/commands/: Slash command definitions for all skills
- CLAUDE.md: Updated with new skill structure documentation
- REFACTORING_PLAN.md: Migration documentation
- COMPATIBILITY_REPORT.md, SKILLS_COMPARISON.md: Analysis docs

## Removed
- Old skill directories (02-05, 10-14, 20-21 old numbering)
- Consolidated into new structure with _archive/ for reference

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-22 01:58:24 +09:00

2.7 KiB

CLAUDE.md

Overview

Local SEO auditor for businesses with physical locations: NAP consistency, Google Business Profile optimization, local citations, and LocalBusiness schema validation.

Quick Start

This skill primarily uses MCP tools (Firecrawl, Perplexity) for data collection. Scripts are helpers for validation.

# NAP consistency check (manual data input)
python scripts/nap_checker.py --business "Business Name" --address "123 Main St" --phone "555-1234"

# LocalBusiness schema validation
python scripts/local_schema_validator.py --url https://example.com

Audit Components

1. NAP Consistency

Name, Address, Phone consistency across:

  • Website (header, footer, contact page)
  • Google Business Profile
  • Local directories (Yelp, Yellow Pages, etc.)
  • Social media profiles

2. Google Business Profile (GBP)

Optimization checklist:

  • Business name matches website
  • Address is complete and accurate
  • Phone number is local
  • Business hours are current
  • Categories are appropriate
  • Photos uploaded (exterior, interior, products)
  • Posts are recent (within 7 days)
  • Reviews are responded to

3. Local Citations

Priority directories to check:

  • Google Business Profile
  • Apple Maps
  • Bing Places
  • Yelp
  • Facebook Business
  • Industry-specific directories

4. LocalBusiness Schema

Required properties:

  • @type (LocalBusiness or subtype)
  • name
  • address (PostalAddress)
  • telephone
  • openingHours

Workflow

1. Collect NAP from client
2. Scrape website for NAP mentions
3. Search citations using Perplexity
4. Check GBP data (manual or API)
5. Validate LocalBusiness schema
6. Generate consistency report

Output Format

## Local SEO Audit: [Business Name]

### NAP Consistency Score: X/10

| Source | Name | Address | Phone | Status |
|--------|------|---------|-------|--------|
| Website | ✓ | ✓ | ✓ | Match |
| GBP | ✓ | ✗ | ✓ | Mismatch |

### GBP Optimization: X/10
- [ ] Issue 1
- [x] Completed item

### Citation Audit
- Found: X citations
- Consistent: X
- Needs update: X

### Recommendations
1. Fix address mismatch on GBP
2. Add LocalBusiness schema

Common Issues

Issue Impact Fix
NAP inconsistency High Update all directories
Missing GBP categories Medium Add relevant categories
No LocalBusiness schema Medium Add JSON-LD markup
Outdated business hours Medium Update GBP hours
No review responses Low Respond to all reviews

Notes

  • GBP API requires enterprise approval (use manual audit)
  • Citation discovery limited to public data
  • Use schema generator skill (14) for creating LocalBusiness markup