SEO Magic – AI SEO Assistant

SEO Magic turns your WordPress dashboard into an AI-assisted SEO control center. Instead of jumping between tools, you can:

• Generate SEO titles, meta descriptions and Open Graph tags in bulk.
• Ask the Content Assistant to improve your articles, add FAQs, or suggest schema.
• Fix missing alt text and improve image SEO automatically.
• Optimize WooCommerce products with consistent, on-brand SEO fields (PRO).
• Run a technical SEO audit and get actionable recommendations (PRO).
• Analyze backlinks, detect potentially harmful links and discover link opportunities (PRO).
• Discover internal and external link ideas with the Auto-Linking Assistant (PRO).

Everything is integrated into the WordPress admin UI so you keep full control of your content.

Note: SEO Magic requires a Google Gemini API key to generate AI-based content. The plugin includes a guided setup to help you connect your key and start using the free or paid Gemini tiers.

SEO Magic lets you choose between multiple Gemini models (such as gemini-2.5-flash, gemini-2.5-flash-lite, gemini-2.5-pro and optional Gemini 3.x models like gemini-3-pro-preview). By default, the plugin uses Gemini 2.5 Flash, which is optimized for the current free tier in Google AI Studio for most accounts. Gemini 3.x models (for example gemini-3-pro-preview) always require billing to be enabled in your Google Cloud project. Plugin website: https://seomagic.click/\ Documentation: https://seomagic.click/documentation/\ PRO license & pricing: https://seomagic.click/pricing/ Main Features (Free) 1. Metadata SEO – bulk editor for titles & descriptions Manage all your post, page and custom post type metadata from a single screen:

• See SEO coverage bars for each content type.
• Edit SEO title and meta description in a clean modal.
• Generate suggestions for:
• SEO title and meta description.
• Facebook / Open Graph title and description.
• Twitter title and description.
• Check length indicators so you stay within common search and social limits.
• Generate metadata in batches of up to 20 items at a time to avoid overloading your server.

You can accept, edit or ignore AI suggestions at any time — nothing is changed automatically without your confirmation from this screen. 2. Multimedia SEO – image titles, alt text, captions and descriptions Fix image SEO in bulk from the Media Library:

• List attachments with their current title, alt text, caption and description.
• Quickly see which images are missing important fields.
• Open a modal to:
• Edit text fields manually, or
• Generate all fields (Title, Alt Text, Caption, Description) with one click.
• Use the AI to create descriptive alt attributes based on file names and basic context.

This helps improve accessibility and image search visibility without manually editing each attachment. 3. Content Assistant – Google-optimized rewriting workflow The Content Assistant is a dedicated interface to rewrite and optimize posts following Google-friendly best practices (E-E-A-T, readability, heading structure, etc.):

• Load an existing post using the built-in search and filters.
• Review the current content and featured image.
• Click Optimize Content to:
• Improve headings and paragraphs for clarity and flow.
• Generate a stronger, more emotional introduction.
• Suggest FAQs you can add to the post.
• Suggest schema types you may want to implement.
• See mobile and desktop previews of how your titles and snippets may look in search.
• Adjust metadata (SEO title, description, social tags) and featured image alt text from the same screen.

The assistant works on top of your content; it preserves protected blocks and layout shortcodes, and you decide what to keep before updating the post. 4. Autopilot – background metadata & image completion Autopilot is an optional background task that fills in missing fields for you:

• Runs on a schedule using WordPress cron.
• Scans only the content types you selected in Settings → Scan Content Types.
• Can generate:
• Content fields: SEO title, meta description, Facebook / Twitter titles and descriptions.
• Image fields: Title, Alt Text, Caption, Description.
• Focuses on missing fields; existing values are generally preserved.

You stay in control of the schedule and which fields Autopilot is allowed to touch. You can turn Autopilot off at any time if you prefer a fully manual workflow. PRO Features (optional upgrade) The PRO license unlocks advanced automation and analysis features inside the same plugin (no separate download): 1. WooCommerce Assistant – inline AI for product copy If you use WooCommerce, SEO Magic adds pink AI buttons directly inside the product editor:

• Product title – generate or refine a clear, keyword-rich product name.
• Long description – generate or rewrite a structured, benefit-oriented description.
• Short description – create a concise summary focused on key features.
• Product tags – suggest relevant tags for internal navigation and search.

The AI reads existing product information (title, price, attributes, descriptions, categories, etc.) and writes directly into the field you chose. You can edit the result, undo the change, or generate a new suggestion in seconds. SEO titles and meta descriptions for products are managed from the Metadata SEO tools, together with your posts and pages. 2. Auto-Linking Assistant (Internal & External links)

• Analyze a post to see how many internal and external links it already has.
• Get suggestions for:
• Internal links to other relevant posts from your own site.
• External links from your Google Programmable Search Engine.
• Insert links manually into your content or paste a custom URL.

All suggestions are manual – the plugin never injects links into your content without your explicit action. 3. Backlink Audit & Toxicity Analysis

• Connect to Google Search Console (via OAuth) and fetch linking domains, or upload a CSV export.
• Group backlinks by referring domain so you can see where most links come from.
• Use AI-assisted labels (high-authority, suspicious, etc.) to understand quality at a glance.
• Optionally check domains against Google Safe Browsing to detect potentially risky sources.
• Export a disavow file or use the data to update your own disavow list.

4. Site Health & Technical SEO Audit Run a one-click audit that combines:

• An Overall Site SEO Score (0–100) based on internal content scores and mobile performance.
• PageSpeed Insights (Mobile) data:
• Performance score.
• Core Web Vitals when available (LCP, FID, CLS).
• Lighthouse category scores (SEO, Accessibility, Best Practices).
• Basic technical SEO checks:
• robots.txt presence.
• Indexability settings.
• HTTPS status.
• PHP version, memory and basic cache information.
• A list of Content Requiring Attention, sorted from lowest to highest internal score, with quick links to edit each post.

Use this report as a practical roadmap for improving your site over time. 5. Advanced Settings: Google APIs, ACF & AI Model Rules PRO also unlocks advanced configuration options:

• Google API Settings – centralize your:
• Google Search API key (Custom Search, Safe Browsing, PageSpeed).
• Programmable Search Engine ID for external links.
• Google OAuth credentials for Search Console.
• ACF Integration – choose which text-based ACF fields should be included as context when generating metadata or content.
• AI Model Rules – define conditions to use different Gemini models for specific post types or categories.

These tools give more control to power users managing large or complex sites.

1. Upload the seo-magico folder to the /wp-content/plugins/ directory, or install the plugin via the WordPress Plugins screen.
2. Activate the plugin through the Plugins menu in WordPress.
3. Click Settings in the plugin row on the Plugins screen, or go to SEO Magic → Settings in the admin menu.
4. Paste your Google Gemini API key and save.
5. (Optional) Purchase and activate a PRO license from https://seomagic.click/pricing/ to unlock Autolinking, Backlink Audit, Site Health Audit and advanced settings.
6. Open a post, page, product or media item and start using the Metadata, Content, WooCommerce and Multimedia tools.

You can deactivate the plugin at any time. Data stored in your posts (titles, descriptions, alt text, etc.) remains in WordPress.

1.0.7

• Content Assistant: Added support for the “Main Site Topic” setting so rewrites can better follow the overall theme and positioning of the website.
• Content Assistant: Improved handling of the Extra Prompt field; user instructions now have higher priority and are more strictly followed by the AI.
• Performance: Adjusted the assistant proxy configuration to run prompts closer to Google’s Gemini infrastructure, improving response speed and stability.
• WooCommerce: Refined the WooCommerce product assistant prompt for clearer, benefit-focused long descriptions and more concise, conversion-oriented short descriptions.

1.0.6

• Added support for the Gemini 3 Pro (Preview) model in Default AI Model and AI Model Rules.
• Updated Content Assistant timeout to improve stability on long-running generations and reduce timeout errors.
• Note: Gemini 3.x preview models require billing to be enabled in your Google Cloud project.

1.0.5

• Security & Architecture: Major security upgrade. All AI prompt logic has been migrated to a secure proxy server, reducing plugin weight and increasing safety.
• Metadata Module: Improved Metadata generation with Search Intent detection (Informational vs Transactional).
• Metadata Module: Implemented AIDA formula (Attention, Interest, Desire, Action) for higher CTR meta descriptions.
• Multimedia SEO: Enhanced Image Alt Text generation focusing on WCAG accessibility standards and semantic context ("reading" the image, not just guessing).
• WooCommerce: Improved Long Description generation using the "Benefits over Features" method with better HTML structure (H3, lists, bolding).
• WooCommerce: Short Descriptions now use an "Elevator Pitch" style to target customer pain points immediately.
• Content Assistant: Upgraded to "Editor-in-Chief" mode prioritizing reader retention and semantic structure (H2/H3).
• Content Assistant: FAQs are now optimized for Zero-Click searches with direct and concise answers.
• Auto-Linking: Smart Auto-Linking update. The system now detects semantic concepts for internal linking opportunities instead of just exact keyword matches.
• Schema: Fixed validation errors in Schema generation (specifically preventing 'frequentlyAskedQuestions' inside Person type).
• UI/UX: Redesigned AI Usage Panel and improved API quota error messaging for better clarity.
• Backlink Audit: Refined toxicity analysis prompts for more accurate risk assessment.

1.0.4

• Updated default Gemini model to gemini-2.5-flash and added new model options (gemini-2.5-flash-lite, gemini-2.5-pro) aligned with Google AI Studio’s current free tier.
• Updated the Content Assistant and other tools to use the selected model instead of forcing gemini-2.5-pro.
• Added a Settings link in the WordPress Plugins screen for quicker access to the main configuration panel.
• Updated documentation to clarify that Gemini 3.x models (for example gemini-3-pro-preview) require billing to be enabled in your Google Cloud project.

1.0.3

• Fixed review button error.
• Updated translations for Spanish, French, Italian, Arabic, and Chinese.
• Fixed error when creating a draft: "Cannot update post. Invalid post ID received."

1.0.2

• Major refactor to follow WordPress.org coding standards and security best practices.
• Improved sanitization, validation and escaping of user input and output.
• Added nonces and capability checks to AJAX handlers and admin forms.
• Implemented a secure license proxy on our server to avoid exposing API keys in the plugin code.
• Switched all remote requests to use SSL verification.
• Introduced new admin UI for Metadata SEO, Multimedia SEO and Content Assistant.
• Added WooCommerce inline assistant for product titles, descriptions and tags.
• Added Autopilot for background metadata and image completion.
• Added Auto-Linking Assistant, Backlink Audit and Site Health Audit as PRO-only tools.
• Updated readme with detailed information about features, external services and privacy.

1.0.1

• Added Content Assistant for posts and pages.
• Introduced Media SEO tools for bulk alt text optimization.
• Initial support for WooCommerce product SEO.
• UI improvements in the admin pages.

1.0.0

• Initial release of SEO Magic – AI-powered metadata assistant for WordPress.