our-claude-skills/custom-skills/30-seo-gateway-builder/README.md

# Gateway Page Content Builder

A comprehensive Claude Skill for generating SEO-optimized gateway pages for local services, medical practices, and businesses.

## 🎯 Purpose

This skill provides a systematic framework for creating high-quality gateway pages that:
- Target location + service keyword combinations
- Scale content creation while maintaining uniqueness
- Include proper technical SEO elements
- Generate structured data and schema markup

## 📁 Structure

```
gateway-page-content-builder/
├── SKILL.md                    # Main skill documentation (REQUIRED)
├── README.md                    # This file
├── templates/                   # Page templates
│   ├── gateway-page-medical.md
│   ├── gateway-page-beauty.md
│   └── gateway-page-dental.md
├── scripts/                     # Automation scripts
│   ├── generate_pages.py
│   └── keyword_research.py
├── config/                      # Configuration files
│   ├── locations.json
│   ├── services.json
│   └── brand.json
└── examples/                    # Example outputs
    └── gangnam-laser-hair-removal.md
```

## 🚀 Quick Start

### 1. Basic Usage with Claude

Simply ask Claude to use this skill:
```
"Use the Gateway Page Content Builder skill to create a page for laser hair removal in Gangnam"
```

### 2. Batch Generation with Python

```python
from scripts.generate_pages import GatewayPageGenerator, Brand, Location, Service

# Setup your brand
brand = Brand(
    name_en="Your Clinic",
    name_kr="클리닉명",
    website="www.yourclinic.com",
    # ... other details
)

# Define locations and services
locations = [...]  # Your location list
services = [...]   # Your service list

# Generate pages
generator = GatewayPageGenerator(brand)
generator.generate_batch(services, locations)
```

### 3. Using Templates

Templates are in Markdown format with placeholders:
- `[Service]` - Service name
- `[Location]` - Location name
- `[Brand]` - Brand/clinic name
- Additional custom placeholders

## 📝 Content Strategy

### Keyword Formula
```
Primary: [Service] + [Location]
Secondary: [Location] + [Service] + "clinic/center"
Long-tail: "best" + [Service] + "in" + [Location]
```

### Content Uniqueness
Each page should have:
- 30% minimum unique content
- Local landmarks and transportation
- Location-specific testimonials
- Regional statistics or demographics

### Page Length Guidelines
- Minimum: 800 words
- Optimal: 1,200-1,500 words
- Maximum: 2,000 words

## 🎨 Customization

### Adding New Templates

1. Create new template in `templates/` directory
2. Use consistent placeholder naming
3. Include schema markup section
4. Add to configuration

### Extending Services/Locations

Edit the JSON configuration files:

`config/services.json`:
```json
{
  "services": [
    {
      "id": "new-service",
      "name_en": "New Service",
      "name_kr": "새로운 서비스",
      "keywords": ["keyword1", "keyword2"]
    }
  ]
}
```

`config/locations.json`:
```json
{
  "locations": [
    {
      "id": "new-location",
      "name_en": "New Location",
      "name_kr": "새로운 지역",
      "landmarks": ["Landmark 1", "Landmark 2"]
    }
  ]
}
```

## 🔧 Technical Implementation

### URL Structure
```
/[location]/[service]/
Example: /gangnam/laser-hair-removal/
```

### Required Meta Tags
- Title (60 characters max)
- Description (155 characters max)
- Canonical URL
- Open Graph tags
- Schema markup

### Schema Types
- MedicalBusiness
- LocalBusiness
- Service
- Review
- FAQPage

## 📊 Performance Tracking

### Key Metrics
- Organic traffic by page
- Keyword rankings
- Conversion rate
- Bounce rate
- Time on page

### A/B Testing Elements
- Headlines
- CTA buttons
- Trust signals
- Content length

## 🔄 Content Refresh Schedule

- **Weekly**: Review top 10% pages
- **Monthly**: Update testimonials
- **Quarterly**: Refresh statistics
- **Annually**: Full content audit

## 🛠️ Troubleshooting

### Common Issues

1. **Duplicate Content Warnings**
   - Ensure 30% unique content minimum
   - Use content variation patterns
   - Add local elements

2. **Low Rankings**
   - Check keyword density (2-3%)
   - Verify schema markup
   - Add more local signals

3. **Poor Conversion**
   - Test CTA placement
   - Add trust signals
   - Improve page speed

## 📚 Resources

### SEO Tools
- Ahrefs / SEMrush (keyword research)
- Screaming Frog (technical audit)
- Google Search Console (performance)
- Schema.org (structured data)

### Content Tools
- Grammarly (grammar check)
- Hemingway (readability)
- Copyscape (plagiarism)

## 🤝 Contributing

To improve this skill:
1. Test templates with real data
2. Share performance metrics
3. Suggest new features
4. Report issues

## 📄 License

This skill is provided as-is for use with Claude Desktop and Claude Projects.

## 🆘 Support

For questions or assistance:
- Review SKILL.md for detailed documentation
- Check examples/ directory for samples
- Test with the Python script first

---

**Version**: 1.0.0  
**Last Updated**: November 2024  
**Author**: OurDigital Dr.D