Restructure skill numbering: SEO 11-30, GTM 60-69, reserve 19-28 for future skills
Renumber 12 existing skills to new ranges: - SEO: 11→13, 12→18, 13→16, 14→17, 15→14, 16→15, 17→29, 18→30, 19→12 - GTM: 20→60, 21→61, 22→62 Update cross-references in gateway architect/builder skills, GTM guardian README, CLAUDE.md (skill tables + directory layout), and AGENTS.md (domain routing ranges). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
142
custom-skills/18-seo-local-audit/code/CLAUDE.md
Normal file
142
custom-skills/18-seo-local-audit/code/CLAUDE.md
Normal file
@@ -0,0 +1,142 @@
|
||||
# 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": {...}}'
|
||||
```
|
||||
|
||||
125
custom-skills/18-seo-local-audit/desktop/SKILL.md
Normal file
125
custom-skills/18-seo-local-audit/desktop/SKILL.md
Normal file
@@ -0,0 +1,125 @@
|
||||
---
|
||||
name: seo-local-audit
|
||||
description: |
|
||||
Local business SEO auditor for NAP consistency, Google Business Profile, and citations.
|
||||
Triggers: local SEO, NAP audit, Google Business Profile, GBP optimization, local citations.
|
||||
---
|
||||
|
||||
# SEO Local Audit
|
||||
|
||||
## Purpose
|
||||
|
||||
Audit local business SEO: NAP (Name, Address, Phone) consistency, Google Business Profile optimization, local citations, and LocalBusiness schema markup.
|
||||
|
||||
## Core Capabilities
|
||||
|
||||
1. **NAP Consistency** - Cross-platform verification
|
||||
2. **GBP Optimization** - Profile completeness check
|
||||
3. **Citation Audit** - Directory presence
|
||||
4. **Schema Validation** - LocalBusiness markup
|
||||
|
||||
## MCP Tool Usage
|
||||
|
||||
```
|
||||
mcp__firecrawl__scrape: Extract NAP from website
|
||||
mcp__perplexity__search: Find citations and directories
|
||||
mcp__notion__create-page: Save audit findings
|
||||
```
|
||||
|
||||
## Workflow
|
||||
|
||||
### 1. Gather Business Info
|
||||
Collect from client:
|
||||
- Business name (exact)
|
||||
- Full address
|
||||
- Phone number (local preferred)
|
||||
- Website URL
|
||||
- GBP listing URL
|
||||
|
||||
### 2. Website NAP Check
|
||||
Scrape website for NAP mentions:
|
||||
- Header/footer
|
||||
- Contact page
|
||||
- About page
|
||||
- Schema markup
|
||||
|
||||
### 3. Citation Discovery
|
||||
Search for business mentions:
|
||||
- "[Business Name] [City]"
|
||||
- Phone number search
|
||||
- Address search
|
||||
|
||||
### 4. GBP Review
|
||||
Manual checklist:
|
||||
- Profile completeness
|
||||
- Category accuracy
|
||||
- Photo presence
|
||||
- Review responses
|
||||
- Post recency
|
||||
|
||||
### 5. Schema Check
|
||||
Validate LocalBusiness markup presence and accuracy.
|
||||
|
||||
## GBP Optimization Checklist
|
||||
|
||||
- [ ] Business name matches website
|
||||
- [ ] Complete address with suite/unit
|
||||
- [ ] Local phone number (not toll-free)
|
||||
- [ ] Accurate business hours
|
||||
- [ ] Primary + secondary categories set
|
||||
- [ ] Business description complete
|
||||
- [ ] 10+ photos uploaded
|
||||
- [ ] Recent post (within 7 days)
|
||||
- [ ] Reviews responded to
|
||||
|
||||
## Citation Priority
|
||||
|
||||
| Platform | Priority |
|
||||
|----------|----------|
|
||||
| Google Business Profile | Critical |
|
||||
| Apple Maps | High |
|
||||
| Bing Places | High |
|
||||
| Yelp | High |
|
||||
| Facebook | Medium |
|
||||
| Industry directories | Medium |
|
||||
|
||||
## Output Format
|
||||
|
||||
```markdown
|
||||
## Local SEO Audit: [Business]
|
||||
|
||||
### NAP Consistency: X/10
|
||||
| Source | Name | Address | Phone |
|
||||
|--------|------|---------|-------|
|
||||
| Website | ✓/✗ | ✓/✗ | ✓/✗ |
|
||||
| GBP | ✓/✗ | ✓/✗ | ✓/✗ |
|
||||
|
||||
### GBP Score: X/10
|
||||
[Checklist results]
|
||||
|
||||
### Citations Found: X
|
||||
- Consistent: X
|
||||
- Inconsistent: X
|
||||
|
||||
### LocalBusiness Schema
|
||||
- Present: Yes/No
|
||||
- Valid: Yes/No
|
||||
|
||||
### Priority Actions
|
||||
1. [Fix recommendations]
|
||||
```
|
||||
|
||||
## Limitations
|
||||
|
||||
- GBP data requires manual access
|
||||
- Citation discovery limited to searchable sources
|
||||
- Cannot update external directories
|
||||
|
||||
## Notion Output (Required)
|
||||
|
||||
All audit reports MUST be saved to OurDigital SEO Audit Log:
|
||||
- **Database ID**: `2c8581e5-8a1e-8035-880b-e38cefc2f3ef`
|
||||
- **Properties**: Issue (title), Site (url), Category, Priority, Found Date, Audit ID
|
||||
- **Language**: Korean with English technical terms
|
||||
- **Audit ID Format**: [TYPE]-YYYYMMDD-NNN
|
||||
|
||||
13
custom-skills/18-seo-local-audit/desktop/skill.yaml
Normal file
13
custom-skills/18-seo-local-audit/desktop/skill.yaml
Normal file
@@ -0,0 +1,13 @@
|
||||
# Skill metadata (extracted from SKILL.md frontmatter)
|
||||
|
||||
name: seo-local-audit
|
||||
description: |
|
||||
Local SEO auditor for NAP consistency, Google Business Profile, citations, and LocalBusiness schema. Triggers: local SEO, Google Business Profile, GBP, NAP, citations, local rankings.
|
||||
|
||||
# Optional fields
|
||||
allowed-tools:
|
||||
- mcp__firecrawl__*
|
||||
- mcp__perplexity__*
|
||||
- mcp__notion__*
|
||||
|
||||
# triggers: [] # TODO: Extract from description
|
||||
15
custom-skills/18-seo-local-audit/desktop/tools/firecrawl.md
Normal file
15
custom-skills/18-seo-local-audit/desktop/tools/firecrawl.md
Normal file
@@ -0,0 +1,15 @@
|
||||
# Firecrawl
|
||||
|
||||
> TODO: Document tool usage for this skill
|
||||
|
||||
## Available Commands
|
||||
|
||||
- [ ] List commands
|
||||
|
||||
## Configuration
|
||||
|
||||
- [ ] Add configuration details
|
||||
|
||||
## Examples
|
||||
|
||||
- [ ] Add usage examples
|
||||
15
custom-skills/18-seo-local-audit/desktop/tools/notion.md
Normal file
15
custom-skills/18-seo-local-audit/desktop/tools/notion.md
Normal file
@@ -0,0 +1,15 @@
|
||||
# Notion
|
||||
|
||||
> TODO: Document tool usage for this skill
|
||||
|
||||
## Available Commands
|
||||
|
||||
- [ ] List commands
|
||||
|
||||
## Configuration
|
||||
|
||||
- [ ] Add configuration details
|
||||
|
||||
## Examples
|
||||
|
||||
- [ ] Add usage examples
|
||||
15
custom-skills/18-seo-local-audit/desktop/tools/perplexity.md
Normal file
15
custom-skills/18-seo-local-audit/desktop/tools/perplexity.md
Normal file
@@ -0,0 +1,15 @@
|
||||
# Perplexity
|
||||
|
||||
> TODO: Document tool usage for this skill
|
||||
|
||||
## Available Commands
|
||||
|
||||
- [ ] List commands
|
||||
|
||||
## Configuration
|
||||
|
||||
- [ ] Add configuration details
|
||||
|
||||
## Examples
|
||||
|
||||
- [ ] Add usage examples
|
||||
Reference in New Issue
Block a user