OptiGraph SEO

OptiGraph SEO is a modular WordPress search-intelligence plugin designed around technical SEO, connected structured data, content analysis, link intelligence, WooCommerce, GEO/AEO, safe automation, and extensibility.

Compatibility target

• WordPress: 6.6+; developed against the WordPress 7.1 API surface
• PHP: 8.0+
• WooCommerce: optional; 9.0+; tested-target metadata: 11.0.1
• Multisite: per-site lifecycle initialization is implemented; a full network runtime matrix and network management UI remain outstanding.
• Recommended extension: mbstring for non-ASCII case folding; character counting and truncation work without it.

Implemented in this build

• Per-post SEO title, description, canonical, focus topic, robots and schema controls
• Dynamic title/description template engine and custom-field variables
• Frontend canonical, description, Open Graph and Twitter metadata
• Connected JSON-LD graph for WebSite, Organization, WebPage, Person and Article entities
• WooCommerce Product/ProductGroup schema with variants, Offer data, SKU, global identifiers, Brand and aggregate ratings when available
• LocalBusiness/PostalAddress/GeoCoordinates enrichment
• Paginated XML sitemap index at /optigraph-sitemap.xml, including public posts, terms and authors, plus [optigraph_html_sitemap]
• llms.txt, optional llms-full.txt, and opt-in Markdown endpoints
• Hreflang adapters for WPML/Polylang, image metadata helpers, and opt-in IndexNow notifications
• Background post-metadata migration from Yoast SEO, Rank Math and SEOPress
• Configurable AI crawler directives in robots.txt
• Deterministic content scoring in the editor and REST API
• Redirect manager: 301, 302, 303, 307, 308, 410 and 451; exact, wildcard and regex rules
• Privacy-aware aggregated 404 monitoring
• Internal/external link relationship index with incoming/outgoing/orphan metrics
• Background site-audit batches with persistent issue tracking
• Bring-your-own OpenAI-compatible AI provider with safe remote HTTP requests and protected secret storage
• REST API for health, analysis, links, redirects, audits, AI generation and public headless metadata
• WordPress Abilities API integration for agent-discoverable read operations
• WP-CLI commands for audit, post analysis and link rebuilding
• Dedicated database tables for high-volume operational data
• Granular capabilities and an SEO Manager role
• Responsive WordPress-native admin UI
• Audit history for sensitive SEO mutations

Architecture

The plugin follows a modular service architecture under src/. Heavy analytical data is kept out of wp_postmeta; WordPress metadata remains the interoperability surface for per-object SEO fields.

See:

• docs/ROLES.md
• docs/ARCHITECTURE.md
• docs/SECURITY.md
• docs/FEATURE-COVERAGE.md
• docs/QA.md
• docs/REVIEW.md

Shortcodes

[optigraph_breadcrumbs]

REST namespace

/wp-json/optigraph-seo/v1/

WP-CLI

wp optigraph audit
wp optigraph analyze 123
wp optigraph links-rebuild

AI safety

AI is disabled by default. The built-in provider uses wp_safe_remote_post() and does not automatically write generated text to content or metadata. Generated output must be explicitly applied by a user or a future permissioned workflow. Credential-bearing requests require HTTPS, do not follow redirects, and use bounded response sizes. Automatic IndexNow notifications are also disabled until enabled in Settings.

License

GPL-2.0-or-later.

Review and verification

Version 0.1.1 fixes privacy, metadata, redirect, job-processing, schema and admin workflow defects documented in docs/REVIEW.md. Run bash tests/run.sh for local checks. The database-backed regression suite requires a disposable WordPress installation; setup and tested compatibility are recorded in docs/QA.md.