| name | seo-optimizer |
| description | Technical SEO, content strategy, and link building for organic traffic growth. Includes on-page optimization, keyword research, site architecture, Core Web Vitals, and ranking strategies. |
| tags | ["seo","search","optimization","content","keywords","ranking","traffic"] |
| version | 1.0.0 |
| author | Enhanced from SEO best practices 2026) |
SEO Optimizer
Overview
Drive organic traffic through comprehensive search engine optimization.
SEO pillars:
- Technical SEO - Site speed, mobile-friendliness, crawlability
- On-Page SEO - Content, keywords, meta tags, structure
- Off-Page SEO - Backlinks, authority, trust signals
- Content Strategy - High-quality, relevant, valuable content
Benefits:
- Sustainable traffic (not dependent on ads)
- High-intent visitors (searching for solutions)
- Compound growth (rankings improve over time)
- Cost-effective (vs paid ads)
When to Use
Use for:
- Blog content optimization
- Product/landing page SEO
- Technical site audits
- Keyword research
- Link building campaigns
Critical for:
- Content-driven businesses
- SaaS products
- E-commerce sites
- Local businesses
- B2B lead generation
The 5-Pillar SEO Framework
┌─────────────────────────────────────────────────────────┐
│ SEO OPTIMIZATION PILLARS │
└─────────────────────────────────────────────────────────┘
┌──────────────┐
│ PILLAR 1 │ Technical SEO
│ TECHNICAL │ - Site speed
│ │ - Mobile-friendly
└──────┬───────┘ - Crawlability
│
▼
┌──────────────┐
│ PILLAR 2 │ Keyword Research
│ KEYWORDS │ - Search intent
│ │ - Competition
└──────┬───────┘ - Opportunity
│
▼
┌──────────────┐
│ PILLAR 3 │ On-Page SEO
│ ON-PAGE │ - Content quality
│ │ - Meta tags
└──────┬───────┘ - Internal links
│
▼
┌──────────────┐
│ PILLAR 4 │ Content Strategy
│ CONTENT │ - Topic clusters
│ │ - Content calendar
└──────┬───────┘ - User intent
│
▼
┌──────────────┐
│ PILLAR 5 │ Link Building
│ OFF-PAGE │ - Backlinks
│ │ - Authority
└──────────────┘ - Trust signals
Pillar 1: Technical SEO
Goal: Make your site fast, crawlable, and mobile-friendly
Core Web Vitals (Google's ranking factors):
## Core Web Vitals Targets
### 1. Largest Contentful Paint (LCP)
**What:** Time until largest content element loads
**Target:** < 2.5 seconds
**How to improve:**
- Optimize images (WebP, lazy loading)
- Use CDN for static assets
- Minimize render-blocking resources
- Implement server-side rendering (SSR)
### 2. First Input Delay (FID)
**What:** Time until page responds to user interaction
**Target:** < 100 milliseconds
**How to improve:**
- Minimize JavaScript execution
- Code splitting (load only what's needed)
- Use web workers for heavy tasks
- Defer non-critical JavaScript
### 3. Cumulative Layout Shift (CLS)
**What:** Visual stability (elements don't jump around)
**Target:** < 0.1
**How to improve:**
- Set explicit width/height for images
- Reserve space for ads/embeds
- Avoid inserting content above existing content
- Use CSS transforms instead of layout properties
### 4. Interaction to Next Paint (INP) [New in 2024]
**What:** Responsiveness to all user interactions
**Target:** < 200 milliseconds
**How to improve:**
- Optimize event handlers
- Reduce main thread work
- Use requestIdleCallback for non-urgent tasks
Technical SEO Checklist:
## Technical SEO Audit
### Crawlability
- [ ] robots.txt allows search engines
- [ ] XML sitemap exists and submitted to Google Search Console
- [ ] No orphan pages (all pages linked from somewhere)
- [ ] No broken links (404 errors)
- [ ] Proper use of noindex/nofollow tags
- [ ] Canonical tags prevent duplicate content
### Site Speed
- [ ] Page load time < 3 seconds
- [ ] Time to First Byte (TTFB) < 600ms
- [ ] Images optimized (WebP, compressed)
- [ ] CSS/JS minified and compressed
- [ ] Browser caching enabled
- [ ] CDN for static assets
### Mobile-Friendliness
- [ ] Responsive design (works on all screen sizes)
- [ ] Touch targets are large enough (48×48px minimum)
- [ ] Text is readable without zooming (16px minimum)
- [ ] No horizontal scrolling
- [ ] Mobile-friendly navigation
### HTTPS & Security
- [ ] SSL certificate installed (HTTPS)
- [ ] All resources loaded over HTTPS
- [ ] HSTS header enabled
- [ ] No mixed content warnings
### Structured Data
- [ ] Schema.org markup for rich snippets
- [ ] Organization schema
- [ ] Article schema for blog posts
- [ ] Product schema for e-commerce
- [ ] FAQ schema for Q&A content
- [ ] Breadcrumb schema for navigation
### URL Structure
- [ ] Clean, descriptive URLs (no ?id=123)
- [ ] Hyphens separate words (not underscores)
- [ ] Lowercase URLs
- [ ] No unnecessary parameters
- [ ] Proper redirects (301 for permanent, 302 for temporary)
Tools for Technical SEO:
curl "https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url=https://example.com"
npm install -g lighthouse
lighthouse https://example.com --output html --output-path ./report.html
Pillar 2: Keyword Research
Goal: Find keywords with high traffic potential and low competition
Keyword Research Process:
## Step 1: Brainstorm Seed Keywords
**Your product:** AI code assistant
**Seed keywords:**
- AI code assistant
- AI pair programmer
- code completion tool
- automated code review
- AI coding tool
## Step 2: Expand with Keyword Tools
**Tools:**
- Google Keyword Planner (free)
- Ahrefs Keywords Explorer (paid)
- SEMrush Keyword Magic Tool (paid)
- Ubersuggest (freemium)
**Expanded keywords:**
- best AI code assistant (1,200 searches/month, KD: 45)
- AI code completion (800 searches/month, KD: 30)
- GitHub Copilot alternative (600 searches/month, KD: 25)
- free AI coding tool (500 searches/month, KD: 35)
- AI code review tool (400 searches/month, KD: 40)
## Step 3: Analyze Search Intent
**Intent types:**
- **Informational:** "what is AI code assistant" (top of funnel)
- **Navigational:** "GitHub Copilot login" (brand search)
- **Commercial:** "best AI code assistant" (comparison)
- **Transactional:** "buy AI code assistant" (bottom of funnel)
**Match content to intent:**
- Informational → Blog post, guide
- Commercial → Comparison page, reviews
- Transactional → Product page, pricing
## Step 4: Evaluate Keyword Difficulty
**Metrics:**
- **Search volume:** Monthly searches (higher = more traffic potential)
- **Keyword difficulty (KD):** 0-100 (lower = easier to rank)
- **Cost per click (CPC):** Paid ad cost (higher = more valuable)
- **SERP features:** Featured snippets, People Also Ask, etc.
**Prioritization matrix:**
| Keyword | Volume | KD | CPC | Priority |
|---------|--------|----|----|----------|
| AI code assistant | 2,000 | 60 | $8 | Medium |
| best AI code assistant | 1,200 | 45 | $6 | High |
| AI code completion | 800 | 30 | $5 | High |
| free AI coding tool | 500 | 35 | $3 | High |
| AI code review | 400 | 40 | $7 | Medium |
**Priority formula:**
Priority = (Volume × CPC) / KD
**Target keywords:**
- High priority: Volume >500, KD <40
- Medium priority: Volume >200, KD <60
- Low priority: Everything else (future targets)
Long-Tail Keywords:
## Long-Tail Strategy
**Why long-tail:**
- Lower competition (easier to rank)
- Higher intent (more likely to convert)
- More specific (better match for content)
**Examples:**
**Short-tail (competitive):**
- "AI code assistant" (2,000 searches, KD: 60)
**Long-tail (easier):**
- "best AI code assistant for Python" (150 searches, KD: 25)
- "AI code assistant vs GitHub Copilot" (100 searches, KD: 20)
- "free AI code assistant for VS Code" (80 searches, KD: 15)
**Strategy:**
- Target 1 short-tail keyword per page (main target)
- Include 5-10 long-tail variations (secondary targets)
- Naturally incorporate in content
Pillar 3: On-Page SEO
Goal: Optimize individual pages for target keywords
On-Page SEO Checklist:
## Page Optimization
### Title Tag
- [ ] Includes primary keyword (near the beginning)
- [ ] 50-60 characters (displays fully in search results)
- [ ] Compelling and click-worthy
- [ ] Unique for each page
**Examples:**
- ✅ "Best AI Code Assistant for Python Developers (2026)"
- ❌ "Home | AI Code Assistant | Welcome"
### Meta Description
- [ ] Includes primary keyword
- [ ] 150-160 characters
- [ ] Compelling call-to-action
- [ ] Unique for each page
**Examples:**
- ✅ "Discover the top 10 AI code assistants for Python. Compare features, pricing, and reviews. Find the perfect tool to boost your productivity."
- ❌ "Welcome to our website. We offer AI code assistants."
### URL Structure
- [ ] Includes primary keyword
- [ ] Short and descriptive
- [ ] Hyphens separate words
- [ ] No unnecessary parameters
**Examples:**
- ✅ `/best-ai-code-assistant-python`
- ❌ `/page?id=123&category=tools`
### Headings (H1-H6)
- [ ] One H1 per page (includes primary keyword)
- [ ] H2s for main sections (include secondary keywords)
- [ ] H3s for subsections
- [ ] Logical hierarchy (H1 → H2 → H3)
**Example structure:**
```html
<h1>Best AI Code Assistant for Python Developers</h1>
<h2>What is an AI Code Assistant?</h2>
<p>...</p>
<h2>Top 10 AI Code Assistants for Python</h2>
<h3>1. GitHub Copilot</h3>
<p>...</p>
<h3>2. Tabnine</h3>
<p>...</p>
<h2>How to Choose the Right AI Code Assistant</h2>
<p>...</p>
Content
Images
Example:
<img
src="/images/ai-code-assistant-comparison.webp"
alt="Comparison of top AI code assistants for Python developers"
width="800"
height="600"
loading="lazy"
/>
Internal Links
Example:
Learn more about [AI code completion tools](/ai-code-completion)
or read our [GitHub Copilot review](/github-copilot-review).
External Links
User Experience
**Content Optimization Template:**
```markdown
# [Primary Keyword] - [Benefit/Year]
[Introduction paragraph with primary keyword in first sentence]
## Table of Contents
- [Section 1]
- [Section 2]
- [Section 3]
## What is [Primary Keyword]?
[Definition, explanation, context]
## Why [Primary Keyword] Matters
[Benefits, use cases, problems it solves]
## [Main Content Section 1]
[Detailed content with examples, data, visuals]
### [Subsection 1.1]
[Content]
### [Subsection 1.2]
[Content]
## [Main Content Section 2]
[More detailed content]
## [Main Content Section 3]
[Even more content]
## Frequently Asked Questions
### [Question 1]?
[Answer]
### [Question 2]?
[Answer]
## Conclusion
[Summary, key takeaways, call-to-action]
---
**Related Articles:**
- [Internal link 1]
- [Internal link 2]
- [Internal link 3]
Pillar 4: Content Strategy
Goal: Create valuable content that ranks and converts
Topic Cluster Model:
## Topic Cluster Structure
### Pillar Page (Main topic)
**URL:** `/ai-code-assistants`
**Target keyword:** "AI code assistants"
**Content:** Comprehensive guide (3,000+ words)
### Cluster Pages (Subtopics)
1. `/ai-code-assistants/python` - "AI code assistant for Python"
2. `/ai-code-assistants/javascript` - "AI code assistant for JavaScript"
3. `/ai-code-assistants/vs-code` - "AI code assistant for VS Code"
4. `/ai-code-assistants/github-copilot-alternative` - "GitHub Copilot alternatives"
5. `/ai-code-assistants/free` - "Free AI code assistants"
### Internal Linking
- Pillar page links to all cluster pages
- Cluster pages link back to pillar page
- Cluster pages link to related cluster pages
**Benefits:**
- Establishes topical authority
- Improves internal linking
- Easier to rank for competitive keywords
- Better user experience
Content Calendar:
## Monthly Content Plan
### Week 1
- **Monday:** Publish pillar page "Complete Guide to AI Code Assistants"
- **Wednesday:** Publish cluster page "Best AI Code Assistant for Python"
- **Friday:** Update old post "GitHub Copilot Review" with 2026 updates
### Week 2
- **Monday:** Publish cluster page "AI Code Assistant for JavaScript"
- **Wednesday:** Publish comparison "GitHub Copilot vs Tabnine"
- **Friday:** Publish tutorial "How to Set Up AI Code Assistant in VS Code"
### Week 3
- **Monday:** Publish cluster page "Free AI Code Assistants"
- **Wednesday:** Publish case study "How We Reduced Bugs by 40% with AI"
- **Friday:** Publish listicle "10 AI Coding Tools Every Developer Should Know"
### Week 4
- **Monday:** Publish cluster page "AI Code Review Tools"
- **Wednesday:** Publish opinion piece "The Future of AI-Assisted Coding"
- **Friday:** Publish roundup "Best AI Tools for Developers in 2026"
**Content mix:**
- 40% Educational (guides, tutorials)
- 30% Commercial (comparisons, reviews)
- 20% Thought leadership (opinions, predictions)
- 10% Company (case studies, updates)
Content Types by Funnel Stage:
## Content Funnel
### Top of Funnel (Awareness)
**Goal:** Attract visitors, build awareness
**Content types:**
- "What is [topic]" guides
- Industry trends and statistics
- Beginner tutorials
- Listicles ("10 best...")
**Example:**
- "What is AI Pair Programming? A Beginner's Guide"
- "10 AI Coding Trends to Watch in 2026"
### Middle of Funnel (Consideration)
**Goal:** Educate, build trust
**Content types:**
- Comparison articles
- In-depth guides
- Case studies
- How-to tutorials
**Example:**
- "GitHub Copilot vs Tabnine: Which is Better?"
- "How to Choose the Right AI Code Assistant"
### Bottom of Funnel (Decision)
**Goal:** Convert to customers
**Content types:**
- Product pages
- Pricing comparisons
- Free trials/demos
- Customer testimonials
**Example:**
- "Try Our AI Code Assistant Free for 14 Days"
- "See How [Company] Increased Productivity by 10x"
Pillar 5: Link Building
Goal: Earn high-quality backlinks to boost authority
Link Building Strategies:
## 1. Content-Driven Link Building
### Create Linkable Assets
**Types:**
- Original research/data
- Comprehensive guides
- Tools/calculators
- Infographics
- Industry reports
**Example:**
"State of AI Coding in 2026" (annual report)
→ Gets linked by tech blogs, news sites
### Skyscraper Technique
**Process:**
1. Find popular content in your niche
2. Create something 10x better
3. Reach out to sites linking to original
4. Ask them to link to your improved version
**Example:**
- Find: "10 AI Coding Tools" (100 backlinks)
- Create: "50 AI Coding Tools Compared (2026)" (more comprehensive)
- Outreach: "Hey, I noticed you linked to [old article]. I created a more comprehensive version..."
## 2. Guest Posting
**Target sites:**
- Industry blogs (Dev.to, Hashnode, Medium)
- Tech publications (TechCrunch, The Verge)
- Company blogs (Stripe, Vercel, Netlify)
**Pitch template:**
Subject: Guest post idea: [Title]
Hi [Name],
I'm [Your Name], [Your Role] at [Company]. I've been following [Their Blog] and love your content on [Topic].
I'd like to contribute a guest post: "[Proposed Title]"
Outline:
- [Section 1]
- [Section 2]
- [Section 3]
This would provide value to your readers by [Benefit].
I've previously written for [Other Publications]. Here are some samples:
Would this be a good fit?
Thanks,
[Your Name]
## 3. Broken Link Building
**Process:**
1. Find broken links on relevant sites
2. Create content to replace broken link
3. Reach out to site owner
**Tools:**
- Ahrefs Site Explorer (find broken backlinks)
- Check My Links (Chrome extension)
**Outreach template:**
Subject: Broken link on [Page Title]
Hi [Name],
I was reading your article "[Title]" and noticed a broken link in the [Section] section.
The link to [Broken URL] returns a 404 error.
I recently published a similar resource that might be a good replacement:
[Your URL]
It covers [Topics] and includes [Unique Value].
Would you consider updating the link?
Thanks,
[Your Name]
## 4. Digital PR
**Tactics:**
- Press releases (product launches, funding)
- Expert quotes (HARO, SourceBottle)
- Podcast interviews
- Conference speaking
- Awards and recognition
**Example:**
- Submit to "Best AI Tools of 2026" lists
- Respond to journalist queries on HARO
- Speak at developer conferences
## 5. Partnership Link Building
**Tactics:**
- Integration partners (link exchange)
- Affiliate programs
- Co-marketing campaigns
- Sponsorships
**Example:**
- Partner with VS Code → Get listed in their marketplace
- Sponsor a developer conference → Get backlink from event site
Link Quality Metrics:
## Evaluating Backlink Quality
### High-Quality Backlinks
- **Domain Authority (DA):** 50+ (Ahrefs DR, Moz DA)
- **Relevance:** Same industry/niche
- **Traffic:** Site gets organic traffic
- **Editorial:** Naturally placed in content
- **Dofollow:** Passes link equity
### Low-Quality Backlinks (Avoid)
- **Spam sites:** Low DA, no traffic
- **Irrelevant:** Unrelated industry
- **Paid links:** Violates Google guidelines
- **Link farms:** Exist only for links
- **Sitewide links:** Footer/sidebar links
### Disavow Toxic Links
```bash
# Create disavow file
cat > disavow.txt << 'EOF'
# Spam site
domain:spamsite.com
# Specific bad link
http://badsite.com/page
EOF
# Submit to Google Search Console
# Search Console → Links → Disavow Links
---
## SEO Tools & Resources
```markdown
## Essential SEO Tools
### Free Tools
- **Google Search Console:** Monitor search performance
- **Google Analytics:** Track traffic and conversions
- **Google PageSpeed Insights:** Check site speed
- **Google Keyword Planner:** Keyword research
- **Bing Webmaster Tools:** Bing search data
- **Screaming Frog (free tier):** Site audits (500 URLs)
### Paid Tools
- **Ahrefs ($99+/mo):** Comprehensive SEO suite
- **SEMrush ($119+/mo):** Keyword research, competitor analysis
- **Moz Pro ($99+/mo):** Rank tracking, site audits
- **Surfer SEO ($59+/mo):** Content optimization
- **Clearscope ($170+/mo):** Content briefs
### Browser Extensions
- **MozBar:** See DA/PA on any page
- **Ahrefs SEO Toolbar:** Quick SEO metrics
- **Keywords Everywhere:** Keyword data in search results
- **Check My Links:** Find broken links
SEO Metrics to Track
## Key Performance Indicators
### Traffic Metrics
- **Organic traffic:** Visitors from search engines
- **Organic sessions:** Number of visits
- **Pages per session:** Engagement depth
- **Bounce rate:** % who leave immediately (target <50%)
- **Average session duration:** Time on site (target >2 min)
### Ranking Metrics
- **Keyword rankings:** Position in search results (target top 10)
- **Featured snippets:** Position 0 rankings
- **SERP visibility:** % of keywords ranking
- **Click-through rate (CTR):** % who click your result (target >5%)
### Conversion Metrics
- **Organic conversions:** Signups/purchases from organic traffic
- **Conversion rate:** % of visitors who convert (target >2%)
- **Goal completions:** Specific actions (downloads, trials)
- **Revenue from organic:** $ attributed to SEO
### Authority Metrics
- **Domain Authority (DA):** Moz's 0-100 score
- **Domain Rating (DR):** Ahrefs' 0-100 score
- **Backlinks:** Number of referring domains
- **Referring domains:** Unique sites linking to you
### Technical Metrics
- **Core Web Vitals:** LCP, FID, CLS, INP
- **Crawl errors:** Issues found by search engines
- **Index coverage:** % of pages indexed
- **Mobile usability:** Mobile-friendly issues
SEO Checklist
Technical SEO:
Keyword Research:
On-Page SEO:
Content Strategy:
Link Building:
Tracking:
Common SEO Mistakes
Mistake 1: Keyword Stuffing
Problem: Repeating keywords unnaturally
Solution: Use keywords naturally, focus on user experience
Mistake 2: Thin Content
Problem: Short, low-value pages (<300 words)
Solution: Create comprehensive content (1,500+ words)
Mistake 3: Duplicate Content
Problem: Same content on multiple pages
Solution: Use canonical tags, consolidate pages
Mistake 4: Ignoring Mobile
Problem: Site not mobile-friendly
Solution: Responsive design, test on mobile devices
Mistake 5: Slow Site Speed
Problem: Pages load slowly (>3 seconds)
Solution: Optimize images, use CDN, minify code
Mistake 6: No Internal Linking
Problem: Pages are isolated, no link structure
Solution: Link related content, create topic clusters
Integration with Other Skills
Use before SEO:
gtm-strategy - Understand target audiencecompetitor-analysis - Analyze competitor SEO
Use during SEO:
funnel-builder - Optimize conversion from organic trafficemail-campaign - Capture and nurture organic visitors
Use after SEO:
user-research - Understand visitor behaviorweb-performance - Improve Core Web Vitals
Remember: SEO is a long-term game. Results take 3-6 months. Focus on creating valuable content, building authority, and providing great user experience. Rankings will follow.
