WP Manifestindependent plugin directory
manifest / seo / aurelius-seo-wp-plugin

Aurelius SEO

Wordpress SEO Plugin

by Mehmet Can Orucu · github.com/mcorucu/aurelius-seo-wp-plugin · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/mcorucu/aurelius-seo-wp-plugin/archive/refs/heads/main.zip

Readme

Aurelius SEO

Disciplined SEO guidance for clearer WordPress content.

Aurelius SEO is an open source WordPress SEO plugin built by Mehmet Can Orucu. It combines deterministic SEO scoring, editor guidance, Schema.org output, social metadata, technical SEO tools, WooCommerce support, redirects, multilingual infrastructure, and optional AI assistance in one carefully scoped plugin.

The plugin is inspired by the discipline and clarity associated with Marcus Aurelius: steady improvement, transparent decisions, and useful feedback. It avoids silent magic where possible. The analyzer is deterministic, the score is explainable, and AI suggestions are optional helpers rather than a source of truth.

Links

Features

  • Deterministic 0-100 SEO scoring with category recommendations.
  • Gutenberg sidebar and Classic Editor meta box.
  • Focus keyword, SEO title, meta description, canonical, robots, and schema controls.
  • Search preview, Open Graph preview, and X/Twitter Card support.
  • Schema.org JSON-LD graph with site identity, breadcrumbs, page/article nodes, and WooCommerce Product schema.
  • WordPress XML Sitemap integration and robots.txt controls.
  • Technical SEO health checks, output inspection, and duplicate-output visibility.
  • Exact-match redirect manager and privacy-preserving 404 monitor.
  • WooCommerce product SEO checks for images, alt text, short descriptions, SKU, price, availability, reviews, taxonomy use, and Product schema readiness.
  • Compatibility framework for Gutenberg, Elementor, Divi, WPBakery, Bricks, Beaver Builder, Avada, and the Classic Editor.
  • REST API endpoints for editor analysis, recommendations, refresh, deterministic suggestions, and optional AI suggestions.
  • Provider-agnostic AI framework with OpenAI, Claude, Gemini, Ollama, OpenRouter, and Custom REST support.
  • Multilingual translation infrastructure with starter locale files.
  • Optional first-run setup guide.
  • Developer hooks, filters, content adapters, schema nodes, compatibility integrations, scoring services, and AI provider extension points.

Philosophy

Aurelius SEO is designed around clarity. The score engine is deterministic and local. It analyzes content, metadata, indexability, headings, links, images, and schema readiness without sending content to an external service.

AI assistance is available only when enabled by an administrator and only when an editor explicitly clicks an AI action. AI suggestions never affect deterministic SEO scoring. Aurelius SEO works fully without AI.

Screenshots

The WordPress.org assets include ten screenshots:

  1. Dashboard with overall SEO health, score cards, compatibility summary, and recent activity.
  2. Gutenberg editor sidebar with SEO score, focus keyword, title, meta description, and recommendations.
  3. Content Scores table with score badges, filters, sorting, and score distribution.
  4. Schema and Social controls with search, Facebook, X preview, and schema type fields.
  5. Technical SEO screen with health checks, robots, sitemap, output inspector, and conflict detection.
  6. Redirect manager with 301 redirects, hit counters, 404 monitor, and actions.
  7. Commerce dashboard fallback with product SEO, commerce health, schema, and recommendations.
  8. Compatibility and migration center with detected integrations, theme compatibility, AI, and SEO plugin detection.
  9. AI suggestions panel with provider settings, generated title, description, keywords, and suggestion results.
  10. Plugin Settings with general, AI, redirect, sitemap, commerce, and output controls.

Installation

  1. Upload the aurelius-seo folder to /wp-content/plugins/, or install the release ZIP through Plugins > Add New > Upload Plugin.
  2. Activate Aurelius SEO from WordPress admin.
  3. Use the optional setup guide, or skip it and configure manually.
  4. Open Aurelius SEO > Settings to review editor, schema, social, sitemap, redirect, commerce, and optional AI settings.
  5. Edit a post, page, product, or supported custom post type to review SEO guidance.

Developer Hooks

Aurelius SEO exposes hooks and filters for:

  • Service registration.
  • Score rules and score refresh events.
  • Content adapters and page-builder integrations.
  • Schema graph nodes.
  • Compatibility integrations.
  • AI providers and AI suggestion post-processing.
  • Stop words and analyzer behavior.

See the documentation site for the maintained hook reference: https://docs.mcorucu.com/aurelius-wp-seo-plugin/

REST API

The plugin registers REST routes under:

aurelius-seo/v1

Available editor-facing endpoints include:

  • POST /analysis
  • POST /recommendations
  • POST /refresh
  • POST /suggestions
  • POST /ai/suggestions

Routes use WordPress REST permissions and capability checks. AI routes still require AI to be enabled and acknowledged in settings.

AI Providers

The AI framework is provider-agnostic and optional. Supported provider classes include:

  • OpenAI
  • Claude
  • Gemini
  • Ollama
  • OpenRouter
  • Custom REST, including LM Studio-compatible local workflows

AI is disabled by default. No content is sent to an AI provider unless an administrator enables AI and an editor explicitly requests a suggestion.

Roadmap

Near-term priorities include:

  • Continued WordPress.org polish.
  • Expanded translations.
  • More developer examples.
  • Additional compatibility refinements.
  • Community-driven bug fixes and feature requests.

Contributing

Community contributions are welcome. Please use GitHub Issues for bug reports, feature requests, and implementation discussion:

https://github.com/mcorucu/aurelius-seo-wp-plugin/issues

Pull requests should keep the existing architecture intact, avoid unrelated refactors, and preserve deterministic scoring behavior.

Support

For public support, bug reports, and feature requests, use GitHub Issues:

https://github.com/mcorucu/aurelius-seo-wp-plugin/issues

License

Aurelius SEO is open source software licensed under GPL v2 or later.

Built by Mehmet Can Orucu.

Read the full README on GitHub →