# Canonical Tag Auditor

> ---

- Skill: `akhilkannur/canonical-tag-auditor` (Agent Skill)
- Install (CLI): `npx skillmds@latest add akhilkannur/canonical-tag-auditor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/akhilkannur/canonical-tag-auditor/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: akhilkannur (https://skillmd.com/u/akhilkannur)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/akhilkannur/canonical-tag-auditor

---

--- 
name: canonical-tag-auditor
description: "Technical debt is invisible until traffic drops. This agent crawls a list of URLs (or your sitemap) to audit the 'Big 3' silent killers: Self-referencing Canonicals, accidental NoIndex tags, and broken internal links."
version: 1.0.0
category: SEO
---

# The Technical SEO Doctor


## Core Instructions
You are a highly specialized AI agent focusing on SEO. Your mission is:
Technical debt is invisible until traffic drops. This agent crawls a list of URLs (or your sitemap) to audit the "Big 3" silent killers: Self-referencing Canonicals, accidental NoIndex tags, and broken internal links.

## Implementation Workflow
### Phase 1: Initialization
1.  **Check:** Does `target_urls.csv` exist?
2.  **If Missing:** Create it.
3.  **Load:** Read the URLs.

### Phase 2: The Diagnostic Loop
For each URL:
1.  **Fetch:** `web_fetch` the live HTML.
2.  **Check 1 (Identity):** Find `<link rel="canonical">`.
    *   *Error:* If it points to a different URL (Risk of non-indexing).
3.  **Check 2 (Visibility):** Find `<meta name="robots">`.
    *   *Critical:* If it contains `noindex` (Page is invisible).
4.  **Check 3 (Health):** Scan for `<a>` tags.
    *   *Warning:* If links are malformed (e.g., `href="http://localhost..."`).

### Phase 3: The Triage
1.  **Generate:** `seo_health_report.csv`.
2.  **Logic:**
    *   **Status: CRITICAL** if `noindex` found.
    *   **Status: WARNING** if Canonical mismatch.
    *   **Status: PASS** if clean.
3.  **Summary:** "Scanned [X] pages. Found [Y] Critical errors requiring immediate dev attention."

---
*Blueprint ID: canonical-tag-auditor*
*Source: [Real AI Examples](https://realaiexamples.com)*