ShopMCP docs

Connect a module

Google Search Console

Search Console uses the same Google OAuth client as GA4, so if you already connected GA4 the consent step is silent.

1. Start the Google sign-in

Open Settings → Integrations and click Connect on the Search Console card. We request two read scopes:

  • https://www.googleapis.com/auth/webmasters.readonly — Search Console performance data
  • https://www.googleapis.com/auth/indexing — URL inspection and indexing status

Combined consent with GA4

If you connected GA4 first, Google has already cached our app — clicking Connect Search Console bumps the scope set on the existing grant rather than asking you to approve a new app.

2. Pick verified properties

ShopMCP lists every property the Google account has verified ownership for. Tick the ones you want available in chat. You can add more later from the same screen.

3. Run your first query

Try one of these in your chat client:

  • Which queries lost the most clicks last month?
  • Top 20 landing pages by impressions in the last 28 days
  • Find pages with high impressions but low CTR
  • Is /products/widget indexed?

Verification requirements

Search Console only returns data for properties the Google account has verified. If you can see the property at search.google.com/search-console, ShopMCP can see it too.

For domain-level properties (added via DNS TXT record), data is aggregated across all subdomains. URL-prefix properties only return data for that exact path.

Troubleshooting

  • "No verified properties" — the Google account isn't verified on any property. Verify ownership inside Search Console first, then refresh the connection.
  • Empty data for the last 2-3 days — Search Console has a 48-72 hour reporting delay. This is a Google limitation, not a ShopMCP one.
  • Indexing API returns "permission denied" — only verified owners(not delegated users) can call the Indexing API. Ask the original verifier to add you as an owner.