🐝 SEO SWARM — Autonomous SEO Swarm Agents CLI

⚡ Quick Install

# npm (recommended)
npm install -g seo-swarm

# yarn
yarn global add seo-swarm

# pnpm
pnpm add -g seo-swarm

# bun
bun install -g seo-swarm

# deno
deno install -g npm:seo-swarm

# cnpm
cnpm install -g seo-swarm

# Python (pip)
pip install seo-swarm

# Volta
volta install seo-swarm

# Rush
rush add -p seo-swarm

# Lerna
lerna add seo-swarm

🚀 Quick Start

# Run a full SEO audit on any website
seo-swarm audit https://example.com

# Run all 10 agents in parallel swarm mode
seo-swarm swarm https://example.com

# Run a specific agent
seo-swarm agent technical-seo --url https://example.com

# Launch interactive terminal dashboard
seo-swarm dashboard

# View agent ASCII art cards
seo-swarm agents --art

# Install 30+ preloaded SEO skills
seo-swarm install-skills

# Autonomous browser control
seo-swarm browser https://example.com --task extract-meta

# Get JSON output
seo-swarm audit https://example.com --json

🧠 What is SEO SWARM?

SEO SWARM is an autonomous multi-agent SEO automation platform that deploys 10 specialized AI agents working in parallel to audit, analyze, and optimize search engine performance. Each agent has unique skills, ASCII art profiles, and color-coded status indicators — all visible in a beautiful terminal UI.

🎯 Core Philosophy

"Don't run one SEO tool. Run a SWARM of 10 specialized SEO agents in parallel."

🐝 The 10 SEO Agents

| # | Agent | Emoji | Role | Color | |---|-------|-------|------|-------| | 1 | SEO Strategist | 🧠 | Strategy & Roadmap | Cyan | | 2 | Technical SEO Specialist | 🔧 | Site Architecture & Crawling | Green | | 3 | Content SEO Specialist | ✍️ | Content Strategy & Optimization | Magenta | | 4 | On-Page SEO Analyst | 🔍 | Page Element Auditing | Yellow | | 5 | Off-Page SEO Specialist | 🔗 | Link Building & Authority | Blue | | 6 | Local SEO Specialist | 📍 | Geo & Local Search | Red | | 7 | SEO Developer | 💻 | Code-Level Implementation | White | | 8 | SEO Data Analyst | 📊 | Analytics & Reporting | Cyan | | 9 | Voice Search Specialist | 🎙️ | Voice & Conversational SEO | Magenta | | 10 | Mobile & PWA SEO Specialist | 📱 | Mobile-First & PWA | Green |

Agent Preview (terminal)

  ┌──────────────────────────────────────────────────────────────┐
  │  🔧 Technical SEO Specialist                                  │
  │  ────────────────────────────────────────                     │
  │  Role: Technical SEO & Site Architecture                     │
  │  Status: ● Active                                             │
  │  Tasks: 15 completed                                          │
  │  Skills: site-audit, crawl-analysis, schema-markup           │
  └──────────────────────────────────────────────────────────────┘

✨ Features

🔬 Core Features

• Automated Technical SEO Audits — Comprehensive crawl analysis, indexation checks, page speed metrics
• Intelligent Keyword & Intent Discovery — AI-powered keyword research with intent classification
• Content Gap Analysis & Briefing — Identify missing content opportunities vs competitors
• On-Page Optimization Engine — Title tags, meta descriptions, headers, alt text, internal linking
• Autonomous Backlink Prospecting & Outreach — Ethical link building with automated prospecting
• Local Presence Management — Google Business Profile, NAP consistency, local citations
• Structured Data & Schema Generation — Auto-generate JSON-LD schema markup for rich results
• Voice Search Content Optimization — FAQ schema, conversational queries, featured snippets
• Cross-Platform Performance Monitoring — Track SEO across web, mobile, and PWA platforms
• Self-Healing SEO Pipelines — Auto-detect and fix common SEO issues without manual intervention

🧠 Intelligence

• Self-Improving Memory System — Learns from every audit and improves over time
• Local + Cloud Memory — Persistent storage with hybrid architecture
• Pattern Recognition — Detects recurring SEO patterns and automates fixes
• Confidence Scoring — Each recommendation comes with a confidence rating

🎨 Terminal UI

• Beautiful ASCII Art Banners — Custom-designed agent profile cards
• Color-Coded Status — Each agent has unique color palette
• Progress Indicators — Real-time swarm progress visualization
• Interactive Dashboard — Navigate agents, view results, manage skills
• One-Line ASCII Emoticons — Compact status icons from 1lineart.kulaone.com

🔌 Browser Automation

• 10 Browser Skills Preloaded — Browser Use, Skyvern, Stagehand, Scrapling, LaVague, and more
• Autonomous Page Navigation — Crawl, extract, screenshot without manual control
• Meta Data Extraction — Title, description, OG tags, Twitter cards
• Performance Auditing — LCP, FID, CLS, TTFB metrics
• Mobile-Friendly Checks — Viewport, touch targets, font sizes

📦 30+ Preloaded SEO Skills

| Skill | Category | Source | |-------|----------|--------| | SEO Audit Skill | audit | seo-skills | | Claude SEO | analysis | AgricIDaniel | | Tech SEO Audit | technical | Suganthan-Mohanadasan | | Ecommerce SEO Audit | ecommerce | affilino | | Local SEO Skills | local | garrettjsmith | | Citedy SEO Agent | content | citedy | | Agentic SEO Skill | analysis | Bhanunamikaze | | Ultimate SEO + GEO | comprehensive | mykpono | | Agentkit SEO (ACO) | aco | agentkit-seo | | Agentic SEO (AEO) | aeo | addyosmani |

PLUS: 10 Browser Automation skills + 20+ additional SEO plugins

📊 Commands Reference

seo-swarm audit <url>                     # Full SEO audit with all agents
seo-swarm audit <url> --agents tech,local # Run specific agents
seo-swarm audit <url> --json              # JSON output for CI/CD

seo-swarm swarm <url>                     # Parallel swarm mode (all 10 agents)
seo-swarm agent <name> --url <url>        # Run single agent
seo-swarm agent <name> --url <url> -v     # Verbose output

seo-swarm browser <url>                   # Launch autonomous browser
seo-swarm browser <url> --task crawl-site # Specific browser task

seo-swarm dashboard                       # Interactive terminal dashboard
seo-swarm agents                          # List all agents
seo-swarm agents --art                    # ASCII art agent cards

seo-swarm install-skills                  # Install preloaded SEO skills
seo-swarm skills                          # List installed skills
seo-swarm skills --search "technical"     # Search skills

seo-swarm memory "keyword research"       # Search memory database

🏗️ Architecture

seo-swarm/
├── cli.js                          # Node.js CLI entry (npm bin)
├── package.json                    # npm package config
├── pyproject.toml                  # Python package config
├── README.md                       # You are here
├── CHANGELOG.md                    # Release history
├── CONTRIBUTING.md                 # Contribution guide
├── LICENSE                         # MIT License
├── src/
│   └── seo_swarm/
│       ├── __init__.py             # Package init
│       ├── cli.py                  # Python CLI entry point
│       ├── agents/
│       │   ├── registry.py         # 10 agent definitions + metadata
│       │   └── orchestrator.py     # Swarm parallel execution engine
│       ├── tui/
│       │   └── dashboard.py        # Rich terminal UI dashboard
│       ├── ascii/
│       │   └── banners.py          # ASCII art + agent profile cards
│       ├── memory/
│       │   └── engine.py           # Self-improving SQLite memory
│       ├── skills/
│       │   └── loader.py           # 30+ preloaded skill definitions
│       └── browser/
│           └── engine.py           # Autonomous browser automation
├── skills/                         # Bundled skill definitions
├── scripts/
│   ├── install.sh                  # curl pipe-to-bash installer
│   └── install.ps1                 # PowerShell installer
├── tests/
│   ├── test_cli.py
│   ├── test_agents.py
│   └── test_memory.py
└── .github/
    ├── workflows/
    │   └── publish.yml             # Auto-publish to npm + PyPI
    ├── ISSUE_TEMPLATE/
    │   ├── bug_report.md
    │   └── feature_request.md
    └── pull_request_template.md

🔧 11 Installation Methods

| Package Manager | Command | Registry | |----------------|---------|----------| | npm | npm install -g seo-swarm | npmjs.com | | yarn | yarn global add seo-swarm | npmjs.com | | pnpm | pnpm add -g seo-swarm | npmjs.com | | bun | bun install -g seo-swarm | npmjs.com | | deno | deno install -g npm:seo-swarm | npmjs.com | | cnpm | cnpm install -g seo-swarm | npmmirror.com | | Rush | rush add -p seo-swarm | npmjs.com | | Lerna | lerna add seo-swarm | npmjs.com | | Volta | volta install seo-swarm | npmjs.com | | pip | pip install seo-swarm | pypi.org | | uv | uv pip install seo-swarm | pypi.org |

One-Line Installer

curl -fsSL https://raw.githubusercontent.com/uthumany/seo-swarm/main/scripts/install.sh | bash

From Source

git clone https://github.com/uthumany/seo-swarm
cd seo-swarm
npm install -g .
# OR
pip install -e .

🌍 Compatibility

🤖 Autonomous Agentic AI Agents (15 tools)

Google Antigravity · Manus · Hermes Agent · OpenManus · Open-Agent · agenticSeek · Open Human · OWL · OpenHands · Lemon AI · GWL · Oclai · AiPy · Pi.dev · Codex

⌨️ CLI Autonomous Agents (15 tools)

Gemini CLI · OpenCLI · OpenClaw · OpenCode · QWEN Code · Aider · Warp · Claude Code · Crush · Amp · Goose · Droid · OWL CLI · agenticSeek CLI · Codex CLI

🖥️ IDE Autonomous Agents (15 tools)

VS Code · Cline · Claude Code · Aider · OpenHands · OpenCode IDE · QWEN Code Studio · Codex IDE · Gemini Code Assist · DeepSeek IDE · Warp IDE · Amp IDE · Crush IDE · Goose IDE · Droid Studio

🌐 Web Autonomous Agents (15 tools)

lovable.dev · DeepSeek GUI · Pi.dev · OpenManus Web · Open-Agent Web · agenticSeek Web · Lemon AI Web · Oclai Web · Open Human Web · OWL Web · OpenHands Web · browser-use · GWL Web · Manus Web · Google Antigravity Web

Total: 60+ AI Agent Platform Compatible

🎨 ASCII Art Credits

• Terminal ASCII Art banners from coddy.tech ascii art generator
• Special characters from fsymbols.com/text-art
• Single-line emoticons from 1lineart.kulaone.com
• TUI design components inspired by tui.builders/templates

📄 Changelog

See CHANGELOG.md for the full release history.

v1.0.0 (Initial Release)

• 10 specialized SEO agents with ASCII art profiles
• Parallel swarm execution engine
• Self-improving memory system (SQLite)
• Terminal UI dashboard with colors
• 30+ preloaded SEO skills
• 10 browser automation skills
• 11 package manager installation methods
• Full documentation suite

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

1. Fork the repository
2. Create your feature branch (git checkout -b feat/amazing-feature)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to the branch (git push origin feat/amazing-feature)
5. Open a Pull Request

📋 Roadmap

• [ ] Real Playwright/Selenium browser integration
• [ ] Cloud memory synchronization (Supabase/Firebase)
• [ ] Web dashboard for remote monitoring
• [ ] CI/CD pipeline templates (GitHub Actions, GitLab CI)
• [ ] Slack/Discord/Telegram notifications
• [ ] Google Search Console API integration
• [ ] Ahrefs/SEMrush API connectors
• [ ] AI-generated SEO content briefs
• [ ] Automated PR submission for found issues
• [ ] Multi-language content optimization

🛡️ Security

Found a security issue? Please email [email protected] instead of opening a public issue.

📞 Support & Community

• GitHub Issues: github.com/uthumany/seo-swarm/issues
• Email: [email protected]
• Twitter/X: @uthumanco
• GitHub: @uthumany

📜 License

MIT License — see LICENSE for full text.