Andrew Yim
236be6c580
🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
108 lines
2.7 KiB
Markdown
108 lines
2.7 KiB
Markdown
# 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.
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```markdown
|
|
## 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
|