Andrew Yim
eea49f9f8c
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>
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
|