Andrew Yim
f0a1453918
All SEO (10-18) and GTM (20-21) skills now require saving reports to: - Database: OurDigital SEO Audit Log (2c8581e5-8a1e-8035-880b-e38cefc2f3ef) - Format: Korean content with English technical terms - Audit ID: [TYPE]-YYYYMMDD-NNN Updated files: - 9 SEO skills (code/CLAUDE.md + desktop/SKILL.md) - 2 GTM skills (code/CLAUDE.md + desktop/SKILL.md) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
143 lines
3.8 KiB
Markdown
143 lines
3.8 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
|
|
|
|
## Notion Output (Required)
|
|
|
|
**IMPORTANT**: All audit reports MUST be saved to the OurDigital SEO Audit Log database.
|
|
|
|
### Database Configuration
|
|
|
|
| Field | Value |
|
|
|-------|-------|
|
|
| Database ID | `2c8581e5-8a1e-8035-880b-e38cefc2f3ef` |
|
|
| URL | https://www.notion.so/dintelligence/2c8581e58a1e8035880be38cefc2f3ef |
|
|
|
|
### Required Properties
|
|
|
|
| Property | Type | Description |
|
|
|----------|------|-------------|
|
|
| Issue | Title | Report title (Korean + date) |
|
|
| Site | URL | Audited website URL |
|
|
| Category | Select | Technical SEO, On-page SEO, Performance, Schema/Structured Data, Sitemap, Robots.txt, Content, Local SEO |
|
|
| Priority | Select | Critical, High, Medium, Low |
|
|
| Found Date | Date | Audit date (YYYY-MM-DD) |
|
|
| Audit ID | Rich Text | Format: [TYPE]-YYYYMMDD-NNN |
|
|
|
|
### Language Guidelines
|
|
|
|
- Report content in Korean (한국어)
|
|
- Keep technical English terms as-is (e.g., SEO Audit, Core Web Vitals, Schema Markup)
|
|
- URLs and code remain unchanged
|
|
|
|
### Example MCP Call
|
|
|
|
```bash
|
|
mcp-cli call notion/API-post-page '{"parent": {"database_id": "2c8581e5-8a1e-8035-880b-e38cefc2f3ef"}, "properties": {...}}'
|
|
```
|
|
|