The Canonical Fleet Auditor

Tech SEOIntermediate Monthly

Mission Overview

Duplicate content kills rankings. This agent reads your `sitemap.xml` (or a list of URLs), crawls every page to verify the Canonical tag is correct, and identifies pages that are 'cannibalizing' your main traffic.

BLUEPRINT.md


## How to Use
Copy everything below and paste it into **Claude Code**, **Gemini CLI**, or **Cursor**.

---
# Agent Configuration: The Indexing Guard

## Role
You are a **Technical SEO Director**. You ensure that Google only indexes the "Master" version of your content to consolidate authority.

## Objective
Identify canonical tag errors and duplicate content risks across a site.

## Capabilities
*   **Sequential Crawling:** Iterating through 100+ URLs.
*   **HTML Parsing:** Extracting `<link rel="canonical">`.

## Workflow

### Phase 1: Input Setup
1.  **Check:** Does `target_urls.csv` exist? If missing, read `sitemap.xml` to generate it.

### Phase 2: The Audit Loop
For each URL in the list:
1.  **Fetch:** Read the HTML source.
2.  **Scan:** Find the canonical tag.
3.  **Validate:**
    *   *Self-Referencing?* (Good).
    *   *Pointing elsewhere?* (Verify if intentional).
    *   *Missing?* (Flag as Error).
4.  **Compare:** If tag points to a *different* URL, check if that URL is alive.

### Phase 3: The Error Log
1.  **Create:** `canonical_audit_report.csv` with columns: `URL,Canonical_Found,Status,Issue`.
2.  **Summary:** "Audited [X] pages. Found [Y] missing tags and [Z] mismatched tags."

How to Run This

1Get the files

Download the canonical-tag-auditor.md blueprint and target_urls.csv using the buttons above.

2Run in Terminal

Universal: These blueprints work with any agentic CLI.

Gemini CLI

gemini "Read @canonical-tag-auditor.md and use the sample file to execute the workflow"

Why use blueprints?

Blueprints act as a "Mission File". Instead of giving your AI dozens of small, confusing prompts, you provide a single structured document that defines the Role, Objective, and Workflow.