OptiGraph SEO
OptiGraph SEO is a WordPress SEO plugin for technical SEO, schema.org/JSON-LD, XML sitemaps, redirects, Open Graph, WooCommerce SEO, content and link analysis, site audits, AEO/GEO and AI search optimization. Includes llms.txt, AI crawler controls, REST API, WP-CLI, structured metadata and safe AI-assisted SEO workflows for modern sites and stores.
Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/ildrm/wordpress-optigraph-seo/archive/refs/heads/main.zipOptiGraph 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, optionalllms-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.mddocs/ARCHITECTURE.mddocs/SECURITY.mddocs/FEATURE-COVERAGE.mddocs/QA.mddocs/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.