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-3.1-flash-lite-preview, gemini-3-flash-preview, gemini-2.5-flash, gemini-2.5-flash-lite and Pro options such as gemini-3.1-pro-preview). By default, the plugin uses Gemini 3.1 Flash-Lite Preview, which is recommended for free-tier friendly, high-volume SEO generation. Pro models such as gemini-3.1-pro-preview may require billing to be enabled in your Google Cloud project. Plugin website: https://seomagic.click/\ Documentation: https://seomagic.click/ PRO license & pricing: https://seomagic.click/ 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) An optional PRO add-on unlocks advanced automation and analysis features. The free plugin stays focused and easy to understand, while advanced tools can be added later from https://seomagic.click/. 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) Install the SEO Magic Pro add-on from https://seomagic.click/ if you want advanced tools such as Auto-Linking, Backlink Audit, Site Health Audit and license-based PRO features.
6. Open a post, page or media item and start using the free Metadata, Content Assistant 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.4.9

• Settings: Fixed archive scan options so deselecting Categories saves an empty selection instead of restoring the previous value.
• Content Assistant: Expanded the Schema selector with Auto-Detect Type, Article, BlogPosting, NewsArticle, FAQPage, HowTo, Recipe, Product, Person and LocalBusiness.
• Schema: Normalized requested schema types before sending them to the AI proxy, so variants such as howto, How To and HowTo are handled consistently as HowTo.
• Schema: Improved schema_type sanitization in the assistant AJAX handler to preserve valid camel case values.

1.4.8

• Metadata SEO: Added support for category, tag, public taxonomy and author archive meta descriptions.
• Dashboard: Included taxonomy and author archives in coverage recalculation.
• UX: New and updated content is scanned automatically so it appears in Metadata SEO without a manual recalculation.

1.4.7

• Content Assistant: Added clearer validation messages when the post title or content is missing.
• Content Assistant: Added a dedicated Publish button in the review step and improved AJAX error handling when saving posts.
• UI: Styled the new Publish button to match the plugin design and improved review footer responsiveness.

1.4.6

• WooCommerce PRO: Reworked product short and long description generation to use a cautious direct Gemini prompt that avoids unsupported claims.
• WooCommerce PRO: Added optional external product research through the configured Google Custom Search API, using only search result snippets as supporting context.
• WooCommerce PRO: Sends current unsaved title, SKU, price and editor content to the generator so title-and-price-only products produce safer descriptions.
• WooCommerce PRO: Cleaned the product editor inline buttons script and fixed the long-description label.

1.4.5

• Updated the recommended/default Gemini model to gemini-3.1-flash-lite-preview for higher free-tier daily request allowance on SEO tasks.
• Added a one-time admin migration from the old gemini-2.5-flash default to the new recommended model, while keeping manual model selection available.
• Reordered model selectors to show Gemini 3.1 Flash-Lite first and clarified labels for stable fallbacks and billing-required Pro models.
• Updated local request-per-minute throttling per model to better match the current free-tier limits.

1.4.4

• Content Assistant: Locked the Link Assistant card correctly in the free plugin so the Analyze Links button cannot be clicked without the Pro add-on.
• UI: Kept the "See SEO Magic Pro" calls to action fully visible and in the foreground inside locked cards.
• Editor: Aligned the Link Assistant metabox with the same Pro lock behavior used in the main assistant.

1.4.2

• UX: Changed free "More information" links to point to the main SEO Magic website instead of documentation.
• UI: Improved the visual style of PRO upsell links in the dashboard, Content Assistant and locked settings areas.

1.4.1

• Fixed a fatal error on admin screens when the free plugin was used without the Pro add-on.
• Kept the Gemini API setup flow focused on Google AI Studio.

1.4

• Free / PRO split: Removed PRO license screens and locked PRO menu items from the free plugin so the first-run experience is simpler and less confusing.
• Onboarding: Updated the Gemini API help button to open Google AI Studio API keys directly: https://aistudio.google.com/api-keys
• Readme: Clarified that advanced features are available through the SEO Magic Pro add-on from https://seomagic.click/.
• Packaging: Bumped the free plugin version to 1.4 for the new add-on-ready structure.

1.2.2

• Content Assistant: Fixed the Link Assistant button inside the assistant so it responds reliably again and follows the same suggestion flow as the Auto-Linking Assistant when a saved post is loaded.
• Link Assistant: Restored clearer visual differentiation between internal and external suggestions, including the external icon and plugin color styling.
• Auto-Linking / External links: Improved Google Custom Search error messaging so missing API access is explained more clearly from the plugin side.
• Google Search Console: Unified the OAuth redirect URI used by the plugin to reduce redirect mismatch issues during account connection.
• UX / Stability: Polished onboarding, documentation links and assistant interactions based on the latest production fixes.

1.2

• Onboarding: Improved the initial Gemini API setup flow with clearer guidance, better validation and a stronger distinction between the Gemini API key and the SEO Magic license.
• Onboarding: Locked the main plugin screens until a valid Gemini API key is configured, while keeping documentation and settings accessible.
• Documentation: Updated documentation buttons and setup links to point to the Gemini API guide and the main documentation page consistently.
• Content Assistant: Improved HTML cleanup, protected complex blocks more safely and reduced invalid wrappers when moving content between the classic editor and Gutenberg.
• Link Assistant: Fixed loading, labels and action states in the assistant and Auto-Linking UI.
• AIOSEO compatibility: Fixed metadata coverage and related reads so existing AIOSEO data is detected correctly again, including sites that store values in the AIOSEO table.
• Stability: Hardened license activation/deactivation permissions and removed a possible fatal path in the legacy Gemini compatibility route.

1.1.2

• Content Assistant: Improved HTML cleanup before AI requests and before saving content.
• Content Assistant: Added stronger protection for complex structures such as figures, tables, embeds, media, links, code blocks, details and shortcodes.
• Content Assistant: Improved compatibility when moving content between the classic editor and Gutenberg.
• Content Assistant: Added safer normalization to reduce invalid wrappers around protected blocks and complex HTML.
• Stability: Hardened license activation and deactivation permission checks.
• Stability: Removed a possible fatal path from the legacy Gemini compatibility function.

1.1

• Updated all Google Cloud Run proxy URLs to the new endpoints for Assistant, Audit, Linking, Media, Metadata, Schema and WooCommerce.
• Updated the plugin documentation and model references to use current Gemini models.
• Replaced outdated Gemini 3 Pro preview references with gemini-3.1-pro-preview where applicable.
• Kept Gemini model settings compatible with the available default and fallback models.
• Clarified that Gemini 3.x preview models require billing to be enabled in your Google Cloud project.

1.0.8

• Dashboard: Removed the local usage counter.
• Dashboard: Recent Activity now includes all SEO Magic tools.
• Dashboard: Error Log now reports errors from all modules.
• Site Health Audit: Added a content type filter dropdown.
• Deactivation feedback: Added a “Quick Feedback” modal on deactivation (like popular plugins).
• Deactivation feedback: When users click “Submit & Deactivate”, their reason is emailed to seo.magico.click@gmail.com with subject tag "DESACTIVACION DE PLUGIN".
• Deactivation feedback: “Skip & Deactivate” sends nothing.
• Licensing: PRO checks now rely on the plugin's first-party license flow.
• UI: All commercial CTAs now point to https://seomagic.click/.

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 Gemini 3.x preview models 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.1-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.