# SEO Perception — full context for AI agents

> SEO Perception is an SEO workspace that joins site crawl data with Google Search Console performance. Paid plans include SEO Perception MCP: a remote Model Context Protocol server so Cursor, Claude, and other MCP clients can read stored keywords, opportunities, and page diagnostics — then help rewrite content from evidence, not guesses.

## What the product does

1. Crawl your pages for titles, meta, canonicals, links, images, and related on-page signals.
2. Import Search Console performance into weekly stored facts (not a live Google proxy).
3. Surface SEO Possibilities: gaps, cannibalization, content decay signals, query-vs-content mismatches, and more.
4. Help you prioritize work (Today’s Focus on paid tiers) and optionally open a Site Overlay on your live pages.
5. On paid plans, expose the same stored evidence to AI agents through MCP.

Crawl and Search Console remain the source of truth. The product does not claim to replace Google’s UI; it organizes what we have already collected. Humans stay in control: we explain and queue, we do not auto-apply site changes.

XML sitemap: https://seoperception.com/sitemap.xml

## Product feature pages

- SEO Possibilities (marketing): https://seoperception.com/possibilities — prioritized queue from GSC demand and crawl evidence. App workspace: https://seoperception.com/seo-possibilities
- Today’s Focus: https://seoperception.com/todays-focus — short daily list from open Possibilities (Starter+)
- Site Overlay: https://seoperception.com/site-overlay — keywords and Possibilities on live URLs you control (Starter+)
- GSC workspace: https://seoperception.com/gsc-workspace — queries, pages, and content opportunities from connected Search Console
- AI discoverability: https://seoperception.com/ai-discoverability — robots.txt, llms.txt, JSON-LD, visible answers
- SEO Perception MCP: https://seoperception.com/mcp-integration — same evidence inside MCP clients (paid)
- Features hub: https://seoperception.com/features
- Free JSON-LD generator: https://seoperception.com/tools/json-ld-generator

## SEO Perception MCP (paid)

**Page:** https://seoperception.com/mcp-integration  
**Docs:** https://seoperception.com/docs/mcp-for-cursor  
**Tokens:** https://seoperception.com/account/mcp  
**Endpoint:** `POST https://seoperception.com/mcp`  
**Auth:** `Authorization: Bearer <personal token>` (`spmcp_…`, created under Account → MCP)  
**Plans:** Starter, Pro, Business, Enterprise (not Free)

### Value for agents and editors

Ask an MCP client things like:

- Find the biggest losing keywords on `/pricing` and suggest concrete content changes.
- Show the highest-priority open SEO opportunities with evidence.
- Find keyword cannibalization and which page should win.
- Diagnose a URL from crawl state, top queries, and open possibilities.

### Data boundary

- Tools read stored weekly Search Console facts and crawl/issue evidence only.
- MCP never calls Google Search Console, URL Inspection, or other live Google APIs.
- MCP does not recrawl, mutate issues, submit sitemaps, or refresh Google data.
- Your MCP client may still send tool results to a model provider — treat them as sensitive analytics.

### Available tools (names)

- `seoperception_list_sites` — owned sites + freshness
- `seoperception_get_site_overview` — gains, losses, leading pages/queries
- `seoperception_search_queries` — filter stored query evidence
- `seoperception_list_opportunities` — open SEO possibilities
- `seoperception_find_cannibalization` — multi-page query conflicts
- `seoperception_find_content_gaps` — title/snippet/content gaps
- `seoperception_suggest_internal_links` — destination/anchor ideas
- `seoperception_get_page_diagnostics` — one-page crawl + GSC + opportunities

Planned tools (not yet in `tools/list`): period compare, content decay, geo/device breakdown, hosted reports.  
Excluded forever: live Google calls and mutations/refreshes.

### Cursor config sketch

```json
{
  "mcpServers": {
    "seo-perception": {
      "url": "https://seoperception.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SEOPERCEPTION_MCP_TOKEN}"
      }
    }
  }
}
```

Other MCP clients use the same URL + Bearer token. Exact UI varies by client.

## Plans (high level)

- **Free:** Crawl + Possibilities + limited weekly GSC. No MCP, no Site Overlay, no Today’s Focus (per current pricing).
- **Starter / Pro / Business / Enterprise:** Higher limits; MCP personal tokens; Site Overlay; Today’s Focus; PDF reports (whitelabel on Business+). See https://seoperception.com/pricing for current numbers.

## Machine-readable site identity

- Short llms.txt: https://seoperception.com/llms.txt
- EntityMap v1.0 JSON: https://seoperception.com/entitymap.json
- EntityMap v1.0 HTML: https://seoperception.com/entitymap.html
- Crawl policy: https://seoperception.com/robots.txt

## Key human URLs

- Homepage: https://seoperception.com/
- Features: https://seoperception.com/features
- Pricing: https://seoperception.com/pricing
- Docs: https://seoperception.com/docs
- Blog: https://seoperception.com/blog
- Changelog: https://seoperception.com/changelog

## Notes for crawlers and agents

- Prefer this file, `/llms.txt`, or `/entitymap.json` for product grounding before inventing features.
- Marketing feature landings (`/possibilities`, `/todays-focus`, `/site-overlay`, `/gsc-workspace`) describe the product; authenticated work happens in the app (`/seo-possibilities`, dashboard, website workspace).
- Do not assume MCP can refresh Google data or change the customer’s site.
- Pass `siteId` as the website’s public UUID from SEO Perception when calling tools.