User Guide - Magento 2 AI Seo

User Guide

Welcome to Magehq Docs

MageHQ AI SEO for Magento 2 - User Guide

Overview

MageHQ AI SEO is a comprehensive SEO automation platform for Magento 2 that helps merchants optimize products, categories, CMS pages, and other content using AI-powered recommendations and automation tools.

The extension provides:

  • AI Content Generation

  • SEO Audits

  • Search Performance Analytics

  • Keyword Management

  • Rank Tracking

  • Internal Linking

  • Competitor Analysis

  • XML Sitemap Management

  • Index Control

  • URL Rewrite Management

  • Structured Data Validation

  • Bulk SEO Optimization

Installation


php bin/magento module:enable Magehq_AISeo
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

Configuration

Navigate to:

Stores → Configuration → MageHQ → AI SEO

Configure:

General Settings

  • Enable Module

  • Enable AI Features

  • Default Store Configuration

AI Provider Settings

Configure your preferred AI provider:

  • OpenAI

  • Anthropic Claude

  • Google Gemini

  • Custom Provider

Enter:

  • API Key

  • Model

  • Request Limits

  • Generation Settings

Save configuration and clear cache.

AI SEO Dashboard

Navigate to:

MageHQ → AI SEO → Dashboard

The Dashboard displays:

  • SEO Health Score

  • Audited Pages

  • Optimization Status

  • Search Performance Metrics

  • Recommendations Summary

Use the dashboard to monitor overall SEO health.

On-Page SEO

Navigate to:

MageHQ → AI SEO → On-Page SEO

This section helps optimize:

  • Products

  • Categories

  • CMS Pages

  • Blog Posts

Features:

  • Metadata generation

  • Content analysis

  • SEO recommendations

  • Optimization suggestions

SEO Audit

Navigate to:

MageHQ → AI SEO → SEO Audit

SEO Audit analyzes content and identifies issues.

Run Audit

  1. Open an entity.

  2. Click Run SEO Audit.

  3. Review audit results.

The audit evaluates:

  • Meta Title

  • Meta Description

  • Meta Keywords

  • Content Quality

  • Internal Links

  • SEO Score

Audit Results

Possible statuses:

Status Description
Healthy No significant issues found
Warning Optimization recommended
Critical Major SEO issue detected

AI Content Generation

Open a Product, Category, CMS Page, or Blog Post.

Available actions:

Generate Meta Title

Click:

Generate Meta Title

The AI creates an optimized title based on content and keywords.

Generate Meta Description

Click:

Generate Meta Description

The AI generates a search-engine-friendly description.

Generate Meta Keywords

Click:

Generate Meta Keywords

Suggested keywords are generated automatically.

Generate All

Click:

Generate All

This generates:

  • Meta Title

  • Meta Description

  • Meta Keywords

in a single operation.

Search Performance

Navigate to:

MageHQ → AI SEO → Search Performance

Connect Google Search Console

  1. Configure credentials.

  2. Select Search Console property.

  3. Save configuration.

  4. Run synchronization.

Available metrics:

  • Clicks

  • Impressions

  • CTR

  • Average Position

Keywords

Navigate to:

MageHQ → AI SEO → Keywords

Manage SEO keywords for your store.

Features:

  • Keyword tracking

  • Search performance analysis

  • Keyword management

Keyword Opportunities

Navigate to:

MageHQ → AI SEO → Keyword Opportunities

Discover:

  • Untapped keywords

  • Ranking opportunities

  • Content gaps

Use recommendations to improve organic visibility.

Rank Tracking

Navigate to:

MageHQ → AI SEO → Rank Tracking

Track:

  • Target keywords

  • Ranking history

  • Ranking trends

Monitor progress over time.

Competitors

Navigate to:

MageHQ → AI SEO → Competitors

Monitor competitor SEO activity.

Features include:

  • Competitor comparison

  • SEO benchmarking

  • Opportunity discovery

Recommendations

Navigate to:

MageHQ → AI SEO → Recommendations

The recommendation engine analyzes:

  • Content quality

  • Metadata

  • Technical SEO

  • Internal linking

Recommended actions are prioritized by impact.

Internal Links

Navigate to:

MageHQ → AI SEO → Internal Links

Review internal linking opportunities.

Benefits:

  • Improved crawlability

  • Better page authority distribution

  • Stronger keyword relevance

Index Control

Navigate to:

MageHQ → AI SEO → Index Control

Manage indexing behavior.

Create Noindex Rule

  1. Click Add Rule.

  2. Enter URL pattern.

  3. Select:

    • Noindex

    • Nofollow

    • Noindex, Nofollow

  4. Save.

Example:

/catalogsearch/*

Prevents search result pages from being indexed.

Robots Rules

Navigate to:

MageHQ → AI SEO → Robots Rules

Create custom robots directives.

Example:

Disallow: /checkout/
Disallow: /customer/

AI Sitemap

Navigate to:

MageHQ → AI SEO → AI Sitemap

Generate XML sitemaps.

Supported entities:

  • Products

  • Categories

  • CMS Pages

  • Custom URLs

Generate Sitemap

  1. Click Generate Sitemap.

  2. Wait for processing.

  3. Submit sitemap to Google Search Console.

URL Rewrite

Navigate to:

MageHQ → AI SEO → URL Rewrite

Manage:

  • SEO-friendly URLs

  • Redirects

  • URL optimization

Structured Data Validator

Navigate to:

MageHQ → AI SEO → Structured Data Validator

Validate:

  • Product Schema

  • Organization Schema

  • Breadcrumb Schema

  • FAQ Schema

Review warnings and fix issues before publishing.

Bulk Optimizer

Navigate to:

MageHQ → AI SEO → Bulk Optimizer

Use Bulk Optimizer to process large catalogs.

Create Optimization Job

  1. Click Create Job.

  2. Select entity type.

  3. Select store view.

  4. Choose optimization action.

  5. Submit job.

The job is processed in the background.

Audit Backfill

Navigate to:

MageHQ → AI SEO → SEO Audit → Backfill

Backfill creates audits for entities that have never been audited.

Options:

  • Store filter

  • Entity filter

  • Force re-audit

  • Resume session

Troubleshooting

AI Generation Failed

Check:

  • API Key

  • AI Provider Status

  • Model Configuration

  • API Limits

Search Console Sync Failed

Verify:

  • Google credentials

  • Property access

  • API quota

  • Selected property

Bulk Job Stuck

Check:

php bin/magento queue:consumers:start magehq_aiseo_bulk_optimization_consumer

Audit Backfill Not Running

Verify:

php bin/magento cron:run

and confirm:

Enable Cron Optimization = Yes

Best Practices

  • Run SEO audits regularly.

  • Review recommendations weekly.

  • Optimize metadata before publishing content.

  • Monitor ranking trends monthly.

  • Keep XML sitemaps updated.

  • Use Index Control to prevent duplicate content indexing.

  • Maintain strong internal linking between related pages.

  • Connect Google Search Console for performance insights.

Support

For technical support, feature requests, and documentation updates, contact the MageHQ support team.

Website: https://magehq.com

Module: MageHQ AI SEO for Magento 2