research_keywords

Look up Google search volume, CPC, and competition for up to 100 keywords. Synchronous — returns a table immediately. Needs a paid credit balance: it is…

Cost: 25 credits.

research_keywords looks up Google Ads search volume, CPC, and competition for up to 100 keywords at once, powered by DataForSEO. It is synchronous — it returns a table immediately, with no background job to poll.

What it does

Given a list of keywords (plus an optional language and location), it returns one row per keyword with:

Search volume — average monthly Google searches.
CPC — the average cost-per-click advertisers pay.
Competition — the advertiser competition band (HIGH / MEDIUM / LOW).

It also prints a one-line summary with the total monthly search volume across the batch.

Who can run it

research_keywords needs a paid credit balance. It reads live data from a paid third-party provider, so it is not available on trial credits — buy any credit pack and it unlocks straight away. Your trial credits are untouched and keep working for crawls, audits, reports and Search Console tools.

If live keyword data is unavailable on this deployment, the tool returns a clear "keyword research is not yet enabled on this deployment" message and charges you nothing — no credits are reserved or spent. SeoGrep never returns sample or placeholder figures dressed up as real data.

Example

Ask your MCP client in plain language:

What's the search volume for "seo software" and "rank tracker"?

Input

Field	Type	Required	Description
`keywords`	string[]	Yes	Keywords to look up (1–100).
`language_code`	string	No	Language code (default 'en').
`location_code`	integer	No	DataForSEO location code (default 2840 = United States).

Returns

A table with one row per keyword — search volume, CPC, and competition — plus a total-volume summary line. While live data is off, it returns the "not yet enabled" message instead and charges nothing.