Guide · Agent skill

How to use the SEO Site Audit agent skill (seo-audit)

Updated 2026-11-02 · written with AI from the project's own documentation and checked against our catalogue data

The seo-audit skill is a set of instructions that teaches an AI agent, such as Claude, how to run a full SEO audit of a website using that site's own Google Search Console and Google Analytics 4 data. It is written for site owners, marketers, developers and SEO freelancers who want a repeatable first-pass audit. After this guide you will know what the skill does, how to install it, how to ask for an audit in plain language, and what you need in place before it works.

SEO Site AuditRyze-AI-Adgent/open-seo-mcp-skills · MIT Download the skill

Quick start

1Download and unzip. Download the seo-audit ZIP from this page and unzip it so you have a folder containing SKILL.md.
2Place the folder. Move the seo-audit folder into ~/.claude/skills/ for personal use, or into .claude/skills/ inside one project. In the Claude apps, upload the ZIP under Settings → Capabilities → Skills.
3Add the Ryze connector. Run claude mcp add ryze --transport http https://connector.get-ryze.ai/mcp in Claude Code, or add the same URL as a custom connector in claude.ai, Claude Desktop or Cursor.
4Confirm data access. Make sure your Ryze account can reach the site's Google Search Console and GA4 properties.
5Ask for an audit. Type a request such as 'audit my site' or 'why is my organic traffic down' and specify the domain if you have several properties.
6Review the report. Read the verdict first, then work through the Losers and Quick wins tables and the five-item action list.

What does the seo-audit skill make the agent do?

An agent skill is a folder with a SKILL.md file that tells the agent when to use a capability and how to carry out a task. This skill tells the agent to audit your site using your real Search Console and GA4 data, pulled through the Ryze MCP connector. It does not use third-party traffic estimates.

The agent works through a fixed sequence: it picks your Search Console property, checks indexation, compares clicks and impressions for the last 90 days against the previous 90, and looks for problems. Those problems are decaying pages (clicks down more than 30%), CTR anomalies (queries ranking in position 5 or better with CTR under 2%), striking-distance queries (positions 8 to 20 with high impressions), and cannibalization (one query split across several ranking pages). It then cross-checks organic sessions and conversions in GA4 and checks AI referral traffic.

What do you need before you install it?

The skill needs the free Ryze MCP connector at https://connector.get-ryze.ai/mcp. Using the connector requires a Ryze account and access to the site's Google Search Console and GA4. You add the connector in Claude Code, claude.ai, Claude Desktop or Cursor.

If Search Console is not connected, the skill stops and tells you so. It does not fall back to estimates, so a site without Search Console or GA4 access will not get a useful audit from this skill.

Ryze MCP connector (remote endpoint https://connector.get-ryze.ai/mcp)
A Ryze account
Access to the site's Google Search Console and GA4
Claude Code, claude.ai, Claude Desktop or Cursor to add the connector

claude mcp add ryze --transport http https://connector.get-ryze.ai/mcp

How do you install the seo-audit skill?

Download the ZIP for this skill from this page and unzip it. The skill is a folder containing SKILL.md. Put that folder in one of these locations:

Personal use across projects: ~/.claude/skills/ (the seo-audit folder goes inside it)
One project only: the .claude/skills/ folder inside your project
Claude apps: upload the ZIP under Settings → Capabilities → Skills

How do you connect the Ryze connector?

In Claude Code, run the command below. In claude.ai, Claude Desktop or Cursor, add a custom connector using the same URL. The Ryze setup guide is at https://help.get-ryze.ai/claude/connect. Once connected, the skill can call the Search Console and GA4 tools the connector provides.

claude mcp add ryze --transport http https://connector.get-ryze.ai/mcp

How do you trigger the skill with a natural request?

You do not need a special command. The skill's description lists phrases that should activate it. Ask in plain language, for example:

"Audit my site"
"Run an SEO audit on example.com"
"Why is my organic traffic down?"
"Do an SEO health check"

What does the report look like?

The report opens with a verdict paragraph saying whether the site is healthy and what the single most important issue is. It then has sections for Indexation, Losers, Quick wins (striking-distance and CTR fixes, ranked by impressions), and Cannibalization. Each section includes a table and a specific fix. It ends with a prioritized five-item action list.

Where a page holds rankings but loses organic sessions or conversions in GA4, the report calls that out, because a ranking page can still be losing revenue.

What are the safety notes?

According to the skill's listing, it does not run scripts. It does use the network, because it reads your data through the Ryze connector. Its workflow is read-oriented: it lists sites, pulls indexation summaries, runs analytics queries and inspects URLs. Review the connector's permissions and use an account that has access only to the sites you intend to audit.

Runs scripts: no
Uses network: yes, through the Ryze connector
Data comes from your own Search Console and GA4 accounts

What people use it for

A site owner checks why organic clicks fell over the last 90 days compared with the previous 90.
An SEO freelancer runs a repeatable first-pass audit on a client site before a deeper review.
A marketer finds queries ranking at positions 8 to 20 with high impressions that could reach page one with a focused fix.
A team spots two pages competing for the same query and decides which one should rank.
A team checks whether AI engines are becoming a meaningful referral channel for the site.

Frequently asked questions

Is the seo-audit skill free?

The skill itself is released under the MIT licence. It requires the Ryze MCP connector, which the source describes as free but requiring a Ryze account and access to the site's Google Search Console and GA4.

What do I need to use the seo-audit skill?

You need the Ryze MCP connector, a Ryze account, access to the site's Google Search Console and GA4, and one of Claude Code, claude.ai, Claude Desktop or Cursor to add the connector.

Where do I put the seo-audit skill folder?

Place it in ~/.claude/skills/ for personal use or in a project's .claude/skills/ folder. In the Claude apps, upload the ZIP under Settings → Capabilities → Skills.

Can the skill audit a site without Search Console?

No. The skill is built around Search Console and GA4 data. If Search Console is not connected, it says so and points you to the connector setup instead of using third-party estimates.

Does the skill check page speed, on-page HTML or backlinks?

No. The skill is not a standalone crawler. It reads search and analytics data through the connector and does not check on-page HTML, page speed or backlinks.

Is there an alternative if I need a crawler?

Yes, if you need on-page HTML, speed or backlink checks, use a separate crawler tool alongside this skill, since seo-audit only covers Search Console and GA4 data.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Use seo-audit if you already have Search Console and GA4 access for the site and want a consistent first-pass audit based on real data. Pick a different tool if you need a crawler for on-page HTML, page speed or backlinks, or if the site has no Search Console or GA4 access.

Download the skill