| name | programmatic-seo-builder |
| description | Create scalable programmatic SEO page templates with title patterns, internal linking logic, schema markup, and thin content avoidance strategies. Use when given a niche and data source to build page templates, establishing programmatic SEO structure, or scaling content production with templates. Platform: Google. |
Programmatic SEO Builder
Design scalable page templates that rank without appearing thin or auto-generated.
Process
- Define page type - Location, comparison, directory, definition, converter
- Create title pattern - Keyword + modifier formula
- Design page template - Sections, variable content, unique elements
- Plan internal linking - Hub and spoke model
- Specify schema markup - Appropriate JSON-LD
- Add uniqueness requirements - Avoid thin content penalties
Common Programmatic Page Types
| Type | URL Pattern | Example |
|---|
| Location | /[service]-in-[city] | /plumber-in-austin |
| Comparison | /[product-a]-vs-[product-b] | /notion-vs-airtable |
| Directory | /best-[category]-for-[use-case] | /best-crm-for-startups |
| Definition | /what-is-[term] | /what-is-seo |
| Converter | /[x]-to-[y]-converter | /usd-to-eur-converter |
Title Tag Formulas
| Pattern | Template | Example |
|---|
| Local service | [Service] in [City] - [Brand] | "Personal Injury Lawyer in Phoenix - Smith Law" |
| Best + Year | Best [Category] [Year] - [Brand] | "Best CRM Software 2025 - TechReview" |
| Comparison | [Product A] vs [Product B]: [Year] Comparison | "Notion vs Airtable: 2025 Comparison" |
| How to | How to [Action] + [Modifier] | "How to Convert PDF to Word Free" |
| Definition | What is [Term]? Definition + [Examples/Guide] | "What is SEO? Definition + Complete Guide" |
Internal Linking: Hub & Spoke Model
Hub Page: "Marketing Tools" (comprehensive guide)
│
├── Spoke: "Email Marketing Tools"
│ └── Links to: Hub, SEO Tools, Social Tools
│
├── Spoke: "SEO Tools"
│ └── Links to: Hub, Email Tools, Analytics Tools
│
├── Spoke: "Social Media Tools"
│ └── Links to: Hub, Email Tools, Content Tools
│
└── Each spoke links to:
• Parent hub (always)
• 2-3 related spokes (contextually)
• Relevant comparison pages
Schema Markup Requirements
| Page Type | Schema | Required Properties |
|---|
| Location | LocalBusiness | name, address, telephone, openingHours |
| Comparison | Product (multiple) | name, description, review, aggregateRating |
| Directory | ItemList | itemListElement[], numberOfItems |
| Definition | FAQPage or Article | mainEntity (FAQ) or headline, author (Article) |
| Converter | WebApplication | name, applicationCategory, offers |
Always include: BreadcrumbList for navigation structure
Thin Content Avoidance
Minimum Requirements
- Word count: 300-500 words unique content per page
- Unique sections: 2-3 sections beyond templated structure
- Intent match: Specific answer to the search query
- Variable depth: Context added, not just name-swapping
What Makes Pages Thin (Avoid)
- Only swapping city/product names in identical text
- No unique insights or local/specific information
- Template visible through multiple pages
- No added value beyond what database provides
What Makes Pages Valuable (Do)
- Unique introductions per page variant
- Specific data points (local stats, product specs)
- Custom recommendations based on variant
- User-generated content where appropriate
- FAQ section with variant-specific questions
Output Format
## Programmatic SEO Specification
### Page Type Overview
- **Type**: [Location/Comparison/Directory/etc.]
- **URL Pattern**: /[pattern]
- **Target Keywords**: [X] pages targeting [keyword pattern]
- **Data Source**: [Where variable data comes from]
### Title Tag Template
[Template with variables]
**Examples**:
- [Example 1]
- [Example 2]
### Meta Description Template
[Template with variables]
### Page Template Structure
#### Section 1: [Header]
- **Content type**: [Static/Variable/Mixed]
- **Requirements**: [Specifications]
#### Section 2: [Header]
...
### Internal Linking Rules
- **Hub page**: [URL]
- **Link to hub**: [Where in template]
- **Related spokes**: [Logic for selection]
- **Contextual links**: [Placement rules]
### Schema Markup (JSON-LD)
```json
{
"@context": "https://schema.org",
"@type": "[Type]",
...
}
Uniqueness Requirements
Thin Content Safeguards
- Minimum word count: [X]
- Required unique sections: [List]
- Variable content depth: [Specifications]
Example Page
URL: [Example URL]
Title: [Example title]
H1: [Example H1]
[Brief content outline]
## Example
**Input**: "Build programmatic SEO template for 'best [software] for [industry]' pages. Data source is a database of 50 software tools and 20 industries."
**Output**:
Programmatic SEO Specification
Page Type Overview
- Type: Directory/Recommendation
- URL Pattern: /best-[software-category]-for-[industry]
- Target Keywords: 1,000 pages (50 tools × 20 industries)
- Data Source: Software database + industry requirements mapping
Title Tag Template
Best [Software Category] for [Industry] ([Year]) | [Brand]
Examples:
- Best CRM Software for Real Estate (2025) | TechReview
- Best Project Management Tools for Agencies (2025) | TechReview
Meta Description Template
Discover the best [software] for [industry] in [year]. Compare top [X] options with pricing, features, and expert recommendations for [industry] professionals.
Page Template Structure
Section 1: Introduction (Variable)
- Content type: Variable - industry-specific
- Requirements: 100-150 words addressing why [industry] needs specialized [software], unique challenges
Section 2: Quick Picks Summary (Variable)
- Content type: Variable based on industry fit scores
- Requirements: Top 3 picks with one-line reasoning, links to full reviews
Section 3: Detailed Recommendations (Variable)
- Content type: Mixed - template structure, variable content
- Requirements:
- 5-7 tools per page
- Each tool: 150-200 words
- Industry-specific use case for each
- Pricing with industry discount notes
- Pros/cons relevant to industry workflow
Section 4: How We Evaluated (Static)
- Content type: Static
- Requirements: Methodology transparency, criteria list
Section 5: Industry-Specific Buying Guide (Variable)
- Content type: Variable
- Requirements: 200-300 words on considerations specific to [industry]
Section 6: FAQ (Variable)
- Content type: Variable - 5 questions per page
- Requirements: Industry + software specific questions
Internal Linking Rules
- Hub page: /best-software-tools/
- Link to hub: In introduction and footer
- Related spokes: Link to same-industry different-software and same-software different-industry
- Contextual links: Individual tool review pages
Schema Markup
{
"@context": "https://schema.org",
"@type": "ItemList",
"name": "Best [Software] for [Industry]",
"numberOfItems": 7,
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"item": {
"@type": "Product",
"name": "[Tool Name]",
"description": "[Industry-specific description]"
}
}
]
}
Uniqueness Requirements
Thin Content Safeguards
- Minimum word count: 1,500 words
- Required unique sections: Introduction, Buying Guide, FAQ
- Each tool must have industry-specific recommendation paragraph
## Guidelines
- Always include thin content safeguards
- Schema must match page type
- Internal linking logic must be systematic
- Provide actual template structure, not just concepts
- If data source unclear, ask before proceeding
- Flag if proposed scale risks quality issues
## Data access (Ryze MCP)
This skill works best with live account data. Connect the free Ryze MCP once and Claude reads your Google Ads, Meta Ads, GA4 and Search Console directly:
- claude.ai / Claude Desktop: Settings → Connectors → Add custom connector → `https://connector.get-ryze.ai/mcp`
- Claude Code: `claude mcp add ryze --transport http https://connector.get-ryze.ai/mcp`
- Cursor: Settings → MCP → add the same URL
Setup guide: https://www.get-ryze.ai/how-to-connect-claude-to-google-meta-ads-mcp
