Keyword & Search Demand

Google Trends By Keywords MCP Tool

Google Trends keyword search popularity comparison and trend analysis, supporting global regions and custom time ranges. Triggered by: Google Trends, keyword popularity over time, search interest comparison, keyword trend analysis, seasonal trend detection, regional search popularity, keyword heatmap, multi-keyword comparison on Google, keyword research, market trend analysis, search trends, seasonal analysis, regional popularity.

MCP tool name
nexscope_google_trends_by_keywords
Equivalent REST API path
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/google-trends-by-keywords/run
JSON-RPC method
tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

Authorization: Bearer nk_xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

Use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "google-trends-by-keywords-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_google_trends_by_keywords",
    "arguments": {
      "keyword": "phone case",
      "region": "US"
    }
  }
}
REST API equivalent
POST /api/skill-api/v1/runhttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/google-trends-by-keywords/run
Canonical detail URL
https://www.nexscope.ai/mcp-map/google-trends-by-keywords

Arguments

NameTypeRequiredMeaning
keywordstringrequired
Keyword (the keyword must be in the language of the target country! For example, use English keywords for the US, German keywords for Germany. If not in the corresponding country's language, please translate first.) Max length 100 characters
Example: phone case
regionstringoptional
Country/region, default US. Options: US, GB, JP, CA, MX, DE, FR, IT, ES, NL, AU, SG, AE, BR, IN, TR, PL, SE
Example: US
dayRangeStartstringoptional
Time range start (use when you want to freely specify the time range; custom time range takes priority), format YYYY-MM-DD, starting from 2004
Example: {}
dayRangeEndstringoptional
Time range end (use when you want to freely specify the time range; custom time range takes priority), format YYYY-MM-DD, starting from 2004
Example: {}

Response fields

Treat structuredContent as the programmatic API response payload.

NameTypeRequiredMeaning
trendInfoForKeysarrayoptional
Keyword trend info array
Example: []
trendInfoForKeys[].keywordstringoptional
Keyword
Example: phone case
trendInfoForKeys[].trendValuesarrayoptional
Trend value array
Example: []
trendInfoForKeys[].trendValues[].timeRangestringoptional
Time, format yyyy-MM-dd
Example: {}
trendInfoForKeys[].trendValues[].valuestringoptional
Value (normalized search interest, 0-100)
Example: {}
chartOptionobjectoptional
Chart rendering metadata
Example: {}
chartOption.typestringoptional
Data type
Example: {}
chartOption.fieldXstringoptional
X-axis field
Example: {}
chartOption.fieldYarrayoptional
Y-axis fields
Example: []
chartOption.dataarrayoptional
Data
Example: []
costTokenintegeroptional
Token consumption
Example: 1
errcodeintegeroptional
Upstream status code returned by the provider.
Example: {}
errmsgstringoptional
Upstream status message returned by the provider.
Example: {}
codestringoptional
Provider-specific status code.
Example: {}
msgstringoptional
Provider-specific status message.
Example: {}
messagestringoptional
Provider-specific message.
Example: {}
typestringoptional
Provider-specific render or payload type.
Example: {}
titlestringoptional
Provider-specific response title.
Example: {}
sourceTypestringoptional
Provider-specific source platform type.
Example: {}
sourceToolstringoptional
Provider-specific source tool name.
Example: {}
costTimeintegeroptional
Execution time reported by the upstream provider.
Example: {}
pageintegeroptional
Current page returned by the upstream provider.
Example: {}
pageSizeintegeroptional
Page size returned by the upstream provider.
Example: {}
pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
Example: {}
totalPageintegeroptional
Total page count returned by the upstream provider.
Example: {}
dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.
Example: {}

Examples

Example arguments

{
  "keyword": "phone case",
  "region": "US"
}

Example structuredContent

{
  "trendInfoForKeys": [
    {
      "keyword": "phone case",
      "trendValues": []
    }
  ],
  "chartOption": {
    "fieldY": [],
    "data": []
  },
  "costToken": 1
}