WP Manifestindependent plugin directory
manifest / seo / seo-genie

SEO Genie - AI SEO Assistant

🤖 SEO Genie - 100% Free AI SEO Assistant for WordPress | Generate titles, meta & schema with Gemini (FREE), GPT-4, Claude | Open Source

by Javad Emami Dolatabadi · github.com/javademami/seo-genie

★ 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/javademami/seo-genie/archive/refs/heads/main.zip
Readme github.com/javademami/seo-genie ↗

🧞 SEO Genie - AI-Powered SEO Assistant for WordPress

Transform your WordPress SEO workflow with the power of artificial intelligence. SEO Genie automatically generates optimized titles, meta descriptions, keywords, and schema markup using cutting-edge AI technology.

Features • Installation • Usage • API Setup • Screenshots • Contributing • Support

✨ Features

🤖 Multiple AI Providers

  • Google Gemini (FREE - 15 requests/minute)
  • OpenAI GPT-4 & GPT-3.5 (Premium quality)
  • Anthropic Claude 3 (Excellent for long-form content)

📝 AI-Powered Content Generation

  • Smart SEO Titles - Optimized for click-through rates
  • Meta Descriptions - Compelling 160-character descriptions
  • Keyword Suggestions - Relevant keywords for your content
  • One-Click Generation - Generate all SEO elements at once

🏗️ Schema Markup Generator

Generate rich snippets with 5 schema types:

  • Article Schema
  • Product Schema
  • FAQ Schema
  • HowTo Schema
  • Recipe Schema

📊 SEO Analysis

  • Real-time SEO score (0-100)
  • Content readability analysis
  • Keyword density checker
  • Actionable improvement suggestions
  • Image optimization tips

👁️ Google Search Preview

See exactly how your content will appear in Google search results before publishing!

⚡ Bulk Generator

Process multiple posts at once:

  • Generate SEO content for 10, 50, or 100+ posts
  • Live progress tracking
  • Detailed generation logs

📈 Statistics Dashboard

Track your optimization progress:

  • Total posts optimized
  • AI-generated content count
  • Schema markup usage
  • Recent activity

🚀 Installation

From WordPress.org (Recommended)

  1. Login to your WordPress admin panel
  2. Navigate to Plugins → Add New
  3. Search for "SEO Genie"
  4. Click Install Now → Activate

Manual Installation

  1. Download the latest release from GitHub Releases
  2. Upload to /wp-content/plugins/seo-genie/
  3. Activate through the WordPress admin panel

Using Composer

composer require javademami/seo-genie

🎯 Quick Start

1. Get Your API Key (FREE)

Option A: Google Gemini (Recommended - FREE)

1. Visit: https://makersuite.google.com/app/apikey
2. Sign in with your Google account
3. Click "Create API Key"
4. Copy the key (starts with AIza...)

Option B: OpenAI

1. Visit: https://platform.openai.com/api-keys
2. Create account or login
3. Click "Create new secret key"
4. Copy the key (starts with sk-...)
5. Add $5+ credit to your account

Option C: Anthropic Claude

1. Visit: https://console.anthropic.com/
2. Create account or login
3. Navigate to API Keys
4. Create new key
5. Copy the key (starts with sk-ant-...)

2. Configure SEO Genie

  1. Go to SEO Genie → Settings
  2. Select your AI Provider
  3. Paste your API Key
  4. Click Test Connection
  5. Choose your preferred AI Model
  6. Save Settings

3. Start Generating!

  1. Create or edit any post/page
  2. Scroll to the SEO Genie metabox
  3. Click "Generate with AI"
  4. Review and publish!

📖 Usage

Basic SEO Generation

// In any post or page editor:

1. Enter your content
2. Set a focus keyword (optional)
3. Click "Generate with AI" buttons:
   - Generate SEO Title
   - Generate Meta Description
   - Suggest Keywords
4. Or use "Generate All SEO" for everything at once

Schema Markup

// In post editor:

1. Scroll to "Schema Markup" section
2. Select schema type (Article, Product, FAQ, etc.)
3. Click "Generate Schema"
4. Review the JSON-LD output
5. Save your post

// Schema is automatically added to <head> when published

SEO Analysis

// In post editor:

1. Enter content and focus keyword
2. Click "Analyze Content"
3. Review your SEO score (0-100)
4. Follow suggestions to improve
5. Re-analyze until satisfied

Bulk Generation

// For multiple posts:

1. Go to SEO Genie → Bulk Generator
2. Select posts:
   - All posts without SEO
   - Last 10 posts
   - Custom selection
3. Choose what to generate
4. Click "Start Bulk Generation"
5. Monitor progress

🔌 API Setup Guide

Gemini (Google) - FREE

Cost: Free (15 requests/minute)

Provider: Google Gemini
Model: Gemini 2.5 Flash (Recommended)
Pricing: FREE
Best for: Testing, personal blogs, small sites

OpenAI - PAID

Cost: Usage-based

Provider: OpenAI
Models:
  - GPT-3.5 Turbo: ~$0.002 per 1K tokens (~$0.50/100 posts)
  - GPT-4: ~$0.03 per 1K tokens (~$5/100 posts)
Best for: Professional sites, e-commerce

Claude (Anthropic) - PAID

Cost: Usage-based

Provider: Anthropic
Models:
  - Claude 3 Sonnet: ~$3 per 1M tokens (~$1/100 posts)
  - Claude 3 Opus: ~$15 per 1M tokens (~$5/100 posts)
Best for: Long-form content, detailed analysis

🛠️ Development

Requirements

  • WordPress 5.0+
  • PHP 7.4+
  • MySQL 5.6+
  • Internet connection (for AI API calls)

Local Development Setup

# Clone the repository
git clone https://github.com/javademami/seo-genie

# Navigate to plugin directory
cd seo-genie

# Install dependencies (if using Composer)
composer install

# Copy to WordPress plugins folder
cp -r . /path/to/wordpress/wp-content/plugins/seo-genie/

# Activate in WordPress admin
# Or via WP-CLI:
wp plugin activate seo-genie

File Structure

seo-genie/
├── seo-genie.php              # Main plugin file
├── README.md                  # This file
├── LICENSE.txt                # GPL v2 license
├── readme.txt                 # WordPress.org readme
├── includes/                  # Core classes
│   ├── class-seo-genie-core.php
│   ├── class-seo-genie-admin.php
│   ├── class-seo-genie-metabox.php
│   ├── class-seo-genie-api.php
│   ├── class-seo-genie-helper.php
│   └── class-seo-genie-schema.php
├── assets/                    # Frontend assets
│   ├── css/
│   │   ├── admin.css
│   │   └── metabox.css
│   └── js/
│       ├── admin.js
│       └── metabox.js
├── languages/                 # Translations
│   └── seo-genie.pot
└── .wordpress-org/           # Screenshots
    └── screenshot-*.png

Coding Standards

This plugin follows WordPress Coding Standards:

# Install PHP_CodeSniffer
composer global require "squizlabs/php_codesniffer=*"

# Install WordPress Coding Standards
composer global require wp-coding-standards/wpcs

# Check code
phpcs --standard=WordPress seo-genie.php

# Auto-fix code
phpcbf --standard=WordPress seo-genie.php

🧪 Testing

Manual Testing

# Enable WordPress debug mode
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

# Test on different WordPress versions
# Test on different PHP versions (7.4, 8.0, 8.1, 8.2)
# Test with different themes
# Test with page builders (Elementor, Divi, etc.)

Automated Testing (Coming Soon)

# PHPUnit tests
composer test

# Integration tests
composer test:integration

# End-to-end tests
composer test:e2e

🤝 Contributing

We welcome contributions! Here's how you can help:

Pull Requests

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Make your changes
  4. Follow WordPress Coding Standards
  5. Test thoroughly
  6. Commit (git commit -m 'Add amazing feature')
  7. Push to branch (git push origin feature/amazing-feature)
  8. Open a Pull Request

Development Guidelines

  • Follow WordPress Coding Standards
  • Write clear commit messages
  • Add comments to complex code
  • Update documentation
  • Test on multiple WP/PHP versions
  • Keep PRs focused and small

🔒 Security

Reporting Security Issues

Please do not report security issues publicly.

Email security concerns to: javademami2030@gmail.com

We take security seriously and will respond within 24 hours.

Security Features

  • ✅ All inputs sanitized
  • ✅ All outputs escaped
  • ✅ Nonces on all forms
  • ✅ Capability checks
  • ✅ Prepared SQL queries
  • ✅ API keys encrypted
  • ✅ CSRF protection

📄 License

This plugin is licensed under the GPL v2 or later.

SEO Genie - AI-Powered SEO Assistant for WordPress
Copyright (C) 2025 Your Name

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

🌟 Acknowledgments

Built With

Inspired By

  • WordPress SEO best practices
  • Modern AI capabilities
  • Community feedback

Special Thanks

  • WordPress.org review team
  • Early beta testers
  • Contributors and supporters
  • Open source community

📞 Support & Contact

Get Help

Stay Connected

🗓️ Changelog

[1.0.0] - 2025-12-15

Added

  • 🎉 Initial release
  • 🤖 AI-powered title generation
  • 📝 Meta description generation
  • 🔑 Keyword suggestions
  • 🏗️ Schema markup generator (5 types)
  • 📊 SEO analysis & scoring
  • 👁️ Google search preview
  • ⚡ Bulk generator
  • 📈 Statistics dashboard
  • 🔌 Support for Gemini, OpenAI, Claude

Security

  • ✅ All inputs sanitized
  • ✅ All outputs escaped
  • ✅ Nonces implemented
  • ✅ Capability checks added

View full changelog →

🎯 Roadmap

Version 1.1 (Coming Soon)

  • [ ] Custom AI prompts
  • [ ] More schema types
  • [ ] Competitor analysis
  • [ ] Content suggestions
  • [ ] Multi-language interface

Version 1.2

  • [ ] WooCommerce integration
  • [ ] Advanced analytics
  • [ ] Team collaboration
  • [ ] Custom reports
  • [ ] API rate limiting dashboard

Version 2.0

  • [ ] AI content writer
  • [ ] Image optimization
  • [ ] Link building suggestions
  • [ ] Automated internal linking
  • [ ] Performance monitoring

View full roadmap →

❓ FAQ

Is this plugin free?

Yes! SEO Genie is completely free and open source. You only need a FREE API key from Google Gemini.

Do I need technical knowledge?

No! If you can use WordPress, you can use SEO Genie. The interface is intuitive and user-friendly.

Which AI provider should I choose?

Start with Google Gemini (FREE). Upgrade to OpenAI or Claude if you need more advanced features or higher quality output.

Can I use this with Yoast/RankMath?

Absolutely! SEO Genie generates content, while Yoast/RankMath analyze it. They complement each other perfectly.

Is my data secure?

Yes! Only post content is sent to AI providers. No personal data, admin credentials, or site configuration is transmitted.

Can I contribute?

Yes! Contributions are welcome. See Contributing section above.

More FAQs →

🏆 Credits

Created By

Made with ❤️ for the WordPress Community

⬆ Back to Top

📜 Privacy & Legal

Data Processing

SEO Genie connects to external AI services:

  • Only post content is transmitted
  • No user data is collected
  • No tracking or analytics
  • API keys stored encrypted
  • GDPR compliant

Third-Party Services

Review their privacy policies before use.

⭐ If you find SEO Genie helpful, please give it a star on GitHub! ⭐