WP Manifestindependent plugin directory
manifest / seo / mindfulseo

MindfulSEO

MindfulSEO WordPress plugin

by Mindful Design · github.com/lucmindfuldesign/mindfulseo · 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/lucmindfuldesign/mindfulseo/archive/refs/heads/main.zip
Readme github.com/lucmindfuldesign/mindfulseo ↗

MindfulSEO WordPress Plugin

Website: mindfuldesign.me

Release history: see CHANGELOG.md (detailed) and Changelog below.

AI-powered SEO optimization plugin for WordPress. Batch optimize titles, descriptions, and keywords with OpenAI or Claude while respecting your brand guidelines.

Features

Core Functionality

  • AI-Powered Optimization: Uses OpenAI GPT-4 or Claude to generate SEO titles, meta descriptions, and keywords
  • Batch Processing: Optimize hundreds of posts at once with intelligent queuing
  • SEO Audit Dashboard: Instantly identify posts with SEO issues (missing metas, keywords, low scores)
  • Keyword Strategy: Build and manage targeted keyword lists with search volume data
  • Language Guidelines: Define brand voice rules that AI must follow
  • DataForSEO Integration: Get real search volume, keyword difficulty, and CPC data
  • Works with Rank Math & Yoast: Seamlessly integrates with popular SEO plugins

Key Features

  • Smart Keyword Extraction: 4-strategy system identifies the best keywords from your content
  • Title Preservation: AI keeps your core topic while optimizing for SEO
  • One-Click Fix: SEO Audit → Fix All → Batch Optimizer workflow
  • Inline Editing: Edit any field directly in the table
  • 30-Day Caching: DataForSEO data caches to save API costs
  • Validation System: Automatic checks for title/description length

Perfect For

  • Content-heavy websites
  • Bloggers and publishers
  • Marketing agencies
  • E-commerce sites
  • Educational platforms
  • Any WordPress site needing SEO optimization at scale

Installation

  1. Upload the mindfulseo folder to /wp-content/plugins/
  2. Activate the plugin through the 'Plugins' menu in WordPress
  3. Go to MindfulSEO → Settings to configure your API keys
  4. Add your OpenAI or Claude API key and test the connection
  5. (Optional) Add DataForSEO credentials for keyword metrics

Requirements

  • WordPress 5.8 or higher
  • PHP 7.4 or higher
  • Rank Math SEO or Yoast SEO plugin (recommended)
  • OpenAI API key, Claude API key, or OpenRouter key (one key, many models)
  • DataForSEO account (optional, for keyword metrics)

Quick Start

  1. Settings: Add your AI API key (OpenAI or Claude)
  2. SEO Audit: See all your SEO issues at a glance
  3. Click "Fix All": Posts auto-select in Batch Optimizer
  4. Optimize: AI generates SEO-optimized titles, descriptions, and keywords

Configuration

API Keys

Language Guidelines

Import your brand guidelines or let AI generate them from your existing content. Rules include:

  • Terms to avoid (e.g., "cheap" → "affordable")
  • Proper capitalizations
  • SEO-friendly phrasings

Keyword Strategy

  • Import keywords from CSV
  • Auto-generate with AI
  • Get DataForSEO metrics (volume, difficulty, CPC)
  • Manual keyword entry

Documentation

See instructions.md for comprehensive documentation including:

  • Optimal SEO workflow
  • Best practices for each component
  • Troubleshooting guide
  • DataForSEO integration details

Changelog

2.4.0 (2026-03-29)

  • New: OpenRouter AI backend (settings + setup wizard; presets, custom model id, optional fallback to direct vendor APIs)
  • New: Posts Import / Export (ZIP with manifest + HTML bodies; slug-based merge modes)
  • Updated: Setup wizard import preservation, preflight import before analyze, progress UX; keyword/guideline extend balancing; batch optimizer focus keyword / strategy handling; content analyzer robustness for wizard outputs

2.3.0 (2026-03-26)

  • New: Setup wizard, dashboard, content hub, keywords admin section
  • New: Content cluster engine, gap analyzer, internal linker, cache manager
  • Updated: Batch optimizer, SEO audit, admin UI, AI connectors, guidelines/keyword/data pipeline
  • Housekeeping: Version alignment (Version header + MINDFULSEO_VERSION), CHANGELOG.md, WordPress-style readme.txt
  • Removed: Sample test-data CSV/MD from the repo

See CHANGELOG.md for the full list.

1.0.0

  • Initial public release
  • AI-powered SEO optimization (OpenAI & Claude)
  • SEO Audit Dashboard
  • Batch Optimizer with server-side filtering
  • Keyword Strategy management
  • Language Guidelines engine
  • DataForSEO integration (Lighthouse & Instant Page analysis)
  • Rank Math and Yoast SEO compatibility
  • 30-day caching for API data
  • Inline editing for all fields
  • Comprehensive documentation

Support

For support, email support@mindfuldesign.me or visit mindfuldesign.me.

License

GPL v2 or later

Built with ❤️ by Mindful Design