mcpField
C
claude-seo-workflows

claude-seo-workflows

github.com/composio-communityMarketing & growth1443 installsUpdated 23w ago
Repository

About claude-seo-workflows

A Claude skill for SEO work on websites, blogs, landing pages, and developer content. It combines search-intent and keyword research with content structure, metadata, technical SEO, and internal linking, emphasizing readable material over keyword stuffing.

Key features

  1. 01Search-intent analysis
  2. 02Keyword research
  3. 03Content structure optimization
  4. 04Metadata recommendations
  5. 05Technical SEO checks
  6. 06Internal linking strategy

Use cases

  1. 01Plan SEO-focused blog content
  2. 02Optimize a landing page
  3. 03Review technical SEO and metadata
  4. 04Build connected topic content

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/composio-community/opencode-skills --skill claude-seo-workflows

After installing, type/claude-seo-workflowsin Claude Code to confirm it loaded.

Details

From the project README

Claude SEO Workflows

Overview

This skill enables Claude to assist with comprehensive SEO workflows for websites, blogs, landing pages, and developer-focused content.

The workflow focuses on:

  • keyword research
  • search intent analysis
  • technical SEO
  • content structure optimization
  • metadata generation
  • internal linking strategy
  • search-focused writing
  • scalable content workflows

The goal is to create content and site structures that:

  • rank effectively
  • match user intent
  • remain readable and useful
  • avoid low-quality AI-generated SEO patterns

This workflow prioritizes high-quality, human-readable content over keyword stuffing or outdated SEO tactics.


Setup

Before starting:

  1. Define the target website or content category.

  2. Identify:

  • audience
  • search intent
  • competitors
  • content goals
  1. Gather:
  • existing content
  • analytics data (optional)
  • target keywords
  • product/service information

Recommended tools:

  • Google Search Console
  • Ahrefs
  • SEMrush
  • Screaming Frog
  • Google Trends
  • Markdown editors
  • CMS platforms

Optional:

  • Existing SEO reports
  • Competitor analysis
  • Analytics dashboards

Inputs Required

  • Topic or keyword targets
  • Audience profile
  • Existing content or URLs
  • Website structure
  • Product or service information

Optional:

  • Competitor pages
  • Search Console data
  • Technical SEO audit data

When to Use This Skill

Use this skill when:

  • planning SEO content
  • optimizing landing pages
  • improving technical SEO
  • generating blog content
  • researching keywords
  • improving search visibility
  • structuring content for ranking
  • building scalable SEO workflows

When NOT to Use

Do NOT use this skill for:

  • keyword stuffing
  • spam-style SEO automation
  • low-quality bulk content generation
  • misleading ranking manipulation
  • black-hat SEO tactics

Example Use Case

Optimize a developer tools landing page for AI workflow automation keywords.

Claude should:

  1. Research search intent
  2. Identify high-value keywords
  3. Structure content around user problems
  4. Improve metadata and headings
  5. Optimize readability
  6. Add internal linking opportunities
  7. Improve technical SEO structure

Final result should:

  • target real search intent
  • remain human-readable
  • improve discoverability
  • support long-term SEO growth
  • avoid generic AI-generated writing

Core SEO Principles

1. Prioritize Search Intent

Good SEO begins with understanding:

  • why users search
  • what users expect
  • what problems users want solved

Claude should optimize for:

  • usefulness
  • relevance
  • clarity
  • intent satisfaction

Avoid:

  • keyword stuffing
  • shallow content
  • generic filler text

Content that satisfies intent performs better long-term.


2. Write for Humans First

SEO content should remain:

  • readable
  • useful
  • well-structured
  • engaging

Claude should avoid:

  • robotic phrasing
  • repetitive keyword insertion
  • unnatural headings
  • over-optimized copy

Good SEO content should feel:

  • natural
  • authoritative
  • trustworthy
  • helpful

3. Build Strong Content Structure

Good content structure improves:

  • readability
  • crawlability
  • ranking potential
  • user engagement

Recommended structure:

  • clear headings
  • logical sections
  • concise paragraphs
  • strong introductions
  • scannable formatting

Claude should:

  • organize information clearly
  • maintain logical flow
  • improve readability continuously

4. Optimize Metadata Properly

Metadata strongly affects:

  • click-through rates
  • search visibility
  • page relevance

Optimize:

  • title tags
  • meta descriptions
  • heading hierarchy
  • image alt text
  • structured data opportunities

Avoid:

  • duplicate metadata
  • vague titles
  • keyword stuffing

5. Improve Technical SEO

Technical SEO improves:

  • crawlability
  • indexing
  • performance
  • user experience

Claude should help identify:

  • slow-loading pages
  • broken links
  • poor heading structure
  • duplicate content
  • missing metadata
  • weak internal linking

Technical quality affects long-term ranking stability.


6. Build Topical Authority

Strong SEO systems focus on:

  • topic depth
  • content relationships
  • internal linking
  • consistent expertise

Claude should help create:

  • content clusters
  • supporting articles
  • semantic keyword coverage
  • connected content ecosystems

Authority compounds over time.


Workflow

1. Analyze Search Intent

Start by identifying:

  • target audience
  • search motivation
  • competitor positioning
  • expected content depth

Determine whether intent is:

  • informational
  • transactional
  • navigational
  • commercial investigation

Content structure should adapt to intent.


2. Research Keywords

Identify:

  • primary keywords
  • secondary keywords
  • semantic variations
  • long-tail opportunities

Prioritize:

  • relevance
  • realistic ranking opportunities
  • intent alignment

Avoid:

  • chasing irrelevant high-volume keywords
  • over-optimizing low-quality traffic

3. Structure the Content

Create:

  • heading hierarchy
  • section flow
  • internal linking opportunities
  • supporting subsections

Good structure improves:

  • readability
  • ranking potential
  • engagement
  • crawlability

4. Optimize Content Quality

Claude should:

  • improve clarity
  • remove fluff
  • strengthen explanations
  • add useful examples
  • improve readability

Focus on:

  • expertise
  • usefulness
  • specificity
  • depth

Avoid:

  • repetitive phrasing
  • generic filler
  • unnecessary keyword repetition

5. Improve Technical SEO

Validate:

  • metadata quality
  • heading structure
  • URL structure
  • internal linking
  • image optimization
  • mobile readability

Ensure:

  • pages remain crawlable
  • structure stays logical
  • content loads efficiently

6. Build Internal Linking Strategy

Identify:

  • related pages
  • supporting content
  • topical relationships

Good internal linking improves:

  • crawl efficiency
  • authority flow
  • content discoverability

Avoid:

  • isolated pages
  • excessive linking
  • irrelevant anchor text

7. Final Validation

Before publishing validate:

  • readability
  • keyword alignment
  • metadata quality
  • search intent satisfaction
  • technical SEO structure

Ensure:

  • the content feels human-written
  • structure remains clean
  • SEO supports usability rather than hurting it

Output Expectations

The final output should include:

  • optimized SEO structure
  • search-focused content
  • metadata recommendations
  • keyword strategy
  • internal linking opportunities
  • technically sound page structure

The workflow itself should remain:

  • scalable
  • maintainable
  • human-readable
  • search-intent focused
  • production-ready

Execution Strategy (for AI agents)

The agent should:

  1. Prioritize search intent over keyword density
  2. Keep content human-readable
  3. Improve technical SEO continuously
  4. Structure content clearly
  5. Build topical authority strategically
  6. Optimize for long-term search performance

The workflow should optimize for:

  • discoverability
  • usability
  • ranking stability
  • readability
  • topical authority

Best Practices

  • Write for humans first
  • Use clear heading structures
  • Avoid keyword stuffing
  • Improve readability aggressively
  • Build internal linking intentionally
  • Optimize metadata carefully
  • Focus on topical authority over isolated pages

Notes

  • Search intent matters more than raw keyword density
  • Readable content consistently outperforms robotic SEO writing
  • Technical SEO compounds over time
  • Strong internal linking improves authority distribution
  • SEO works best when usability and discoverability align

Comments

Markdown supported