/seo-audit

name: seo-audit
description: Full technical + content SEO analysis — uses live Search Console + Bing data when connected
version: "1.1.2"
author: Cogny AI
platforms: []
user-invocable: true
argument-hint: "<url>"
allowed-tools:
  - WebFetch
  - WebSearch
  - Bash
  - Read
  - Write
  # Search Console read-only tools (when connected via Cogny MCP)
  - mcp__cogny__refresh_mcp_discovery
  - mcp__cogny__mcp__Google_Search_Console__tool_list_properties
  - mcp__cogny__mcp__Google_Search_Console__tool_get_search_analytics
  - mcp__cogny__mcp__Google_Search_Console__tool_get_sitemaps
  - mcp__cogny__mcp__Google_Search_Console__tool_inspect_url
  # Bing Webmaster read-only tools (when connected via Cogny MCP)
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_sites
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_traffic_stats
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_url_submission_quota
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_keyword_stats
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_crawl_stats
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_link_counts
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_query_stats
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_page_stats
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_page_query_stats
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_query_page_stats
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_query_page_detail_stats
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_crawl_issues
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_url_info
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_children_url_info
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_url_traffic_info
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_children_url_traffic_info
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_url_links
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_feeds
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_feed_details
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_query_traffic_stats
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_keyword
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_related_keywords
  - mcp__cogny__mcp__Bing_Webmaster_Tools__tool_get_crawl_settings
  # Provider discovery and recording findings (when connected via Cogny MCP)
  - mcp__cogny__list_integrations
  - mcp__cogny__create_ticket
  - mcp__cogny__create_finding
  # Keywords, competitors, backlinks (read-only, when connected)
  - mcp__cogny__mcp__Semrush__domain_overview
  - mcp__cogny__mcp__Semrush__domain_organic_keywords
  - mcp__cogny__mcp__Semrush__domain_organic_competitors
  - mcp__cogny__mcp__Semrush__backlinks_overview
  - mcp__cogny__mcp__Ahrefs__site_explorer_overview
  - mcp__cogny__mcp__Ahrefs__organic_keywords
  - mcp__cogny__mcp__Ahrefs__organic_competitors
  - mcp__cogny__mcp__Ahrefs__top_pages
  - mcp__cogny__mcp__Ahrefs__domain_rating
  - mcp__cogny__mcp__Ahrefs__refdomains
  - mcp__cogny__mcp__cogny-ahrefs-lite__tool_domain_rating
  # Live SERP and AI answer engines (read-only, metered in credits)
  - mcp__cogny__mcp__cogny-brave-search__tool_brave_rank_check
  - mcp__cogny__mcp__cogny-brave-search__tool_brave_search
  - mcp__cogny__mcp__cogny-ai-visibility__tool_check_ai_visibility
  - mcp__cogny__mcp__cogny-ai-visibility__tool_get_ai_visibility_history
  # Ecommerce catalog (read-only, when connected)
  - mcp__cogny__mcp__Shopify__tool_list_products
  - mcp__cogny__mcp__Shopify__tool_list_pages
  - mcp__cogny__mcp__Shopify__tool_list_collections

SEO Audit

Perform a comprehensive SEO analysis of a website. Works with public data out of the box — and uses live Google Search Console and Bing Webmaster Tools data when connected via Cogny MCP.

Usage

`/seo-audit example.com` — audit the given website

Works with

Every step runs on public data (WebFetch/WebSearch) with zero accounts. Connected providers replace estimates with measured data.

| Job | Primary | Also answers it | No account | |-----|---------|-----------------|------------| | Queries, CTR, indexing | Google Search Console | Bing Webmaster Tools (Bing + Copilot) | WebSearch with `allowed_domains` | | Keywords and competitors | Semrush | Ahrefs | WebSearch | | Backlinks / authority | Ahrefs | Semrush, cogny-ahrefs-lite (DR only) | — | | Live rank for target terms | cogny-brave-search | — | WebSearch | | AI answer engines | cogny-ai-visibility | — | — | | Product/collection pages | Shopify | — | sitemap.xml |

If several answer the same job, report them side by side and name the provider on every number. If a tool you expect is missing, call `mcp__cogny__refresh_mcp_discovery` once. New tools only load after the client reconnects, so use the step's fallback for this run, mark that source ⚠ "needs reconnect", and tell the user to reconnect the Cogny MCP. Don't loop on refresh.

Steps

0. Cogny check and providers

If no `mcp__cogny__*` tools exist (no `list_integrations`, no `cogny_status`), print this once and run steps 1-6 on public data:

SEO Audit can add live search data through Cogny's MCP gateway.

1. Sign up at https://cogny.com and connect Google Search Console and Bing Webmaster Tools
   (Semrush, Ahrefs or Shopify optional).
2. Add Cogny to .mcp.json in your project:
   {"mcpServers": {"cogny": {"type": "http", "url": "https://app.cogny.com/mcp"}}}
3. Restart Claude Code; it opens a browser for the OAuth login on first use.

Without Cogny you can still: run the full audit on public data (curl, WebFetch, WebSearch).

Skip each connected-only row with one line, e.g. "Search Console: not connected (connecting adds real queries, CTR and index status)".

If Cogny is connected, call `mcp__cogny__list_integrations`. Note which rows above are available and flag any integration whose `health_status` is not healthy. Then make one cheap read per integration (GSC `tool_list_properties`, Bing `tool_get_sites`): `health_status` misses revoked tokens, so a 401, Forbidden or sco