Skip to content

TheWayWithin/SEO-AGENT

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

25 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

SEO Agent Library

Elite SEO Agent Suite for Business Growth

Transform your SEO from fragmented chaos into coordinated intelligence. The SEO Agent Library deploys a team of AI specialists with advanced context preservation that work 24/7 to dominate search rankings.

๐Ÿ†• Recent Enhancements

BOS-AI Context Preservation System - Revolutionary context sharing between agents:

  • 50-70% reduction in information loss between agents
  • 100% mandatory context preservation compliance
  • Real-time mission tracking with evidence repository
  • Advanced handoff protocols for seamless agent coordination
  • 4 specialized templates for mission state management

๐Ÿš€ Quick Start

Deploy your SEO squad in under 5 minutes:

curl -sSL https://raw.githubusercontent.com/TheWayWithin/SEO-AGENT/main/install.sh | bash

๐ŸŽฏ What You Get

7 Elite SEO Agents with advanced context preservation:

  • ๐ŸŽฏ Strategist - Orchestrates priorities and competitive intelligence
  • ๐Ÿ”ง Technical - Maintains site health and Core Web Vitals
  • ๐Ÿ“ Content - Optimizes content for maximum visibility
  • ๐Ÿ” Researcher - Discovers keyword opportunities
  • ๐Ÿ“Š Analyst - Tracks performance and ROI
  • ๐Ÿ”— Builder - Builds authority through strategic outreach
  • ๐ŸŽ–๏ธ Coordinator - Manages missions with context enforcement

Enhanced Agent Capabilities:

  • Mandatory context reading before task execution
  • Real-time progress sharing via evidence repository
  • Advanced handoff protocols between specialists
  • 100% compliance tracking and enforcement

Predefined Missions for instant results:

  • site-audit - Comprehensive SEO analysis (60 min)
  • content-gap - Content opportunity discovery (2-4 hours)
  • technical-fix - Performance optimization (4-8 hours)
  • keyword-research - Market intelligence (2-4 hours)
  • ai-search-optimize - Future-proof optimization (1-3 days)

๐ŸŽฎ Command Center

Mission Control

/coord                    # Interactive mission launcher
/coord site-audit         # Comprehensive SEO audit
/coord content-gap        # Content opportunity analysis
/coord technical-fix      # Technical issue resolution
/coord keyword-research   # Keyword opportunity discovery

Agent Communication

/meeting @strategist "quarterly planning"
/meeting @technical "site speed issues"
/meeting @content "editorial calendar"
/meeting @researcher "keyword opportunities"

Advanced Tracking & Context Management

# Progress Tracking with Context Preservation
/track baseline domain.com    # Capture initial metrics
/track snapshot domain.com    # Record current performance
/track compare domain.com     # Before/after comparison
/track roi domain.com 90d     # Calculate ROI with financials
/track context               # Monitor context preservation compliance

# Enhanced Reporting & Analysis
/report                   # Full project progress report with context data
/report 2025-08-20       # Report since specific date
/pmd                     # Analyze recent failures (root cause)
/pmd "specific issue"    # Diagnose specific problem
/report weekly           # Weekly performance summary
/report monthly          # Monthly strategic review
/report context          # Context preservation compliance report
/rankings                # Current ranking positions
/traffic-report          # Traffic analysis with conversions

Evidence Template

# Available in /templates/ for mission customization:
seo-evidence-template.md     # Shared evidence repository (Constitution rule 1)

The previous four-template context-preservation system was retired in Sprint 3 (see progress.md). Mission state lives in agent-context.md; SEO findings live in seo-evidence.md.

Mission Deliverables (Sprint 5)

Every SEO mission writes named deliverables into a run-scoped directory under runs/:

runs/YYYY-MM-DD-<domain-slug>-<mission>[-<mode>]/
  analysis.md       # Prioritised fix list with ROI (always)
  marketing.md      # Before/after framing for case studies (when applicable)
  data.json         # Structured AImpactScanner ingestion (always)

Templates live in templates/deliverables/ โ€” see templates/deliverables/README.md for the full contract and the JSON Schema (aimpactscanner-data.schema.json) that data.json validates against.

๐Ÿ“ˆ Expected Results

  • 25-50% organic traffic growth within 90 days
  • 95%+ Core Web Vitals pass rate for technical excellence
  • 3x faster content optimization cycles
  • 70% reduction in SEO operational costs
  • 50-70% reduction in information loss between agents
  • 100% context preservation compliance across all missions
  • Real-time mission visibility and progress tracking

๐Ÿ”ง Setup Requirements

Essential Integrations

  • Google Search Console (required)
  • Google Analytics 4 (required)
  • SEO platform (Ahrefs, SEMrush, or Moz)

Optional Integrations

  • WordPress/Shopify for CMS optimization
  • Screaming Frog for technical auditing
  • Content optimization tools

๐Ÿ“š Documentation

๐Ÿ—๏ธ Architecture

The SEO Agent Library uses Claude Code's sub-agent system with:

  • Project-local deployment for business context isolation
  • Mission-based workflows with time-boxed operations
  • Hub-and-spoke coordination preventing agent chaos
  • Advanced context preservation with BOS-AI patterns
  • Progress tracking system for ROI measurement and reporting
  • Specific tool assignments for optimal performance

Context Preservation Architecture:

  • Layer 1: Mandatory agent protocols for context reading/writing
  • Layer 2: Coordinator enforcement with compliance validation
  • Layer 3: Mission state management with evidence repository
  • Three-phase flow: Initialize โ†’ Execute โ†’ Validate context at boundaries

Each agent has carefully curated Claude Code tools and mandatory context protocols to prevent information loss and performance degradation.

๐ŸŽฏ Use Cases

SEO Agent Work Optimization

Ready-to-deploy configuration for www.seoagent.work:

  • Technical SEO audit and fixes
  • Content gap analysis for SEO topics
  • Keyword research for SEO categories
  • AI search optimization for llms.txt

Local Business Domination

Specialized configuration for local SEO:

  • Google Business Profile optimization
  • Local citation building
  • Review management automation
  • Geographic content strategy

E-commerce Growth

Product-focused optimization suite:

  • Product page optimization
  • Category architecture planning
  • Shopping feed optimization
  • Marketplace SEO strategies

๐Ÿค Contributing

The SEO Agent Library is designed for immediate business use. Contributions welcome for:

  • Additional mission templates
  • New agent specializations
  • Integration improvements
  • Documentation enhancements

๐Ÿ“„ License

MIT License - Use for personal and commercial projects.

๐Ÿ†˜ Support


Transform your SEO from struggle to success. Deploy the SEO Agent Library today.

About

SEO Agent Library for automating and managing SEO for a domain

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors