AdvisorSEO for Claude

Get found in Google and in AI assistants, with controls your security team can check. AdvisorSEO checks whether AI crawlers can read your site, audits it, picks the pages most worth winning, and changes nothing on your site until you approve a preview. Controls: sign-in is OAuth 2.1 (authorization code with PKCE S256 and dynamic client registration, so no key is ever pasted), tokens carry the scopes mcp:tools and mcp:read, every site write needs your approval in a separate turn, and the data-handling table below lists every place your data goes. Every result it reports comes with n and an interval, or the words "insufficient data".

This repository is the AdvisorSEO plugin for Claude Code, claude.ai and Claude Desktop. It bundles the AdvisorSEO connector (https://mcp.advisorseo.ai/mcp) and eleven skills that know how to use it well.

Why: one install gives Claude both the connector and the know-how, so the first answer is a useful one and no change reaches a live site without your yes.

Install

Claude Code 2.1.275 or later, inside a session:

/plugin install advisorseo --marketplace advisorppc-org/advisorseo-claude-plugin

From a shell:

claude plugin install advisorseo --marketplace advisorppc-org/advisorseo-claude-plugin

Two steps, for older Claude Code versions:

/plugin marketplace add advisorppc-org/advisorseo-claude-plugin
/plugin install advisorseo@advisorseo

Connector only, without the skills:

claude mcp add --transport http advisorseo https://mcp.advisorseo.ai/mcp

claude.ai and Claude Desktop: open Customize, then Plugins, and add the marketplace repository advisorppc-org/advisorseo-claude-plugin, or install AdvisorSEO from claude.ai/directory once it is listed. A plugin installed on your account also loads in Claude Code as advisorseo@synced.

For a team, add this to the repository's .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "advisorseo": {
      "source": { "source": "github", "repo": "advisorppc-org/advisorseo-claude-plugin" }
    }
  },
  "enabledPlugins": { "advisorseo@advisorseo": true }
}

The first AdvisorSEO call opens a browser window where you sign in to your AdvisorSEO account and approve access. No key, password or header is ever pasted into the chat.

What it does

Why: each skill answers one question a site owner actually asks, and Claude picks the skill from your words.

Skill	Ask it like this	What you get
start-here	"How is my site doing?"	The workspace overview, the right site picked, and a route to the next skill
ai-readiness-check	"Can ChatGPT read my site?"	Every AI search and user-fetch bot marked ok or blocked, with the reason, plus failed checklist items
site-audit	"Audit my site"	Up to 10 findings with page and evidence, what changed since the last run, an optional recurring watch
pages-to-win	"What pages should I create?"	Up to 10 pages, each with a gap type and the metric it should move, saved to your plan on approval
approve-and-measure-change	"Publish that post"	A preview, your explicit yes, the change, and the metric to check afterwards
connect-and-import	"Add my site"	Platform detected, site record and business profile saved, WordPress and Google connection explained
leads	"Any new leads?"	New leads, one lead's full history, and status moves with a note on each
search-console	"Which queries bring clicks?"	Queries, pages, countries and devices from Search Console, URL inspection, sitemap status and submission
analytics-ga4	"Which landing pages convert?"	GA4 reports and realtime, a setup review, and key events or custom dimensions added on approval
tag-manager-tracking	"Audit my GTM container"	Tags, triggers and consent checked, and draft changes made on approval
core-web-vitals	"Is my site fast?"	Real-user field data, its history, and lab tests, each labelled by source

Every skill reports a rate with its sample size plus an interval, or says "insufficient data". No skill ever claims a rank position inside an AI assistant, and no skill queries or scrapes consumer AI apps.

How it works on its own

Why: an owner wants the site improved without having to ask each time, and without losing control of what changes.

AdvisorSEO watches the site (site-audit with a recurring watch, ai-readiness-check), proposes each change with its reason and the metric it should move (site-audit, pages-to-win), asks for one approval and applies it (approve-and-measure-change), then measures and reports the result with n and an interval, or "insufficient data" (approve-and-measure-change, leads).

Changes ask first

Why: these tools can change a live website, so a preview and a separate approval turn are the safety line.

The first call to a tool that changes your site, your records or your Google accounts changes nothing and returns a preview. The change happens only when the tool is called again with confirm=true, after you approve in your own next message. One tool saves without a preview, and it touches neither your site nor Google: gravity_geo_pagespeed saves a PageSpeed measurement. These are the tools the skills use that change something:

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗