/seo-audit

name: seo-audit
description: Full technical + content SEO analysis — uses live Search Console + Bing data when connected
version: "1.0.0"
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__search_console__tool_list_properties
  - mcp__cogny__search_console__tool_get_search_analytics
  - mcp__cogny__search_console__tool_get_sitemaps
  - mcp__cogny__search_console__tool_inspect_url
  # Bing Webmaster read-only tools (when connected via Cogny MCP)
  - mcp__cogny__bing_webmaster__tool_get_sites
  - mcp__cogny__bing_webmaster__tool_get_traffic_stats
  - mcp__cogny__bing_webmaster__tool_get_url_submission_quota
  - mcp__cogny__bing_webmaster__tool_get_keyword_stats
  - mcp__cogny__bing_webmaster__tool_get_crawl_stats
  - mcp__cogny__bing_webmaster__tool_get_link_counts
  - mcp__cogny__bing_webmaster__tool_get_query_stats
  - mcp__cogny__bing_webmaster__tool_get_page_stats
  - mcp__cogny__bing_webmaster__tool_get_page_query_stats
  - mcp__cogny__bing_webmaster__tool_get_query_page_stats
  - mcp__cogny__bing_webmaster__tool_get_query_page_detail_stats
  - mcp__cogny__bing_webmaster__tool_get_crawl_issues
  - mcp__cogny__bing_webmaster__tool_get_url_info
  - mcp__cogny__bing_webmaster__tool_get_children_url_info
  - mcp__cogny__bing_webmaster__tool_get_url_traffic_info
  - mcp__cogny__bing_webmaster__tool_get_children_url_traffic_info
  - mcp__cogny__bing_webmaster__tool_get_url_links
  - mcp__cogny__bing_webmaster__tool_get_feeds
  - mcp__cogny__bing_webmaster__tool_get_feed_details
  - mcp__cogny__bing_webmaster__tool_get_query_traffic_stats
  - mcp__cogny__bing_webmaster__tool_get_keyword
  - mcp__cogny__bing_webmaster__tool_get_related_keywords
  - mcp__cogny__bing_webmaster__tool_get_crawl_settings

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

Steps

1. Fetch and analyze the homepage

Use WebFetch to load the target URL. Check:

• Title tag (length, keyword placement)
• Meta description (length, compelling copy)
• H1 tag (single, keyword-rich)
• Open Graph / Twitter Card metadata
• Canonical URL
• Language/hreflang tags

2. Check technical SEO

Use WebFetch to check:

• `/robots.txt` — crawl rules, sitemap reference
• `/sitemap.xml` — exists, well-formed, number of URLs
• Page load indicators (large images, render-blocking scripts)
• Mobile viewport meta tag
• HTTPS enforcement

3. Analyze content structure

From the homepage content:

• Word count (target: 300+ for ranking pages)
• Header hierarchy (H1 → H2 → H3)
• Internal link count and structure
• Image alt text coverage
• Schema markup (JSON-LD)

4. Check search presence

Use WebSearch to find:

• `site:example.com` — indexed page count
• Brand name search — what appears in SERP
• Top ranking pages — what keywords they rank for
• Competitor comparison — who ranks for the same terms

5. Analyze key content pages

WebFetch 3-5 important pages (pricing, features, blog):

• Per-page title/meta/H1 analysis
• Content depth and keyword coverage
• Internal linking to/from homepage

6. Report findings

Present as a scored audit:

SEO Audit: example.com
Score: X/100

Technical: X/25
- [PASS/FAIL] HTTPS
- [PASS/FAIL] Robots.txt
- [PASS/FAIL] Sitemap
- [PASS/FAIL] Mobile viewport
- [PASS/FAIL] Canonical URLs

On-Page: X/25
- [PASS/FAIL] Title tags
- [PASS/FAIL] Meta descriptions
- [PASS/FAIL] H1 structure
- [PASS/FAIL] Image alt text
- [PASS/FAIL] Schema markup

Content: X/25
- [PASS/FAIL] Word count
- [PASS/FAIL] Header hierarchy
- [PASS/FAIL] Internal linking

Search Presence: X/25
- Indexed pages: N
- Brand SERP: [description]
- Top keywords: [list]

Top 3 Actions:
1. [Highest impact fix]
2. [Second highest]
3. [Third highest]

Recording Findings

If the Cogny MCP is connected (`mcp__cogny__create_finding` available), record each actionable finding:

{
  "title": "Missing meta descriptions on 12 pages",
  "body": "Pages /pricing, /features, /blog/... lack meta descriptions. Average CTR for pages without descriptions is 30% lower.",
  "action_type": "seo_optimization",
  "expected_outcome": "Improve CTR by 15-30% on affected pages",
  "priority": "high"
}

Deeper Analysis with Live Data

If Cogny MCP is connected, this skill automatically enhances the audit with:

**Google Search Console:** actual queries, click-through rates, rankings, indexing status **Bing Webmaster Tools:** Bing traffic, crawl stats, keyword data, backlink analysis

Connect your accounts via [Cogny](https://cogny.com) ($9/mo per channel), then re-run the audit for live data.

For ongoing monitoring, use `/seo-monitor`.