Autonomous SEO Architect
Autonomous SEO Architect is a multi-host AI agent package for technical SEO audits and safe SEO code changes. It analyzes source code, inspects rendered DOM output with Vercel's agent-browser CLI, generates user-approved SEO strategy artifacts, applies framework-aware edits, and writes an exhaustive changelog report.
It is packaged for Codex, Claude Code, and Gemini CLI.
What It Does
- Ingests the packaged SEO research corpus in
intel/.
- Detects project stack and SEO ownership files across Next.js, React/Vite, static HTML, MDX/Markdown, XML sitemaps, robots.txt, and common config files.
- Uses
agent-browser snapshot -i and agent-browser eval --stdin for rendered DOM inspection.
- Runs competitor keyword gap analysis from user-provided exports, SERP exports, seed keywords, or approved competitor URL snapshots.
- Distinguishes business competitors from true SERP competitors and maps missing/weak/shared/unique/cannibalized/decayed keyword gaps.
- Audits website load speed with LCP, TTFB, CLS, INP risk, render-blocking resources, image sizing, font loading, third-party scripts, and hydration-cost evidence.
- Mines user-provided Google Search Console exports for high-impression/low-CTR queries, striking-distance keywords, cannibalization, decays, and page-query mismatch.
- Scores internal link graph opportunities: orphan risk, click depth, hub/spoke support, anchor diversity, and priority-page flow.
- Audits AI search readiness for answer extraction, entity disambiguation, schema support, trust signals, and citation-friendly structure.
- Ships stdlib-only evidence scripts for crawling, rendered DOM collection, GSC import, competitor keyword import, PageSpeed/CrUX, JSON-LD validation, log analysis, opportunity scoring, and monitoring snapshots.
- Includes industry playbooks for SaaS, ecommerce, local, publisher/blog, marketplace, international, and programmatic SEO.
- Requires approval after
project_manifesto.md and again after seo_dynamic_checklist.md.
- Uses filesystem MCP plus AST-aware MCP for safe source reads, diffs, metadata insertion, and validation.
- Checks rendered metadata, canonicals, robots directives, headings, alt text, JSON-LD, internal links, mobile parity, Core Web Vitals evidence, and semantic content gaps.
- Produces
.seo-agent/state.json, project_manifesto.md, seo_competitor_keyword_analysis.md, seo_performance_audit.md, seo_dynamic_checklist.md, seo_opportunities.json, and seo_changelog_report.md.
Safety Model
The skill runs in four phases:
- Project Analysis and Manifesto Generation
Generates
project_manifesto.md, then pauses for user approval.
- Deep SEO Audit and Dynamic Checklist
Generates
seo_dynamic_checklist.md, then pauses for user approval.
- Safe Code Execution
Applies only approved checklist items with narrow diffs and AST-aware edits.
- Validation and Reporting
Reopens changed pages with
agent-browser and writes seo_changelog_report.md.
The included guard blocks project-code edits until the Phase 2 checklist is approved and blocks Playwright/Puppeteer usage because rendered DOM work must use agent-browser.
Repository Layout
.
|-- .claude-plugin/
| |-- marketplace.json # Claude Code marketplace catalog
| `-- plugin.json # Claude Code plugin manifest
|-- .codex-plugin/plugin.json # Codex plugin manifest
|-- .github/workflows/validate.yml # Public repo validation workflow
|-- .mcp.json # Codex/default MCP bindings
|-- configs/monitoring.example.json # Monitoring mode example config
|-- gemini-extension.json # Gemini CLI extension manifest
|-- GEMINI.md # Gemini CLI extension context
|-- SKILL.md # Root skill document
|-- hooks.json # Codex/compatible companion hook manifest
|-- hooks/
| |-- hooks.json # Claude Code native hook config
| |-- seo-phase-gate.ps1 # Windows hook wrapper
| `-- seo-phase-gate.sh # POSIX hook wrapper
|-- intel/ # SEO research corpus
|-- mcp/claude.mcp.json # Claude Code MCP bindings
|-- playbooks/industry/ # Industry-specific SEO modules
|-- schemas/ # Hook, state, import, and opportunity schemas
|-- scripts/
| |-- analyze_server_logs.py
| |-- build_internal_link_graph.py
| |-- collect_pagespeed_crux.py
| |-- collect_rendered_seo.py
| |-- collect_static_seo.py
| |-- import_competitor_keywords.py
| |-- import_gsc.py
| |-- monitor_seo.py
| |-- register_personal_marketplace.py
| |-- score_opportunities.py
| |-- seo_state_guard.py
| |-- validate_structured_data.py
| `-- validate_package.py
`-- skills/autonomous-seo-architect/SKILL.md
Requirements
- Node.js and
npx.
- Python 3.10+.
- Vercel
agent-browser CLI:
