Docs

RankSurge Docs

RankSurge setup and reference docs for MCP, AI clients, agent skills, and self-hosting. RankSurge is built on the open-source OpenSEO project (MIT).

Set up RankSurge MCP

Connect RankSurge MCP to Claude, Codex, and other AI clients.

RankSurge Agent Skills

Add RankSurge Agent Skills to Claude Code, Codex, or another AI agent so it can run repeatable SEO workflows with live RankSurge data.

Agent setup

Connect your AI agent to OpenSEO and keep its SEO skills up to date.

Install the RankSurge plugin for Claude Code

Add RankSurge MCP and Agent Skills to Claude Code with one marketplace and one install command.

Install the RankSurge plugin for Codex

Add RankSurge MCP and Agent Skills to Codex with one marketplace and one install command.

Self-Hosting RankSurge

Run RankSurge yourself with Docker or Cloudflare, bring your own DataForSEO API key, and pay only for what you use.

Competitive Landscape Agent Skill

Run competitive SEO research with your AI agent: map market leaders, content patterns, keyword coverage, backlinks, and gaps.

Competitor Analysis Agent Skill

Analyze one competitor's keywords, pages, backlinks, content themes, and SEO gaps with your AI agent.

Keyword Clustering Agent Skill

Cluster keywords by intent and map them to existing or proposed pages with your AI agent.

Keyword Research Agent Skill

Find keyword opportunities from live SEO data with Claude Code, Codex, or another AI agent.

Link Prospecting Agent Skill

Find relevant link prospects from SERPs, competitor backlinks, and topical publishers with your AI agent.

Local SEO Agent Skill

Audit a Google Business Profile, compare it to local competitors, and map Google Maps visibility around a location with your AI agent.

SEO Audit Agent Skill

Audit a website with your AI agent and understand its important SEO problems, worthwhile improvements, and likely effects on traffic and the business.

SEO Coach Agent Skill

Learn SEO basics, choose the right workflow, and decide what to do next with your AI agent.

SEO Project Setup Agent Skill

Interview once and save your site's goals, positioning, competitors, and key pages to your RankSurge project context.

SEO Report Agent Skill

The report-writing skill every OpenSEO workflow delivers through: one self-contained HTML page, saved to your project, readable and printable by anyone.

Set up RankSurge Agent Skills

Add RankSurge skill files to your AI agent after connecting RankSurge MCP.

Cloudflare Self-Hosting

Deploy RankSurge to your own Cloudflare account for internet-facing, multi-device, or team use.

Docker Self-Hosting

Run RankSurge locally with Docker Compose using the published GHCR image.