Technical SEO WordPress Toolkit

Practical Technical SEO tools and reference documentation for WordPress websites, covering Crawling, Indexation, Canonical URLs, Redirects, Structured Data, Sitemaps, Robots.txt, Internal Linking, Multilingual SEO, and Performance-related checks.

Purpose

This toolkit supports the Technical SEO Audit process on WordPress and WooCommerce websites. It provides small, single-purpose scripts for the checks that come up repeatedly during audits and migrations, along with reference documentation that captures the reasoning behind each check. It is built to complement manual analysis, not to replace it.

Key Features

• URL status validation across a list of pages, including redirect handling.
• Redirect chain inspection, hop by hop, with loop detection.
• Canonical tag validation, including detection of missing or duplicate canonical tags.
• Robots.txt structural validation, including detection of accidental full-site blocking.
• XML sitemap validation, including well-formedness and optional URL sampling.
• Lightweight internal link checking for a single page.
• Read-only WordPress SEO inspection using WP-CLI.
• Reference documentation covering Technical SEO Audits, Multilingual and International SEO, and WordPress and WooCommerce SEO specifics.

Technical Approach

Each script is intentionally scoped to one check, so it can be run individually, scripted into a larger workflow, or used as a reference implementation. Scripts avoid paid or third-party APIs and rely on standard tools (curl, xmllint, WP-CLI, PowerShell) that are commonly available in development and server environments. Input is always provided through arguments or a plain text file, so no domain or environment detail is hardcoded.

Requirements

• PowerShell scripts (.ps1): PowerShell 7 or later (pwsh).
• Shell scripts (.sh): A POSIX-compatible shell with curl available. xmllint is optional and used for sitemap XML validation when present.
• WordPress SEO inspection: WP-CLI installed and access to a WordPress installation.

No paid APIs, licensed tools, or external services are required to use this toolkit.

Usage

# Validate HTTP status for a list of URLs (PowerShell)
pwsh ./scripts/Test-UrlStatus.ps1 -InputFile ./docs/examples/urls.txt

# Follow a redirect chain
./scripts/check-redirect-chains.sh https://example.com/old-page

# Validate canonical tags for a list of URLs (PowerShell)
pwsh ./scripts/Test-CanonicalTags.ps1 -InputFile ./docs/examples/urls.txt

# Validate robots.txt
./scripts/check-robots-txt.sh https://example.com

# Validate an XML sitemap, optionally sampling URLs
./scripts/check-sitemap.sh https://example.com/sitemap.xml --check-urls 10

# Check internal links on a single page
./scripts/check-internal-links.sh https://example.com/some-page

# Run a read-only WordPress SEO inspection via WP-CLI
./scripts/wp-seo-inspect.sh --path=/path/to/wordpress

Replace all example URLs with the URLs relevant to the site under review.

Project Structure

technical-seo-wordpress-toolkit/
├── README.md
├── LICENSE
├── .gitignore
├── .gitattributes
├── docs/
│   ├── technical-seo-audit-checklist.md
│   ├── multilingual-international-seo.md
│   ├── wordpress-woocommerce-seo-notes.md
│   └── examples/
│       └── urls.txt
└── scripts/
    ├── Test-UrlStatus.ps1
    ├── Test-CanonicalTags.ps1
    ├── check-redirect-chains.sh
    ├── check-robots-txt.sh
    ├── check-sitemap.sh
    ├── check-internal-links.sh
    └── wp-seo-inspect.sh

Security and Safety Notes

• All scripts are read-only: they issue HTTP requests to fetch and inspect content, or run read-only WP-CLI commands. None of them write, delete, or modify data.
• No credentials, API keys, tokens, or private infrastructure details are included anywhere in this repository. All examples use generic placeholder domains (example.com).
• WP-CLI commands should be run against a WordPress environment you are authorized to inspect, using an account with appropriate, least-privilege access.

Disclaimer

This toolkit performs targeted technical checks intended to support a Technical SEO Audit. It does not replace a full professional analysis, does not account for every ranking factor, and results should be reviewed in context by a qualified practitioner before acting on them.

Professional Context

Built and maintained by Didac Soria, a Web Developer, WordPress Expert, and Technical SEO Specialist working through StudioDDC. More background and work is available at didacsoria.com.

License

Released under the MIT License. See LICENSE for details.