README
---
name: seo-optimizer
description: Optimize content for search engines. Improve keyword usage, meta descriptions, headings, and content structure for better ranking. Use when creating web content, blog posts, or any content intended for search discovery.
---
# SEO Optimizer
**Goal**: Optimize content for search engine visibility and ranking.
---
## 1. Keyword Optimization
### Keyword Placement
```markdown
## Required Positions
1. Title tag - near the beginning
2. H1 heading - include primary keyword
3. First paragraph - within the first 100 words
4. Subheadings (H2/H3) - include related keywords
5. Conclusion - natural summary
## Keyword Density
- Primary keyword: 1-2%
- Related keywords: naturally distributed
- Avoid keyword stuffing
```
### Keyword Types
| Type | Example | Purpose |
|------|---------|---------|
| Short-tail | SEO | Brand awareness |
| Long-tail | how to optimize SEO | Targeted traffic |
| Question | what is SEO | FAQ content |
| Brand | company + product | Brand search |
### Keyword Research
```markdown
## Tools
- Google Keyword Planner
- Ahrefs
- SEMrush
- Google Trends
- Answer the Public
## Selection Criteria
1. Search volume: monthly search volume
2. Competition: optimization difficulty
3. Relevance: match with content
4. Commercial value: conversion potential
```
---
## 2. Title Optimization
### Title Tag
```markdown
## Rules
- Length: 50-60 characters
- Include primary keyword
- Brand name at the end
- Compelling for clicks
## Formula
[Primary Keyword] - [Secondary Keyword/Value Prop] | [Brand]
## Examples
Good: Best Laptops 2025 - Top 10 Picks for Every Budget | TechReview
Bad: Home Page | Company Name
```
### H1-H6 Structure
```markdown
## Hierarchy Rules
H1: Main page title (only 1 per page)
H2: Major sections
H3: Subsections
H4-H6: Further subdivisions
## Example
<h1>How to Learn Python Programming</h1>
<h2>Introduction to Python</h2>
<h2>Learning Path</h2>
<h3>Beginner Stage</h3>
<h3>Advanced Stage</h3>
<h2>Recommended Resources</h2>
```
---
## 3. Meta Description
### Rules
```markdown
## Length
- Optimal: 150-160 characters
- Mobile: 120 characters
## Content Elements
1. Include primary keyword
2. Explain page value
3. Include call to action
4. Unique and compelling
## Template
[Problem/Pain point]? [Solution]. [Value statement]. [CTA]
## Example
Want to boost your website traffic? This article shares 10 practical SEO tips
to help you increase organic search traffic by 50% in 3 months. Read now!
```
---
## 4. Content Optimization
### Content Structure
```markdown
## Ideal Structure
1. Introduction (include keyword)
2. Table of contents (anchor links)
3. Body (organized with subheadings)
4. Conclusion (keyword naturally included)
5. CTA (related links/actions)
## Content Length Guidelines
| Type | Recommended Words |
|------|-------------------|
| News | 300-500 |
| Blog post | 1000-2000 |
| In-depth article | 2000-4000 |
| Comprehensive guide | 4000+ |
```
### Readability for SEO
```markdown
## Recommendations
- Paragraphs: 3-5 sentences
- Sentences: 15-25 words
- Use bullet lists
- Add subheadings
- Adequate whitespace
```
### Multimedia Optimization
```markdown
## Image Optimization
1. File names: include keywords
Good: seo-optimization-tips.jpg
Bad: IMG_001.jpg
2. Alt text: describe image + keyword
Good: alt="SEO optimization tips infographic"
3. Compress images: reduce load time
4. Use WebP format
## Video Optimization
- Add captions/transcripts
- Optimize title and description
- Add timestamps
```
---
## 5. Link Strategy
### Internal Links
```markdown
## Rules
1. Link related pages to each other
2. Anchor text includes keywords
3. Links are natural and valuable
4. Important pages receive more links
## Anchor Text Types
Good: Learn more about [SEO optimization tips]
Good: Check out our [SEO beginner's guide]
Bad: [Click here]
Bad: Excessive exact-match anchors
```
### External Links
```markdown
## Principles
1. Link to authoritative websites
2. Add nofollow for ads/untrusted links
3. Open external links in new window
4. Regularly check for broken links
```
---
## 6. Technical SEO
### URL Optimization
```markdown
## Rules
1. Include keywords
2. Keep short and clear
3. Use hyphens (-)
4. Avoid special characters
5. Use lowercase letters
## Examples
Good: /seo-optimization-guide
Bad: /page?id=12345&category=seo
Bad: /SEO_Optimization_Guide
```
### Page Speed
```markdown
## Core Web Vitals
| Metric | Target | Description |
|--------|--------|-------------|
| LCP | <2.5s | Largest Contentful Paint |
| FID | <100ms | First Input Delay |
| CLS | <0.1 | Cumulative Layout Shift |
## Optimization Methods
1. Compress images
2. Enable caching
3. Reduce JavaScript
4. Use CDN
5. Optimize server response
```
---
## 7. Checklist
```markdown
## SEO Optimization Checklist
### Keywords
- [ ] Primary keyword identified
- [ ] Keyword appears in title
- [ ] Keyword appears in first paragraph
- [ ] Keyword density is moderate (1-3%)
### Meta Information
- [ ] Title tag optimized
- [ ] Meta description optimized
- [ ] H1-H6 hierarchy is correct
### Content
- [ ] Sufficient content length
- [ ] Clear structure
- [ ] Multimedia included
- [ ] Good readability
### Links
- [ ] Appropriate internal links
- [ ] Authoritative external links
- [ ] No broken links
### Technical
- [ ] URL optimized
- [ ] Images optimized
- [ ] Mobile-friendly
- [ ] Page speed meets targets
```
---
## Quick Reference
### SEO Writing Formulas
```markdown
1. Keyword + Number + Power word = Great title
Example: 7 SEO Tips to Double Your Traffic
2. Problem + Solution + Value = Great description
Example: Struggling with SEO? 10 practical tips to boost your rankings
3. Inverted pyramid = Great content
Conclusion → Arguments → Evidence
```
### Common Mistakes
| Mistake | Impact | Fix |
|---------|--------|-----|
| Keyword stuffing | Penalty | Use naturally |
| Thin content | Low ranking | Expand content |
| Missing H1 | Poor structure | Add H1 |
| No image alt | Poor accessibility | Add alt text |
| Broken links | Bad UX | Regular audits |
name: seo-optimizer
description: Optimize content for search engines. Improve keyword usage, meta descriptions, headings, and content structure for better ranking. Use when creating web content, blog posts, or any content intended for search discovery.
---
# SEO Optimizer
**Goal**: Optimize content for search engine visibility and ranking.
---
## 1. Keyword Optimization
### Keyword Placement
```markdown
## Required Positions
1. Title tag - near the beginning
2. H1 heading - include primary keyword
3. First paragraph - within the first 100 words
4. Subheadings (H2/H3) - include related keywords
5. Conclusion - natural summary
## Keyword Density
- Primary keyword: 1-2%
- Related keywords: naturally distributed
- Avoid keyword stuffing
```
### Keyword Types
| Type | Example | Purpose |
|------|---------|---------|
| Short-tail | SEO | Brand awareness |
| Long-tail | how to optimize SEO | Targeted traffic |
| Question | what is SEO | FAQ content |
| Brand | company + product | Brand search |
### Keyword Research
```markdown
## Tools
- Google Keyword Planner
- Ahrefs
- SEMrush
- Google Trends
- Answer the Public
## Selection Criteria
1. Search volume: monthly search volume
2. Competition: optimization difficulty
3. Relevance: match with content
4. Commercial value: conversion potential
```
---
## 2. Title Optimization
### Title Tag
```markdown
## Rules
- Length: 50-60 characters
- Include primary keyword
- Brand name at the end
- Compelling for clicks
## Formula
[Primary Keyword] - [Secondary Keyword/Value Prop] | [Brand]
## Examples
Good: Best Laptops 2025 - Top 10 Picks for Every Budget | TechReview
Bad: Home Page | Company Name
```
### H1-H6 Structure
```markdown
## Hierarchy Rules
H1: Main page title (only 1 per page)
H2: Major sections
H3: Subsections
H4-H6: Further subdivisions
## Example
<h1>How to Learn Python Programming</h1>
<h2>Introduction to Python</h2>
<h2>Learning Path</h2>
<h3>Beginner Stage</h3>
<h3>Advanced Stage</h3>
<h2>Recommended Resources</h2>
```
---
## 3. Meta Description
### Rules
```markdown
## Length
- Optimal: 150-160 characters
- Mobile: 120 characters
## Content Elements
1. Include primary keyword
2. Explain page value
3. Include call to action
4. Unique and compelling
## Template
[Problem/Pain point]? [Solution]. [Value statement]. [CTA]
## Example
Want to boost your website traffic? This article shares 10 practical SEO tips
to help you increase organic search traffic by 50% in 3 months. Read now!
```
---
## 4. Content Optimization
### Content Structure
```markdown
## Ideal Structure
1. Introduction (include keyword)
2. Table of contents (anchor links)
3. Body (organized with subheadings)
4. Conclusion (keyword naturally included)
5. CTA (related links/actions)
## Content Length Guidelines
| Type | Recommended Words |
|------|-------------------|
| News | 300-500 |
| Blog post | 1000-2000 |
| In-depth article | 2000-4000 |
| Comprehensive guide | 4000+ |
```
### Readability for SEO
```markdown
## Recommendations
- Paragraphs: 3-5 sentences
- Sentences: 15-25 words
- Use bullet lists
- Add subheadings
- Adequate whitespace
```
### Multimedia Optimization
```markdown
## Image Optimization
1. File names: include keywords
Good: seo-optimization-tips.jpg
Bad: IMG_001.jpg
2. Alt text: describe image + keyword
Good: alt="SEO optimization tips infographic"
3. Compress images: reduce load time
4. Use WebP format
## Video Optimization
- Add captions/transcripts
- Optimize title and description
- Add timestamps
```
---
## 5. Link Strategy
### Internal Links
```markdown
## Rules
1. Link related pages to each other
2. Anchor text includes keywords
3. Links are natural and valuable
4. Important pages receive more links
## Anchor Text Types
Good: Learn more about [SEO optimization tips]
Good: Check out our [SEO beginner's guide]
Bad: [Click here]
Bad: Excessive exact-match anchors
```
### External Links
```markdown
## Principles
1. Link to authoritative websites
2. Add nofollow for ads/untrusted links
3. Open external links in new window
4. Regularly check for broken links
```
---
## 6. Technical SEO
### URL Optimization
```markdown
## Rules
1. Include keywords
2. Keep short and clear
3. Use hyphens (-)
4. Avoid special characters
5. Use lowercase letters
## Examples
Good: /seo-optimization-guide
Bad: /page?id=12345&category=seo
Bad: /SEO_Optimization_Guide
```
### Page Speed
```markdown
## Core Web Vitals
| Metric | Target | Description |
|--------|--------|-------------|
| LCP | <2.5s | Largest Contentful Paint |
| FID | <100ms | First Input Delay |
| CLS | <0.1 | Cumulative Layout Shift |
## Optimization Methods
1. Compress images
2. Enable caching
3. Reduce JavaScript
4. Use CDN
5. Optimize server response
```
---
## 7. Checklist
```markdown
## SEO Optimization Checklist
### Keywords
- [ ] Primary keyword identified
- [ ] Keyword appears in title
- [ ] Keyword appears in first paragraph
- [ ] Keyword density is moderate (1-3%)
### Meta Information
- [ ] Title tag optimized
- [ ] Meta description optimized
- [ ] H1-H6 hierarchy is correct
### Content
- [ ] Sufficient content length
- [ ] Clear structure
- [ ] Multimedia included
- [ ] Good readability
### Links
- [ ] Appropriate internal links
- [ ] Authoritative external links
- [ ] No broken links
### Technical
- [ ] URL optimized
- [ ] Images optimized
- [ ] Mobile-friendly
- [ ] Page speed meets targets
```
---
## Quick Reference
### SEO Writing Formulas
```markdown
1. Keyword + Number + Power word = Great title
Example: 7 SEO Tips to Double Your Traffic
2. Problem + Solution + Value = Great description
Example: Struggling with SEO? 10 practical tips to boost your rankings
3. Inverted pyramid = Great content
Conclusion → Arguments → Evidence
```
### Common Mistakes
| Mistake | Impact | Fix |
|---------|--------|-----|
| Keyword stuffing | Penalty | Use naturally |
| Thin content | Low ranking | Expand content |
| Missing H1 | Poor structure | Add H1 |
| No image alt | Poor accessibility | Add alt text |
| Broken links | Bad UX | Regular audits |
Phenotype
Input
| Property | Type | Req | Description |
|---|---|---|---|
| url | string | Optional URL for context | |
| content | string | ✓ | Plain text or HTML content to analyze |
| targetKeyword | string | Target keyword for density and placement checks |
Output
| Property | Type | Req | Description |
|---|---|---|---|
| score | number | ✓ | SEO score 0-100 |
| issues | array | ✓ | |
| wordCount | number | ✓ | Total word count |
| metaAnalysis | object | ✓ | |
| keywordDensity | number | ✓ | Keyword density percentage |
| headingStructure | object | ✓ | |
| readabilityScore | number | ✓ | Flesch-Kincaid reading ease 0-100 |
Raw JSON Schema
inputSchema
{
"type": "object",
"required": [
"content"
],
"properties": {
"url": {
"type": "string",
"description": "Optional URL for context"
},
"content": {
"type": "string",
"description": "Plain text or HTML content to analyze"
},
"targetKeyword": {
"type": "string",
"description": "Target keyword for density and placement checks"
}
}
} outputSchema
{
"type": "object",
"required": [
"score",
"issues",
"keywordDensity",
"wordCount",
"headingStructure",
"metaAnalysis",
"readabilityScore"
],
"properties": {
"score": {
"type": "number",
"description": "SEO score 0-100"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"required": [
"severity",
"rule",
"message",
"suggestion"
],
"properties": {
"rule": {
"type": "string"
},
"message": {
"type": "string"
},
"severity": {
"enum": [
"error",
"warning",
"info"
],
"type": "string"
},
"suggestion": {
"type": "string"
}
}
}
},
"wordCount": {
"type": "number",
"description": "Total word count"
},
"metaAnalysis": {
"type": "object",
"required": [
"titleLength",
"hasMetaDescription",
"descriptionLength"
],
"properties": {
"titleLength": {
"type": "number"
},
"descriptionLength": {
"type": "number"
},
"hasMetaDescription": {
"type": "boolean"
}
}
},
"keywordDensity": {
"type": "number",
"description": "Keyword density percentage"
},
"headingStructure": {
"type": "object",
"required": [
"h1Count",
"h2Count",
"h3Count",
"hasProperHierarchy"
],
"properties": {
"h1Count": {
"type": "number"
},
"h2Count": {
"type": "number"
},
"h3Count": {
"type": "number"
},
"hasProperHierarchy": {
"type": "boolean"
}
}
},
"readabilityScore": {
"type": "number",
"description": "Flesch-Kincaid reading ease 0-100"
}
}
} Arena History
| Date | Fitness | Safety | Calls |
|---|---|---|---|
| Mar 17 | 0.7560 | 0.81 | 1 |