# RooSEO - Complete Specification & System Architecture RooSEO is an open-source, speed-optimized SEO plugin for WordPress engineered for site owners, developers, and autonomous agents who demand comprehensive search engine optimization without bloat. ## 1. Overview & Architectural Philosophy Many legacy WordPress SEO plugins load multiple heavy JavaScript bundles, trigger repeated third-party external API requests, and add significant DOM and CSS bloat to front-end page loads. RooSEO takes an opposite local-first approach: 1. **Zero Front-End Runtime Bloat**: Front-end metadata (meta tags, JSON-LD scripts, canonical tags) is rendered cleanly server-side without injecting tracking scripts, analytics pixels, or render-blocking scripts. 2. **Local Processing**: Content analysis, scoring, and redirect evaluations occur directly within the local WordPress PHP runtime and database tables. 3. **Agent & LLM Native**: Features dedicated llms.txt endpoints, in-browser WebMCP tool discovery, and rich machine-readable JSON-LD entity structures. ## 2. Core Modules ### 2.1 AI Crawler & LLM Optimization - Implements the `/llms.txt` and `/llms-full.txt` open standards. - Allows administrators to curate which posts, guides, or specifications should be digested by AI models (OpenAI, Anthropic, Google Gemini, Perplexity). - Configures robots.txt AI content-usage directives (`Content-Signal: search=yes, ai-train=no`). ### 2.2 Technical SEO & Schema Graph Generator - Outputs valid, nested JSON-LD schema graphs matching schema.org specifications: - `Organization` (brand identity, logo, sameAs profiles) - `WebSite` (site search action, publisher) - `SoftwareApplication` / `Product` - `Article` / `BlogPosting` with author and publisher nodes - `BreadcrumbList` for breadcrumb trails - XML Sitemaps: Generates clean, standards-compliant index and sub-sitemaps for posts, pages, and custom post types. ### 2.3 404 Logging & URL Redirection Engine - Live 404 monitoring with timestamp, visitor IP address, and referer. - 301 (Permanent) and 302 (Temporary) redirect routing with fast indexed database lookups. - Automatic redirect rule creation when any post, page, or product slug/permalink is modified. ### 2.4 Content Quality Scoring (100-Point Audit Engine) Analyzes post and page content in real-time across four pillars: 1. **Basic SEO**: Focus keyword presence in SEO title, meta description, URL slug, and opening paragraph; minimum content word count threshold (600+ words). 2. **Additional SEO**: URL character length checks, focus keyword in subheadings (H2, H3), image alt text checks, internal linking, and external citations. 3. **Title Readability**: Detection of emotional sentiment (positive/negative), power word presence, and focus keyword placement near title start. 4. **Content Readability**: Short digestible paragraphs, presence of Table of Contents, and rich media assets. ## 3. URLs and Resources - **Homepage**: https://rooseo.com/ - **Markdown Version**: https://rooseo.com/index.md - **About RooSEO**: https://rooseo.com/about.html - **Contact & Inquiries**: https://rooseo.com/contact.html - **Privacy Policy**: https://rooseo.com/privacy.html - **Terms of Service**: https://rooseo.com/terms.html - **Sitemap**: https://rooseo.com/sitemap.xml - **Robots Directives**: https://rooseo.com/robots.txt - **GitHub Repository**: https://github.com/roowp/rooseo - **WordPress.org Listing**: https://wordpress.org/plugins/rooseo/