# Copilot SEO

> Copilot SEO turns Google Search Console data into a ranked Action plan of SEO changes, reviews each change 28 days after it is made, and measures experiments. AI agents can set it up and work it through an MCP server or a REST API.

A person has to create the account, connect Google and pay. An agent can do everything else. Start with the public agent guide. The full guide, with the rules for reading the data and each routine step by step, comes with a connected account: the MCP resource copilot-seo://agents.md, or GET https://copilot-seo.com/api/v1/guide with a token. Handbook articles show how each figure is worked out to signed-in customers, and to agents that send their token.

Operations, each an MCP tool on https://copilot-seo.com/mcp and a REST endpoint under https://copilot-seo.com/api/v1: whoami, setup_status, list_search_console_sites, add_site, set_brand_terms, list_properties, sites_overview, gsc_metrics, get_rankings, list_recommendations, get_recommendation, update_recommendation, mark_implemented, get_outcomes, list_markers, create_marker, delete_marker, list_experiments, get_experiment, create_experiment, list_url_groups, create_url_group, list_alerts.

## Agents

- [Agent guide](https://copilot-seo.com/agents.md): the public guide, with what Copilot SEO does, the steps only a person can do, how to connect, the setup flow, questions to ask, the routines to suggest and the tools each one uses
- [MCP server](https://copilot-seo.com/features/search-console-mcp-server): the tools, OAuth for Claude and personal access tokens for other clients
- [REST API](https://copilot-seo.com/help/rest-api.md): the same operations over HTTP, for code, cron and CI
- [For people](https://copilot-seo.com/agents): the starter prompt and routines to paste into an agent

## Handbook

- [Getting started](https://copilot-seo.com/help/getting-started.md): What Copilot SEO does, what it does not do, and how to get from sign-up to your first action.
- [Connect Search Console](https://copilot-seo.com/help/connect-search-console.md): How to connect your Google account, choose the right Search Console property and add more sites.
- [Your first import](https://copilot-seo.com/help/first-import.md): What we import when you add a site, how to follow its progress, and what fills in once it is done.
- [Why the numbers differ from Search Console](https://copilot-seo.com/help/numbers-vs-search-console.md): Search Console reports the same traffic in several ways that do not add up to each other. This is which one each screen uses, and why.
- [How long your data is kept](https://copilot-seo.com/help/data-history.md): Why data runs two days behind, what "data through" means, and how much history and detail each plan keeps.
- [Glossary](https://copilot-seo.com/help/glossary.md): Plain definitions of the terms you will see in Copilot SEO.
- [The Action plan](https://copilot-seo.com/help/action-plan.md): What the Action plan looks for, how it sorts changes into Now, Next and Later, and how to work it.
- [Reading an action](https://copilot-seo.com/help/reading-an-action.md): What priority, confidence, effort, impact range and business value mean on an Action plan card.
- [Working an action](https://copilot-seo.com/help/working-an-action.md): Diagnose an action, check the page in Google's index, record the change and read the review 28 days later.
- [Experiments](https://copilot-seo.com/help/experiments.md): Record a change to a page, a group of pages or the whole site, and compare the time after it with the same length of time before.
- [Annotations](https://copilot-seo.com/help/annotations.md): Mark Google updates, releases and your own notes on the charts, so you can read a rise or fall against what happened.
- [Pages and queries](https://copilot-seo.com/help/pages-and-queries.md): Look through every page and search query we have imported, compare periods and export the lists.
- [Rankings](https://copilot-seo.com/help/rankings.md): See how many of your searches rank in the top 3, the rest of page one, page two and further down, week by week, and which crossed from one to another.
- [Breakdowns](https://copilot-seo.com/help/breakdowns.md): See where your search traffic comes from: devices, countries, and brand against non-brand searches.
- [URL groups](https://copilot-seo.com/help/url-groups.md): Save a set of pages as a group, so you can follow a whole section of your site instead of one page at a time.
- [Reports (Beta)](https://copilot-seo.com/help/opportunities.md): The full lists behind the Action plan: CTR, striking distance, competing pages, content decay, page health and content gaps.
- [Topics and topic groups (Beta)](https://copilot-seo.com/help/topics.md): Topics cluster your pages and queries by subject, score how strong you are on each, and group related topics together.
- [Alerts and the daily digest](https://copilot-seo.com/help/alerts.md): What triggers an alert, how the daily digest groups smaller changes, and who gets the emails.
- [Emails you will get](https://copilot-seo.com/help/emails.md): Every email Copilot SEO sends, who gets it, and how to stop the ones you can stop.
- [Crawl import](https://copilot-seo.com/help/crawl-import.md): Upload a crawl from Screaming Frog or Sitebulb so the Action plan can show technical problems next to the search data.
- [Connect an AI assistant](https://copilot-seo.com/help/connect-ai-assistant.md): Connect Claude, or another AI assistant, so it can read your search data and work through your Action plan with you.
- [Agentic SEO](https://copilot-seo.com/help/agentic-seo.md): Hand the regular SEO work to an AI agent: what to paste, how much to let it do, and routines to give it.
- [REST API](https://copilot-seo.com/help/rest-api.md): For developers: the same operations as the MCP server, over plain HTTP with a personal access token.
- [Teams and members](https://copilot-seo.com/help/teams.md): A team holds your sites, settings and plan. Invite colleagues, and keep each client in a team of its own.
- [Signing in](https://copilot-seo.com/help/signing-in.md): Passkeys, two-step sign-in and what to do if you lose access.
- [Plans, trials and billing](https://copilot-seo.com/help/plans-and-billing.md): What each plan includes, how free trials work, and what happens to your data when you change plan.
- [Privacy and security](https://copilot-seo.com/help/privacy-and-security.md): What we store, who can see it and how to remove it.
- [Troubleshooting](https://copilot-seo.com/help/troubleshooting.md): Fixes for failed imports, a disconnected Google account, missing sites, low numbers and an empty Action plan.

## Optional

- [Pricing](https://copilot-seo.com/#pricing)
- [Privacy policy](https://copilot-seo.com/privacy)
- [Terms of service](https://copilot-seo.com/terms)