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.
| Question | GSC | Google Ads | DataForSEO |
|---|---|---|---|
| How is my site ranking for queries Google already shows me for? | Yes | — | Yes (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
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
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.comand 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

