WP Manifestindependent plugin directory
manifest / seo / mindfulseo

MindfulSEO

MindfulSEO WordPress plugin

by Mindful Design · github.com/lucmindfuldesign/mindfulseo · website

★ 0stars

Install

Download source zip No release zip yet

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/lucmindfuldesign/mindfulseo/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
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