Home/Magento Documentation

How to Use the CrawlHunt Magento Extension

This guide walks Magento store owners through getting the CrawlHunt extension from the Adobe Commerce Marketplace, installing and enabling it on their store, and connecting it to their CrawlHunt account to run their first SEO audit.

Before You Start

What you'll need

A Magento 2.4.x store (Magento Open Source or Adobe Commerce, cloud or on-prem) running PHP 7.4 to 8.5
A CrawlHunt account
SSH access to your server, with permission to run bin/magento commands as the user that owns the store's files
A public store: CrawlHunt confirms you own it by fetching a small proof file while you connect, so it can't be behind a password or IP restriction
Admin access to your Magento admin panel
A backup of your database and app/ folder before you start
Don't have a CrawlHunt account yet? Create one for free before you begin.
Step-by-Step Guide

Magento Documentation

Follow each step in order. Open any screenshot at full size to see the details.

01Step 1 of 6

Get the extension from the Adobe Commerce Marketplace

CrawlHunt - Fix SEO/AEO/GEO is a free extension on the Adobe Commerce Marketplace (by THEMESHOPY PRIVATE LIMITED). Sign in with your Adobe ID, add it to your cart and check out at $0.00.

Open the Marketplace listing: https://commercemarketplace.adobe.com/themeshopy-crawlhunt-seo-audit.html
Choose your edition (Adobe Commerce or Magento Open Source) and your store version, then click Add to cart
Back up your database and your app/ folder before changing a live store
If your store runs in production mode, plan the install for a quiet period: compiling and deploying static files can take several minutes
CrawlHunt - Fix SEO/AEO/GEO on the Adobe Commerce Marketplace
CrawlHunt - Fix SEO/AEO/GEO on the Adobe Commerce MarketplaceOpen Full Screenshot
02Step 2 of 6

Install the extension with Composer

From your Magento root directory, as the user that owns the store's files, require the extension's package. Composer needs your Magento Marketplace access keys, the same ones used to install Magento itself.

Go to the root of your Magento installation (where app/, pub/ and bin/ are located)
Run: composer require themeshopy/crawlhunt-seo-audit
Verify that vendor/themeshopy/crawlhunt-seo-audit exists
SSH terminal showing composer require for the CrawlHunt extension
SSH terminal showing composer require for the CrawlHunt extensionOpen Full Screenshot
03Step 3 of 6

Enable the module via the command line

Connect to your server via SSH and run the following commands from your Magento root directory, as the user that owns the store's files, to register and enable the CrawlHunt module. These commands must be run in order.

Run: php bin/magento module:enable CrawlHunt_SeoAudit
Run: php bin/magento setup:upgrade — applies any database changes
Production mode only: php bin/magento setup:di:compile && php bin/magento setup:static-content:deploy -f
Run: php bin/magento cache:flush
Verify the module is active: php bin/magento module:status CrawlHunt_SeoAudit
SSH terminal showing successful module:enable and setup:upgrade output
SSH terminal showing successful module:enable and setup:upgrade outputOpen Full Screenshot
04Step 4 of 6

Connect the extension to your CrawlHunt account

Open your Magento admin panel. The CrawlHunt menu item will now appear in the left sidebar. Click it and then click Connect to link the extension to your CrawlHunt account via a secure OAuth flow.

Log in to your Magento admin panel
Find CrawlHunt in the left sidebar — it appears after module:enable and setup:upgrade (hard-refresh the page with Ctrl+Shift+R if the menu is missing)
Click Connect on the CrawlHunt home screen
Complete the authorization prompt to link your CrawlHunt account
Once connected, the CrawlHunt menu has six pages: Home, Dashboard, Pricing, AEO & GEO (AI visibility checks and fixes), Search Tools (canonical tags, schema markup, IndexNow and sitemap ping) and What's New
CrawlHunt Magento admin panel showing Connect button
CrawlHunt Magento admin panel showing Connect buttonOpen Full Screenshot
05Step 5 of 6

View your crawl results

Once connected, your store appears under Integrations and CrawlHunt automatically creates a project for it. Head to the Projects page in your CrawlHunt dashboard to see crawl results including site health score, errors, warnings, crawlability, HTTPS status, and internal linking score.

Open the CrawlHunt dashboard and go to Projects
Find your Magento store listed under Your Projects
Review site health, errors, warnings, and crawlability metrics
Click Run Again to trigger a new crawl at any time
CrawlHunt Projects dashboard showing Magento store crawl metrics
CrawlHunt Projects dashboard showing Magento store crawl metricsOpen Full Screenshot
06Step 6 of 6

Review issues and apply fixes

Click View on your project to open the audit results. Navigate to the Issues tab to see all detected SEO problems for your Magento store, including missing canonical tags, duplicate content, broken links, missing meta descriptions, image alt text issues, and schema markup errors.

Click View next to your project to open the audit report
Switch to the Issues tab to see all detected problems
Filter by issue type or priority to focus on what matters most
Apply fixes from the dashboard and rerun the audit to track improvements
CrawlHunt audit Issues tab showing SEO issues for Magento store
CrawlHunt audit Issues tab showing SEO issues for Magento storeOpen Full Screenshot
Magento Documentation

Ready to run your first SEO audit?

Open CrawlHunt to start auditing, or head back to the integration overview.