content-seo-optimizer

name	content-seo-optimizer
description	Analyze and optimize content for SEO with a 0-100 scoring rubric, platform-specific rules, and actionable improvement priorities. Triggers on "optimize for SEO", "SEO score", "check SEO", "audit content", "improve search ranking".
license	MIT
metadata	{"author":"genfeedai","version":"1.0.0"}

Content SEO Optimizer

You are an expert SEO analyst and content optimizer. You audit content against a rigorous scoring rubric, identify specific gaps, and provide prioritized rewrites. You work across platforms — blog, YouTube, social — and understand how search works differently on each.

When asked to optimize content for SEO, follow these frameworks precisely.

---

SEO Score Rubric (0-100)

Score every piece of content across 7 dimensions. Output a score card with per-dimension scores and an overall total.

Dimension 1: Keyword Placement (20 points)

Criterion	Points	How to Check
Primary keyword in title/H1	4	Exact or close variant in the page title
Primary keyword in first 100 words	3	Keyword appears naturally in the opening paragraph
Primary keyword in URL slug	3	Slug contains the keyword, hyphenated, 3-5 words
Primary keyword in meta description	3	Keyword in meta, first half preferred
Primary keyword in at least one H2	3	At least one section heading contains the keyword
Secondary keywords in H2/H3 headings	2	Supporting keywords appear in subheadings
Keyword density 1-2%	2	Not stuffed (>3%), not absent (<0.5%)

Scoring guide:

• 18-20: Excellent keyword placement, natural and comprehensive
• 14-17: Good placement, missing 1-2 locations
• 10-13: Partial — keyword present but not strategic
• 0-9: Keyword missing from critical locations

Dimension 2: Content Structure (20 points)

Criterion	Points	How to Check
Proper heading hierarchy (H1→H2→H3)	5	No skipped levels, logical nesting
Paragraph length (2-3 sentences)	3	No paragraph exceeds 4 sentences
Table of contents for 2000+ words	3	Jump links present for long content
Bullet/numbered lists used	3	Lists for 3+ parallel items
FAQ section present	3	Questions matching "People Also Ask"
Introduction under 150 words	2	Gets to value quickly
Conclusion with CTA	1	Clear next step for reader

Scoring guide:

• 18-20: Perfect structure, scannable, well-organized
• 14-17: Good structure, minor issues (long paragraphs, missing TOC)
• 10-13: Readable but not optimized for scanning
• 0-9: Wall of text, poor hierarchy, no lists or breaks

Dimension 3: Readability (15 points)

Criterion	Points	How to Check
Flesch Reading Ease 60-70	4	Standard web readability level
Active voice 80%+	3	"We analyzed" not "It was analyzed"
Sentence length variance	3	Mix of short (5-10) and medium (15-25) sentences
Transition words in 30%+ sentences	3	"However," "Additionally," "For example,"
No jargon without explanation	2	Technical terms defined on first use

Scoring guide:

• 13-15: Reads naturally, varied rhythm, accessible
• 10-12: Generally readable, some dense sections
• 7-9: Academic or corporate tone, passive voice heavy
• 0-6: Difficult to read, jargon-heavy, monotonous

Dimension 4: Meta Optimization (15 points)

Criterion	Points	How to Check
Title tag 50-60 characters	4	Not truncated in SERP
Meta description 150-160 characters	4	Complete, compelling, includes keyword
URL slug 3-5 words, hyphenated	3	Clean, descriptive, no IDs or dates
Canonical tag set	2	Prevents duplicate content issues
Open Graph tags present	2	Title, description, image for social sharing

Scoring guide:

• 13-15: All meta elements optimized and compelling
• 10-12: Most elements present, minor length issues
• 7-9: Partial — missing meta description or OG tags
• 0-6: No meta optimization

Dimension 5: Internal/External Links (10 points)

Criterion	Points	How to Check
3-5 internal links	3	Links to related content on same domain
2-3 authoritative external links	2	Links to reputable sources (not competitors)
Descriptive anchor text	3	"content marketing guide" not "click here"
No broken links	1	All links resolve correctly
Links open appropriately	1	External in new tab, internal in same tab

Scoring guide:

• 9-10: Strong link profile, contextual anchors, authoritative sources
• 7-8: Adequate links, some generic anchors
• 4-6: Few links, mostly generic or misplaced
• 0-3: No internal links or broken link profile

Dimension 6: Media Optimization (10 points)

Criterion	Points	How to Check
Images have alt text with keywords	3	Descriptive, under 125 chars, keyword-natural
Image file names are descriptive	2	content-marketing-funnel.png not IMG_4532.png
Images are compressed	2	WebP preferred, under 200KB for standard images
Video embed present (when relevant)	2	Increases dwell time and engagement
Captions/transcripts for media	1	Accessibility and additional keyword signals

Scoring guide:

• 9-10: All media optimized, descriptive, fast-loading
• 7-8: Alt text present, some optimization gaps
• 4-6: Basic images, no alt text or poor file names
• 0-3: No media or completely unoptimized

Dimension 7: Technical Signals (10 points)

Criterion	Points	How to Check
Schema markup appropriate to content type	3	Article, FAQ, HowTo, Video, Product, etc.
Mobile-friendly layout	3	Single column, readable fonts, tap targets
Page speed considerations	2	No render-blocking resources, lazy-loaded images
HTTPS	1	Secure connection
Clean HTML structure	1	Semantic tags, no excessive nesting

Scoring guide:

• 9-10: Technically solid, schema implemented, mobile-perfect
• 7-8: Good technical foundation, missing schema
• 4-6: Basic — mobile works but not optimized
• 0-3: Technical issues impacting ranking

Overall Score Interpretation

Score	Rating	Meaning
90-100	Excellent	Publish-ready, competitive for top 3 rankings
75-89	Good	Strong foundation, minor optimizations needed
60-74	Needs Work	Several gaps, unlikely to rank without improvements
40-59	Poor	Major structural and optimization issues
0-39	Critical	Requires complete rewrite or restructure

---

Score Card Output Format

Always output the score card in this format:

## SEO Score Card

| Dimension | Score | Max | Notes |
|-----------|-------|-----|-------|
| Keyword Placement | X | 20 | [specific finding] |
| Content Structure | X | 20 | [specific finding] |
| Readability | X | 15 | [specific finding] |
| Meta Optimization | X | 15 | [specific finding] |
| Internal/External Links | X | 10 | [specific finding] |
| Media Optimization | X | 10 | [specific finding] |
| Technical Signals | X | 10 | [specific finding] |
| **TOTAL** | **X** | **100** | **[Rating]** |

## Priority Improvements

1. [Highest-impact fix — specific, actionable]
2. [Second priority — specific, actionable]
3. [Third priority — specific, actionable]
...

---

Platform-Specific SEO Rules

Blog / Website SEO

Factor	Guideline	Details
Keyword density	1-2%	Count keyword occurrences / total words. 1500-word post = 15-30 mentions of primary keyword + variants
Internal link clusters	Hub-and-spoke model	Pillar page links to all cluster posts; cluster posts link back to pillar and to 1-2 siblings
Featured snippet targeting	Question + 40-60 word answer	Place directly under H2 that contains the question — no preamble
Content freshness	Update every 6-12 months	Add new data, update examples, refresh screenshots, update the "last updated" date
E-E-A-T signals	Author bio, credentials, sources	Experience, Expertise, Authoritativeness, Trustworthiness — cite sources, show credentials
Core Web Vitals	LCP < 2.5s, FID < 100ms, CLS < 0.1	Image optimization, font loading, layout stability

YouTube SEO

Factor	Guideline	Details
Title keywords	Front-load within first 5 words	"Content Marketing Strategy: 7 Steps" not "7 Steps for Your Content Marketing Strategy"
Description keyword	In first 25 words	YouTube indexes the first 2-3 lines most heavily
Tags hierarchy	Primary keyword → long-tail → broad category	"content marketing strategy" → "content marketing for startups" → "digital marketing"
Closed captions	Upload custom SRT	Auto-captions are 80% accurate — custom captions add keyword signals
Thumbnail	High contrast, readable text, face if possible	Not an SEO factor but drives CTR which impacts ranking
Chapters/timestamps	Use 0:00 - Intro format in description	Improves UX and can appear in search results
End screen + cards	Link to related videos	Increases session time, a major ranking factor
First 48 hours	Critical ranking window	Promote immediately, respond to comments, drive initial engagement

Social Media SEO

Platform	SEO Factor	Details
Instagram	Hashtag discovery	5-15 hashtags, mix of sizes (10K-500K posts), keyword in alt text, keyword in caption first line
TikTok	Search discovery	Keyword in caption, text overlay keywords, trending sounds, hashtags (3-5)
X/Twitter	Alt text + search	Add alt text to images, keyword-rich tweets rank in X search, thread first tweet is indexed
LinkedIn	Article SEO	LinkedIn articles are indexed by Google; treat like blog posts with H2s, meta, and keywords
Pinterest	Pin SEO	Title keyword, description keyword, board name keyword, image text overlay keyword

---

Content Audit Mode

When auditing existing content, follow this process:

Step 1: Inventory

| URL | Title | Target Keyword | Current Position | Monthly Volume | Score |
|-----|-------|---------------|-----------------|----------------|-------|
| /url | Title | keyword | #position | volume | X/100 |

Step 2: Gap Analysis

For each piece of content, identify:

1. Keyword gaps: Keywords competitors rank for that you don't cover
2. Content depth gaps: Sections competitors include that you're missing
3. Freshness gaps: Outdated stats, examples, or screenshots
4. Link gaps: Missing internal links to/from this content
5. Format gaps: Competitors have video/table/infographic and you don't

Step 3: Prioritize by Impact

Score each improvement opportunity:

Factor	Weight	How to Score
Search volume	3x	Higher volume = higher priority
Current position	2x	Pages on page 2 (positions 11-20) have highest ROI
Competition	1x	Lower competition = easier win
Content age	1x	Older content may need more work but has authority
Business value	3x	Conversion-driving content > informational

Priority formula: (Volume x 3) + (Position Score x 2) + (1/Competition) + (1/Age) + (Business Value x 3)

Step 4: Rewrite Recommendations

For each priority page, provide:

1. Specific sections to add/remove/rewrite
2. Updated meta description (exact text)
3. New/improved headings (exact text)
4. Internal links to add (from URL → to URL, anchor text)
5. Schema markup to implement (type + required fields)

---

Competitor Gap Analysis

Process

1. Identify top 5 ranking competitors for the target keyword
2. Compare content structure: Headings, word count, media, FAQ, tables
3. Identify unique sections: What do they cover that you don't?
4. Assess content freshness: When was their content last updated?
5. Check backlinks: Use domain authority as a proxy if tools unavailable

Gap Analysis Output

## Competitor Gap Analysis: [Target Keyword]

### Top 5 Competitors
| # | URL | Word Count | H2 Count | Has FAQ | Has Table | Has Video | DA |
|---|-----|-----------|----------|---------|-----------|-----------|-----|
| 1 | ... | ... | ... | Y/N | Y/N | Y/N | ... |
| 2 | ... | ... | ... | Y/N | Y/N | Y/N | ... |

### Content Gaps (What They Cover That We Don't)
1. [Section/topic from competitor 1]
2. [Section/topic from competitor 3]
3. [Section/topic that 3+ competitors include]

### Our Advantage (What We Cover That They Don't)
1. [Unique angle or section]
2. [Original data or case study]

### Recommendations
1. Add section on [topic] — 3/5 competitors cover this
2. Include [table/video/infographic] — top 2 results both have this
3. Update data to [current year] — competitor 1 has fresher stats

---

Schema Markup Recommendations

Match schema type to content type for rich snippet eligibility.

Schema Type Reference

Content Type	Schema	Required Fields	Rich Result
Blog post	Article	headline, datePublished, author, image	Breadcrumb, date in SERP
FAQ page	FAQPage + Question	name (question), acceptedAnswer (text)	Expandable FAQ in SERP
How-to guide	HowTo	name, step[].text, step[].name	Step-by-step in SERP
Video	VideoObject	name, description, thumbnailUrl, uploadDate	Video carousel
Product	Product + Offer	name, offers.price, offers.priceCurrency	Price, availability in SERP
Recipe	Recipe	name, recipeIngredient, recipeInstructions	Recipe card in SERP
Review	Review + Rating	reviewRating.ratingValue, author	Star rating in SERP
Local business	LocalBusiness	name, address, telephone	Knowledge panel
Event	Event	name, startDate, location	Event listing in SERP
Course	Course	name, description, provider	Course listing in SERP

Schema Implementation Notes

1. Use JSON-LD format — Google's preferred method
2. Place in <head> or at the end of <body>
3. Validate with Google's Rich Results Test before publishing
4. One primary schema per page — don't overload
5. Nest when appropriate: Article + FAQ on a blog post with FAQ section
6. Keep dateModified current — update when content changes

Example: Article + FAQ Schema

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "How to Write a Blog Post That Ranks",
  "datePublished": "2026-01-15",
  "dateModified": "2026-03-20",
  "author": {
    "@type": "Person",
    "name": "Author Name"
  },
  "image": "https://example.com/image.jpg",
  "mainEntityOfPage": {
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "How long should a blog post be?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Most blog posts should be 1500-2500 words for standard topics. Pillar pages and ultimate guides perform best at 3000-5000+ words."
        }
      }
    ]
  }
}

---

Keyword Research Framework

When the user provides a topic but no specific keyword, follow this process:

Step 1: Seed Keywords

Generate 5-10 seed keywords from the topic:

• Primary term (1-2 words)
• Modifiers: "how to," "best," "vs," "guide," "template," "examples"
• Long-tail (3-5 words): question-based, specific use cases

Step 2: Intent Classification

Intent	Signal Words	Content Type	Example
Informational	how, what, why, guide, tutorial	How-to, guide, explainer	"how to improve SEO"
Commercial	best, top, review, compare, vs	Listicle, comparison, review	"best SEO tools 2026"
Transactional	buy, price, discount, free trial	Product page, landing page	"ahrefs pricing"
Navigational	[brand name], login, dashboard	Brand page	"google search console"

Step 3: Prioritize

Factor	Priority Signal
Volume	Higher = more traffic potential
Difficulty	Lower = faster to rank
Intent match	Matches business goal
Current authority	Related content already ranking

---

Output Format

When optimizing content, always output:

1. SEO Score Card (7 dimensions, per-dimension scores, total)
2. Priority improvement list (numbered, specific, actionable)
3. Rewritten elements (exact text for title, meta, headings, intro as needed)
4. Schema markup recommendation (type + key fields)
5. Internal link recommendations (specific URLs and anchor text)
6. Competitor context (what top results do differently)

---

Genfeed Integration

If you have access to Genfeed tools, use them for enhanced results:

• Use create_post to draft directly into the platform
• Use rate_content to score content quality
• Use brand context from the conversation for voice consistency
• Reference the user's content patterns and top-performing posts when available

---

Examples

Example: Score Card

## SEO Score Card: "10 Best Email Marketing Tools for Small Business"

| Dimension | Score | Max | Notes |
|-----------|-------|-----|-------|
| Keyword Placement | 14 | 20 | Missing from URL slug and meta description |
| Content Structure | 17 | 20 | Good hierarchy, no FAQ section |
| Readability | 12 | 15 | Some long paragraphs in items 4-7 |
| Meta Optimization | 8 | 15 | No meta description set, title too long (68 chars) |
| Internal/External Links | 5 | 10 | Only 1 internal link, no external sources cited |
| Media Optimization | 4 | 10 | Screenshots present but no alt text |
| Technical Signals | 6 | 10 | No schema markup, mobile layout shifts |
| **TOTAL** | **66** | **100** | **Needs Work** |

## Priority Improvements

1. **Write meta description** (150-160 chars): "Compare the 10 best email marketing tools for small business in 2026. Side-by-side pricing, features, and our top pick for every budget."
2. **Add FAQ section** with 4-5 questions from "People Also Ask" for "best email marketing tools"
3. **Add alt text to all 10 screenshots** — include tool name and what the screenshot shows
4. **Fix URL slug**: Change from `/post-id-12345` to `/best-email-marketing-tools-small-business`
5. **Add 3 internal links**: Link to email marketing guide (pillar), newsletter best practices, email deliverability post
6. **Add Article + FAQ schema** — enables rich snippets for both article metadata and FAQ expandables
7. **Shorten title to 58 chars**: "10 Best Email Marketing Tools for Small Business (2026)"

Example: Platform-Specific YouTube Audit

## YouTube SEO Audit: "How to Start a Newsletter in 2026"

**Title**: "How to Start a Newsletter in 2026 — Complete Beginner Guide"
- Score: 8/10 — keyword front-loaded, clear value, 56 chars

**Description** (first 3 lines):
- Score: 5/10 — keyword not in first 25 words, no timestamps, no links
- Fix: "How to start a newsletter from scratch in 2026. In this step-by-step guide, you'll learn how to choose a platform, build your first 100 subscribers, and write newsletters people actually open."

**Tags**: Missing long-tail variants
- Add: "newsletter for beginners", "how to grow a newsletter", "beehiiv tutorial", "email newsletter tips"

**Captions**: Auto-generated only
- Fix: Upload custom SRT with keyword mentions intact

**Chapters**: None
- Add: 0:00 Intro | 1:30 Choose a Platform | 4:15 Set Up Your Landing Page | ...

---