Antigravity SEO & GEO Suite

An SEO and Generative Engine Optimization (GEO) suite for Google Antigravity, powered by Go.

[!NOTE] Lineage: Inspired by claude-seo by Daniel Agrici. Antigravity SEO replaces Python/Playwright runtimes with a single Go binary (seo-engine) and native agent tools (search_web, read_url_content).

---

claude-seo + Claude Opus 5 vs. antigravity-seo + Gemini 3.8 Flash

Pricing based on September 2026 rates. Multi-agent crawls fan out to flash_lite subagents for penny-scale execution.

Key Architectural Differences

1. Token Economics: Claude Opus 5 thinking traces bill at $25/1M, making multi-page audits costly ($4–$8+). Gemini 3.8 Flash ($0.75 / $3.75) cuts costs by 85–90% (~$0.60), while flash_lite subagent swarms handle raw crawling for <$0.15.
2. Zero-Dependency Go Engine: seo-engine is a standalone binary with 10ms execution, eliminating Python venvs, pip modules, and headless browser daemons.
3. Native Grounding: Live Google SERP analysis and markdown extraction use Antigravity's built-in search_web and read_url_content without paid third-party MCPs.
4. Built-in GSC & Backlinks: Direct RSA/PKCS8 JWT authentication for Google Search Console and keyless Common Crawl CDX index lookups.
5. Native A4 PDF Reports: Built-in PDF report generation (--pdf) via fpdf matching executive print standards with zero external dependencies.

---

Architecture

flowchart LR
    User([User]) --> Skills["21 Antigravity Skills\nAudit • Schema • Content • GEO • Backlinks"]
    Skills --> Engine["Go Engine (seo-engine)\nFast audits, crawler, GSC, & PDF generation"]
    Skills --> Native["Native Grounding\nsearch_web & read_url_content"]
    Engine --> Output["Deliverables\nCLI • JSON • Enterprise A4 PDF"]

---

Installation

One-Line Install (Recommended)

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/angelotc/antigravity-seo/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/angelotc/antigravity-seo/main/install.ps1 | iex

Installs the plugin to ~/.gemini/config/plugins/antigravity-seo and symlinks seo-engine into your PATH.

Install from Source

git clone https://github.com/angelotc/antigravity-seo.git
cd antigravity-seo
bash install.sh          # On Windows: powershell -ExecutionPolicy Bypass -File install.ps1

Verify anytime with:

seo-engine doctor

---

Commands

All commands support --json. Core audit features are 100% keyless.

---

Skills (21)

• Orchestration: seo, seo-audit, seo-page
• Technical & Content: seo-technical, seo-content, seo-schema, seo-geo, seo-images, seo-hreflang, seo-drift, seo-backlinks
• Search & Local: seo-local, seo-maps, seo-ecommerce, seo-cluster, seo-sxo
• Strategy: seo-plan, seo-programmatic, seo-competitor-pages, seo-content-brief, seo-flow

The plugin also includes a PostToolUse schema hook that automatically validates JSON-LD files upon write, blocking deprecated schemas and placeholder text.

---

Universal Shell / CLI Integration

The engine and skills run 100% natively via standard shell execution (seo-engine <command> [options] <url> --json) with zero MCP middleware. Simply ensure seo-engine is in your $PATH (or run install.sh).

• Antigravity: Native execution via run_command
• OpenCode: Register skills path in opencode.json:

  "skills": {
    "paths": ["~/.gemini/config/plugins/antigravity-seo/skills"]
  }
  

• Claude Code: Symlink or copy skills into ~/.claude/skills/
• Codex / Cursor / Aider: Invoke seo-engine directly via the terminal / bash tool

---

Upstream Parity vs claude-seo

---

License

MIT — see LICENSE.