Canonical Checker
Home/Tools/Technical SEO/Canonical Checker
⚙ Technical SEO

Canonical Tag Checker

v1.0 documentation

Validates canonical URLs across pages. Detects missing, self-referencing, cross-domain, and conflicting canonical tags.

URL inputFile inputXLSX export
canonical_checker.py104 lines3 paramsPython 3.8+
Quick start
1

Install

terminal
pip install -r requirements.txt
2

Run

terminal
python canonical_checker.py --urls https://a.com/p1 https://a.com/p2
terminal
python canonical_checker.py --file urls.txt --output canonical_audit.xlsx
3

Export

Add --output report.xlsx to save results as a spreadsheet.

Parameters
FlagDescription
--urlsUrls. Multiple values allowed
--fileFile with URLs
--outputSave as XLSX
help
python canonical_checker.py --help
Use cases
Technical audit
Pre-launch check
Ongoing monitoring

Run as part of a full site audit. Export issues to XLSX, prioritize by severity, and create a fix roadmap for the dev team.

Run before launching a new site or after a migration. Catch technical issues before Google crawls the new version.

Schedule regular checks and compare outputs over time. Catch regressions early.

Dependencies

Requires: beautifulsoup4, pandas, requests. All included in requirements.txt.

Get all 154 Python SEO tools — $49

One-time payment. Lifetime access. No monthly fees.
Learn 25 tools and get 25% back. Earn from client work and get 50% back.

Get the full toolkit

AAIO Inc — aaioinc.com/tools/canonical_checker/