Contents

Chapter 1

Features

This chapter covers the core features and capabilities of Canonical URL Planner.

Features

  • Load page/canonical pairs from CSV or JSON
  • Detect canonical chains (A → B → C) and recommend direct canonicals
  • Detect canonical loops (A → B → A)
  • Find missing canonical tags
  • Flag protocol mismatches (HTTP page with HTTPS canonical)
  • Identify cross-domain canonicals
  • Warn about query parameters in canonical URLs
  • Group pages by their canonical target to visualize duplicate content clusters
  • Track self-referencing canonicals (usually correct)
  • Multiple output formats: text, CSV, or JSON
  • Strict mode for CI/CD pipelines
  • Python stdlib only — zero dependencies

Quick Start

bash
# Validate canonical URLs from CSV
python src/canonical_url_planner.py --input examples/pages.csv

# Validate from JSON
python src/canonical_url_planner.py --input examples/pages.json

# JSON output for CI/CD
python src/canonical_url_planner.py --input examples/pages.csv --format json

# Strict mode
python src/canonical_url_planner.py --input examples/pages.csv --strict

# Write report to file
python src/canonical_url_planner.py --input examples/pages.csv --output report.txt
Chapter 2

Input Formats

Follow this guide to get Canonical URL Planner up and running in your environment.

Input Formats

CSV Format

csv
page_url,canonical_url
https://www.example.com/,https://www.example.com/
https://www.example.com/old-page,https://www.example.com/new-page
https://www.example.com/no-canonical,

JSON Format

json
[
    {"page_url": "https://www.example.com/", "canonical_url": "https://www.example.com/"},
    {"page_url": "https://www.example.com/old-page", "canonical_url": "https://www.example.com/new-page"}
]

CLI Flags

FlagDescription
--input, -iPath to pages file, CSV or JSON (required)
--format, -fOutput format: text, csv, or json (default: text)
--output, -oWrite output to file instead of stdout
--strictExit 1 if any warnings found
--quiet, -qOnly show errors
--verbose, -vEnable debug logging
Chapter 3
🔒 Available in full product

License

You’ve reached the end of the free preview

Get the full Canonical URL Planner and unlock everything.

All Chapters

Get the complete guide with every chapter unlocked, including code samples, diagrams, and best practices.

Full Tool Suite

Access all interactive tools with complete data, all workload profiles, and the full scenario library.

Source Files

Downloadable source code, configuration files, and working examples from every chapter.

Lifetime Updates

Free updates for life. Every new chapter, tool, and improvement included.

Buy Now — $19 →
📦 Free sample included — download another copy for the full product.
Canonical URL Planner v1.0.0 — Free Preview