Search & Trend Intelligence

SEO Keyword Metrics MCP

Get search volume, CPC, competition and difficulty for a list of keywords. Call the Keyword Metrics API via REST or MCP to automate SEO research.

CostRecent Avg. 20 · Range 18–20 credits / callOnline Test

SEO Keyword Metrics AI Prompts & Use Cases

After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.

New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.

1. Compare Keyword Demand And Competition

Prompt: Look up US English metrics for [keyword list]. Compare available search volume, cost per click and competition while distinguishing missing data from zero.

2. Separate Paid And Organic Keyword Difficulty

Prompt: Look up US English metrics for [keyword list]. Compare available search volume, cost per click and competition while distinguishing missing data from zero. Compare returned search volume and organic keyword difficulty separately from paid competition and USD cost per click. Use [my stated criteria] to shortlist available terms without substituting one competition measure for another.

3. Review Monthly Keyword Demand

Prompt: Look up US English metrics for [keyword list]. Compare available search volume, cost per click and competition while distinguishing missing data from zero. Show each keyword’s returned monthly search-volume series and metric update date. Highlight observed peaks, preserve missing months and avoid extrapolating future demand.

What You Need to Provide

This tool supports the US market; do not substitute another country.

Use English inputs and preserve the English-language scope.

Provide no more than 20 keywords.

Missing values are not zero. Interpret only returned evidence within its observation period and sample scope.

Step 1 · Connect

Connect Your AI Assistant

Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.

POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/json

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

Using an API key? Get your key from API Access and include it in the Authorization header shown above.

Call this MCP tool

MCP tool name

nexscope_seo_keyword_metrics

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "seo-keyword-metrics-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_seo_keyword_metrics",
    "arguments": {
      "keywords": [
        "nexscope"
      ],
      "language": "en",
      "market": "US"
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.

Arguments

Name	Type	Required	Description
`keywords`	`array`	required	Keywords value used by this API operation. Minimum items: 1 Maximum items: 20
`keywords[]`	`string`	required	Trimmed, at most ten whitespace-separated words. Minimum length: 1 Maximum length: 80
`language`	`string`	required	Language value used by this API operation. Allowed: en
`market`	`string`	required	Market value used by this API operation. Allowed: US

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`code`	`integer`	required	0 is a successful envelope; inspect data.status separately. Allowed: 0, 42008, 42009
`cost`	`string`	required	Elapsed processing milliseconds; not price. -1 for non-web context.
`data`	`object`	required	Data value used by this API operation.
`data.callId`	`string`	optional	Call id value used by this API operation. Format: uuid
`data.completedAt`	`string \| integer \| null`	optional	UTC epoch milliseconds.
`data.coverage`	`object`	optional	Coverage value used by this API operation.
`data.coverage.missing`	`array`	optional	Missing value used by this API operation.
`data.coverage.missing[]`	`object`	required	Item in data coverage missing.
`data.coverage.missing[].field`	`string`	optional	Field value used by this API operation.
`data.coverage.missing[].reason`	`string`	optional	Reason value used by this API operation.
`data.coverage.status`	`string`	optional	Status value used by this API operation.
`data.reason`	`string`	optional	Stable reason on errors 42001 through 42011; accepted errors retain callId.
`data.requestedAt`	`string \| integer \| null`	optional	UTC epoch milliseconds.
`data.result`	`object \| null`	required	Result value used by this API operation.
`data.result.items`	`array`	optional	Items value used by this API operation.
`data.result.items[]`	`object`	required	Item in data result items.
`data.result.items[].competition`	`number \| null`	optional	Competition value used by this API operation.
`data.result.items[].competitionLevel`	`string \| null`	optional	Competition level value used by this API operation.
`data.result.items[].cpcUsd`	`string \| null`	optional	Cpc usd value used by this API operation.
`data.result.items[].dataUpdatedAt`	`integer \| null`	optional	Data updated at value used by this API operation.
`data.result.items[].inputIndex`	`integer \| null`	optional	Input index value used by this API operation.
`data.result.items[].inputKeyword`	`string \| null`	optional	Input keyword value used by this API operation.
`data.result.items[].keywordDifficulty`	`number \| null`	optional	Keyword difficulty value used by this API operation.
`data.result.items[].missing`	`array`	optional	Missing value used by this API operation.
`data.result.items[].missing[]`	`object`	required	Item in data result items[] missing.
`data.result.items[].missing[].field`	`string \| null`	optional	Field value used by this API operation.
`data.result.items[].missing[].reason`	`string \| null`	optional	Reason value used by this API operation.
`data.result.items[].monthlySearches`	`array`	optional	Monthly searches value used by this API operation.
`data.result.items[].monthlySearches[]`	`object`	required	Item in data result items[] monthlySearches.
`data.result.items[].monthlySearches[].month`	`integer \| null`	optional	Month value used by this API operation.
`data.result.items[].monthlySearches[].searchVolume`	`integer \| null`	optional	Search volume value used by this API operation.
`data.result.items[].monthlySearches[].year`	`integer \| null`	optional	Year value used by this API operation.
`data.result.items[].normalizedKeyword`	`string \| null`	optional	Normalized keyword value used by this API operation.
`data.result.items[].searchVolume`	`integer \| null`	optional	Search volume value used by this API operation.
`data.result.items[].status`	`string`	optional	Status value used by this API operation. Allowed: AVAILABLE, NO_COVERAGE
`data.result.language`	`string \| null`	optional	Language value used by this API operation.
`data.result.market`	`string \| null`	optional	Market value used by this API operation.
`data.retryable`	`boolean`	optional	Retryable value used by this API operation. Constant: false
`data.schemaVersion`	`string`	optional	Schema version value used by this API operation. Constant: 1.0
`data.source`	`string`	optional	Source value used by this API operation. Constant: dataforseo
`data.status`	`string`	optional	Status value used by this API operation. Allowed: SUCCESS, PARTIAL, EMPTY, PROCESSING, UNKNOWN, FAILED
`data.usage`	`object \| null`	optional	Usage value used by this API operation.
`data.usage.billingStatus`	`string \| null`	optional	Billing status value used by this API operation.
`data.usage.chargedCredits`	`string \| integer \| null`	optional	Charged credits value used by this API operation.
`msg`	`string \| null`	required	Available upstream msg/errmsg/message is preferred for success and failure; Chinese is translated to English. Missing successful message is null. Platform-only errors and task states use platform English. Message text never determines success or retry.
`time`	`string`	required	yyyy-MM-dd HH:mm:ss
`traceId`	`string \| null`	required	Trace id value used by this API operation.
`ts`	`string`	required	Epoch milliseconds; global long serializer.

Example Q&A

Based on a published documentation sample, not a live tool call.

Your Question

Look up US English metrics for UGEARS UGT-24, ugears ugt-24 endurance racer. Compare available search volume, cost per click and competition while distinguishing missing data from zero.

Example Answer

The first keyword, “UGEARS UGT-24”, has reported search volume of 10 and competition of 0.71. Cost per click and keyword difficulty are missing, so neither should be displayed as zero.

About this sample: Based on a published documentation sample, not a new or live tool call. Preserve its dates, source scope and missing values; sample metrics do not describe current performance. Required transport wrapper values (cost, time, traceId and ts) are illustrative additions for schema completeness, not published timings; the result data is preserved.

View the Published Sample Data (JSON)

Published REST data example. Use Parameters & Response for MCP arguments when calling this tool.

Data Example

Sample request and response

Request parameters

{
  "market": "US",
  "keywords": [
    "UGEARS UGT-24",
    "ugears ugt-24 endurance racer"
  ],
  "language": "en"
}

Response

{
  "code": 0,
  "msg": null,
  "data": {
    "usage": {
      "billingStatus": "CHARGED",
      "chargedCredits": 19
    },
    "callId": "b7f9c0cc-c642-43cc-8cde-31b876507a76",
    "result": {
      "items": [
        {
          "cpcUsd": null,
          "status": "AVAILABLE",
          "missing": [
            {
              "field": "cpcUsd",
              "reason": "UPSTREAM_FIELD_MISSING"
            },
            {
              "field": "keywordDifficulty",
              "reason": "UPSTREAM_FIELD_MISSING"
            }
          ],
          "inputIndex": 0,
          "competition": 0.71,
          "inputKeyword": "UGEARS UGT-24",
          "searchVolume": 10,
          "dataUpdatedAt": 1789212517000,
          "monthlySearches": [
            {
              "year": 2026,
              "month": 8,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 7,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 6,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 5,
              "searchVolume": 0
            },
            {
              "year": 2026,
              "month": 4,
              "searchVolume": 0
            },
            {
              "year": 2026,
              "month": 3,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 2,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 1,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 12,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 11,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 10,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 9,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 8,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 7,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 6,
              "searchVolume": 20
            },
            {
              "year": 2025,
              "month": 5,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 4,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 3,
              "searchVolume": 0
            },
            {
              "year": 2025,
              "month": 2,
              "searchVolume": 0
            },
            {
              "year": 2025,
              "month": 1,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 12,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 11,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 10,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 9,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 8,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 7,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 6,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 5,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 4,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 3,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 2,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 1,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 12,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 11,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 10,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 9,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 8,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 7,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 6,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 5,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 4,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 3,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 2,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 1,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 12,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 11,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 10,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 9,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 8,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 7,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 6,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 5,
              "searchVolume": 0
            }
          ],
          "competitionLevel": "HIGH",
          "keywordDifficulty": null,
          "normalizedKeyword": "ugears ugt-24"
        },
        {
          "cpcUsd": null,
          "status": "AVAILABLE",
          "missing": [
            {
              "field": "cpcUsd",
              "reason": "UPSTREAM_FIELD_MISSING"
            },
            {
              "field": "keywordDifficulty",
              "reason": "UPSTREAM_FIELD_MISSING"
            }
          ],
          "inputIndex": 1,
          "competition": 0.6,
          "inputKeyword": "ugears ugt-24 endurance racer",
          "searchVolume": 10,
          "dataUpdatedAt": 1789252407000,
          "monthlySearches": [
            {
              "year": 2026,
              "month": 8,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 7,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 6,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 5,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 4,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 3,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 2,
              "searchVolume": 10
            },
            {
              "year": 2026,
              "month": 1,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 12,
              "searchVolume": 20
            },
            {
              "year": 2025,
              "month": 11,
              "searchVolume": 20
            },
            {
              "year": 2025,
              "month": 10,
              "searchVolume": 20
            },
            {
              "year": 2025,
              "month": 9,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 8,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 7,
              "searchVolume": 10
            },
            {
              "year": 2025,
              "month": 6,
              "searchVolume": 0
            },
            {
              "year": 2025,
              "month": 5,
              "searchVolume": 0
            },
            {
              "year": 2025,
              "month": 4,
              "searchVolume": 0
            },
            {
              "year": 2025,
              "month": 3,
              "searchVolume": 0
            },
            {
              "year": 2025,
              "month": 2,
              "searchVolume": 0
            },
            {
              "year": 2025,
              "month": 1,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 12,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 11,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 10,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 9,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 8,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 7,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 6,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 5,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 4,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 3,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 2,
              "searchVolume": 0
            },
            {
              "year": 2024,
              "month": 1,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 12,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 11,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 10,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 9,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 8,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 7,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 6,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 5,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 4,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 3,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 2,
              "searchVolume": 0
            },
            {
              "year": 2023,
              "month": 1,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 12,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 11,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 10,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 9,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 8,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 7,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 6,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 5,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 4,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 3,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 2,
              "searchVolume": 0
            },
            {
              "year": 2022,
              "month": 1,
              "searchVolume": 0
            },
            {
              "year": 2021,
              "month": 12,
              "searchVolume": 0
            },
            {
              "year": 2021,
              "month": 11,
              "searchVolume": 0
            }
          ],
          "competitionLevel": "MEDIUM",
          "keywordDifficulty": null,
          "normalizedKeyword": "ugears ugt-24 endurance racer"
        }
      ],
      "market": "US",
      "language": "en"
    },
    "source": "dataforseo",
    "status": "SUCCESS",
    "coverage": {
      "status": "PARTIAL",
      "missing": []
    },
    "completedAt": 1790060219463,
    "requestedAt": 1790060218706,
    "schemaVersion": "1.0"
  }
}

View the MCP Request & Response Format

Examples