Skip to main content
Glama

Research Keywords

research_keywords
Read-onlyIdempotent

Finds keyword ideas for one to five seed terms. On labs, each idea contains its seed term. Every idea carries seed, the seed term it came from (null for a multi-seed google_ads run). Each call makes 1 request per seed term to the keyword provider (google_ads: 1 request in total), returning up to limit ideas in total. Every idea has search volume, CPC and competition. labs (the default) adds difficulty and intent; google_ads, for countries labs does not cover, has neither. A SERP overview per idea comes only with includeSerpInfo, on labs. With google_ads, close variants come back as one row listing them in closeVariants; its volume is the group's, so count it once. Results are not saved until you call save_keywords. If this refuses because the workspace is not set up, call get_setup_status and check its rows, including skipped ones. Related: check_keyword_audience, save_keywords, set_up_market.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNoMax ideas to return. Default from the provider, up to 1000.
sourceNolabs (default) or google_ads. google_ads has no difficulty, intent or SERP overview.
languageCodeNoLanguage code. Defaults to the priority market.
locationCodeNoDataForSEO location. Defaults to the priority market.
seedKeywordsYesOne to five seed keywords or a topic.
includeSerpInfoNoAdd a SERP overview (serpInfo) to each idea. labs only; rejected with google_ads.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
itemsYes
taskIdNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / includeSerpInfo
      Added value: +{
      +  "description": "Add a SERP overview (serpInfo) to each idea. labs only; rejected with google_ads.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / source / description
      Previous value: -"labs (default) or google_ads."New value: +"labs (default) or google_ads. google_ads has no difficulty, intent or SERP overview."
  2. Changed2 schema fields changed
    • removedOutput schema / properties / costUsd
      Removed value: -{
      -  "type": "number"
      -}
    • changedOutput schema / required
      Previous value: -[
      -  "costUsd",
      -  "items"
      -]New value: +[
      +  "items"
      +]
  3. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources