Shop MCP

Connect a module

DataForSEO

DataForSEO is a paid data-vendor API for SERP scrapes, keyword volumes, backlinks, Lighthouse audits, and competitor intel. ShopMCP wraps 22 of their endpoints behind plain-English tools — no scraping infra, no SaaS subscription per seat, just pay-per-call usage charged to your DataForSEO account. Setup takes about 2 minutes.

Why connect DataForSEO at all

Search Console only shows queries Google actually showed your site for. Google Ads only shows yourad performance. Both are inside-out views — and both go dark the second you ask “what about my competitors?” or “what would a brand-new keyword cost to rank for?” DataForSEO is the outside-in counterpart: live SERPs, keyword volumes, backlinks, and competitor crawls for any domain on the web.

What each SEO module covers
QuestionGSCGoogle AdsDataForSEO
How is my site ranking for queries Google already shows me for?YesYes (any keyword)
What's the search volume + CPC for a keyword I don't yet rank for?Yes (within Keyword Planner)Yes — at scale, by country
Who are my organic competitors and what do they rank for?Yes — every keyword for any domain
What does the live SERP look like in Sydney vs London right now?Yes — Maps, Organic, Shopping
Who's linking to my domain (and to my competitors)?Yes — full backlink graph
Is my page Lighthouse-clean (Core Web Vitals, accessibility, SEO)?Yes — on-demand

1. Top up a DataForSEO account

DataForSEO is a third-party API you pay separately. Sign up at app.dataforseo.com/registerand add a credit card or wire balance. There's no monthly subscription — calls are billed against the prepaid balance at fractions of a cent each (most live SERP calls run $0.0006–$0.002, keyword + backlink lookups are similar). A $50 top-up easily covers a month of heavy research for a single brand.

Trial credit covers the first runs

New accounts get $1 of trial credit, which is enough to verify the connection works and run a handful of example prompts before you fund the account properly.

2. Grab your API credentials

From your DataForSEO dashboard, open API Access in the left nav. Copy two strings:

  • Login — the email address you signed up with. Doubles as the API username.
  • Password — the auto-generated API password shown on that page (not your dashboard login password). You can regenerate it any time without breaking other integrations.

API password ≠ dashboard password

The API password is a separate string DataForSEO mints for you on the API Access page. If you paste your dashboard login password, authentication will fail with a 401.

3. Paste them into ShopMCP

Open Settings → Integrations → DataForSEO and paste both fields. On submit ShopMCP makes one round-trip to GET /v3/appendix/user_data to verify the credentials and read the current balance, then encrypts the password at rest (KMS envelope) and labels the connection from your account email. The credentials never reach the LLM and never get logged.

Verification surfaces specific upstream errors so you can fix them quickly:

  • 401 / 403— “DataForSEO rejected the credentials.” Re-check that you used the API password and not the dashboard one.
  • 402 — account has zero balance. Top up at app.dataforseo.com and reconnect.

4. Run your first prompt

Once connected, the 22 dataforseo_* tools are available across every chat client signed in to this workspace. Try a warm-up that exercises a cheap endpoint:

  • What's my DataForSEO balance and how much have I burned this month?
  • Show the live Google organic SERP for “running shoes” in Australia.

What you can ask

The prompts below map to the seven tool families in the integration. Steal any of them as-is or use them as a starting point for your own workflows.

Keyword research & demand

  • Pull search volume, CPC, and competition for these 30 keywords in the UK.
  • Suggest 100 related keywords for “merino wool base layer” with volume and intent.
  • Classify the search intent on these 50 keywords — informational, commercial, transactional, or navigational.
  • Show me Google Trends for “ice bath” vs “cold plunge” over the last 24 months — which one is rising?
  • Give me a full keyword overview for “standing desk” — volume, difficulty, SERP features, and 12-month history.

SERP tracking

  • Show the top 20 organic results for “best running shoes for flat feet” in the US — include featured snippets and PAA boxes.
  • What does the local pack look like for “coffee near me” in Melbourne CBD?
  • Pull Google Shopping results for “air fryer” in Canada — top 50 listings with prices and merchants.
  • Compare the SERP for “wireless earbuds” in Sydney vs London vs New York — am I ranking in any of them?

Competitor intelligence

  • List every keyword competitor.com ranks for in the top 10, sorted by traffic value.
  • Find the 25 domains competing with us for the same keyword set — show overlap percentage.
  • Compare our top organic keywords vs competitor.com — what are they ranking for that we're not?
  • Which competitors gained the most ranked keywords this quarter?

On-page audits & Lighthouse

  • Run a Lighthouse audit on our homepage — performance, accessibility, SEO, best practices.
  • Parse the on-page content for /products/widget — pull headings, internal links, schema markup, word count.
  • Audit our top 5 landing pages with Lighthouse and tell me which one is the worst Core Web Vitals offender.
  • Compare on-page SEO between our /pricing page and the top-ranking competitor for “pricing” queries.

Content & brand mentions

  • Find articles mentioning our brand in the last 30 days — return sentiment and source authority.
  • Search the web for mentions of “ShopMCP” vs “competitor brand” — who's getting more press?

Shopping & marketplace research

  • Search Google Shopping for “protein powder” in the US — top 50 products with prices and merchant.
  • Who are the top sellers of this exact product on Google Shopping?
  • Pull Amazon search results for “ergonomic mouse” — top 30 products with rating and price.

Cross-module power moves

DataForSEO becomes much more useful when an LLM joins it to your first-party data. A few prompts that combine modules — they only work if you have the matching integrations connected too:

  • Pull my GSC queries that lost the most clicks last month, then for each one show the current SERP — am I being outranked, or is the SERP just changing? (GSC + DataForSEO)
  • Take my Google Ads top search terms by spend, look up their organic SERP positions, and tell me which ones I should bid less on because I rank #1 organically. (Google Ads + DataForSEO)
  • For my top 20 GMC products by impressions, show the live Shopping SERP for the product's primary query — who's undercutting me on price? (GMC + DataForSEO)
  • Find keywords competitor.com ranks for in the top 5, cross-reference my GSC data, and surface ones where I'm on page 2 — these are the quickest wins. (GSC + DataForSEO)
  • Audit my homepage with Lighthouse, then map the issues against my top 10 lowest-CWV pages from GSC — what's the pattern? (GSC + DataForSEO)

Cost awareness

DataForSEO bills per call out of your prepaid balance — a few cents per SERP / keyword call, dollars per Lighthouse audit. Every tool response includes a cost field, so you can ask things like:

  • How much did that last research session cost in DataForSEO credits?
  • Check my balance before we run that 50-domain competitor audit.

The cheapest tools are dataforseo_account_balance, dataforseo_keyword_search_volume, and the SERP calls. The most expensive tool is dataforseo_onpage_lighthouse(full Chrome rendering on DataForSEO's side) — use it deliberately on a handful of pages, not in batch loops.

Live vs task-based endpoints

Most tools hit DataForSEO's /live/ endpoints and return in under 30 seconds. Two tools — dataforseo_merchant_amazon_products and dataforseo_merchant_google_sellers— go through DataForSEO's task queue (post → poll), so they take ~5 minutes end-to-end. ShopMCP polls the task endpoint for you and returns when results are ready, but the chat client may show a longer spinner on those calls. Don't cancel.

Multi-account setups

DataForSEO credentials are agency-level — most workspaces only need one connection. If you do attach 2+ DataForSEO accounts (e.g. a client-billed account and an internal one), every dataforseo_* tool gets a store parameter that routes the call to a specific account. The first one you connected becomes the default.

Read-only by design

DataForSEO is a data-vendor API — it has no writes to gate. Every tool in the integration is read-only. There is no Allow writes toggle, no destructive prompts to confirm, and nothing the LLM can change in the upstream system. The only chargeable side effect is API credits.

Troubleshooting

  • “DataForSEO rejected the credentials” — you almost certainly pasted the dashboard login password instead of the API password. Open API Access in the DataForSEO dashboard and copy the API password string shown there.
  • “Account has no balance” — top up at app.dataforseo.com. The trial $1 expires after a few weeks of inactivity even if you haven't spent it.
  • HTTP 429 rate limits — DataForSEO enforces a per-minute call cap based on plan tier. Our client backs off and surfaces a typed error pointing at dataforseo_account_balance. Slow the prompt down (smaller batches, narrower locations) or upgrade your plan.
  • Keyword volume returns zero for an obvious term — Google Ads keyword volumes are bucketed and rounded; very low- or very high-traffic keywords sometimes report 0 or hit a ceiling. Cross-check with dataforseo_labs_keyword_overview, which uses DataForSEO's clickstream-derived volume model.
  • Backlink data looks stale— DataForSEO refreshes their backlink index continuously, but it's not real-time. Treat “first/last seen” dates as authoritative; the crawl can lag the live web by a few days.
  • Lighthouse audit returns nothing useful— make sure the URL is publicly fetchable (no auth wall, no aggressive bot block). DataForSEO's headless Chrome obeys robots.txt by default.

Coverage gaps we know about

DataForSEO's API exposes more than ShopMCP wraps today. Bing / YouTube SERPs, App Store rankings, historical timestamped SERPs, and the Google My Business business_data endpoints aren't shipped yet. If you need one of those for a workflow, email us — they're on the roadmap and easy to add when there's real demand.