Keyword & Search Demand

Amazon Keyword Overview MCP Tool

SIF overview analysis of Amazon keyword market competition.

MCP tool name
nexscope_amazon_keyword_overview
Equivalent REST API path
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-keyword-overview/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": "amazon-keyword-overview-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_keyword_overview",
    "arguments": {
      "keyword": "phone case",
      "country": "US",
      "last7d": true
    }
  }
}
REST API equivalent
POST /api/skill-api/v1/runhttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-keyword-overview/run
Canonical detail URL
https://www.nexscope.ai/mcp-map/amazon-keyword-overview

Arguments

NameTypeRequiredMeaning
keywordstringrequired
Keyword, translate to the corresponding country's language whenever possible. Max length: 1000 characters
Example: phone case
countrystringoptional
Country site, default US. Options (13 total): US, UK, DE, CA, JP, FR, ES, IT, MX, AU, AE, BR, SA
Example: {}
last7dbooleanoptional
Whether to get last 7 days data, default true. When false, use startDate/endDate range
Example: true
startDatestringoptional
Start date yyyy-MM-dd (effective when last7d=false)
Example: 2026-01-01
endDatestringoptional
End date yyyy-MM-dd (paired with startDate)
Example: 2026-01-01

Response fields

Treat structuredContent as the programmatic API response payload.

NameTypeRequiredMeaning
msgstringoptional
Message
Example: {}
totalintegeroptional
Total data count. Note: this endpoint typically returns only a single record, total is usually 1
Example: 1
codestringoptional
Response code
Example: {}
dataarrayoptional
Return data (see data fields below)
Example: []
costTimeintegeroptional
Latency (ms)
Example: 1
costTokenintegeroptional
Tokens consumed
Example: 1
columnsarrayoptional
Render columns
Example: []
typestringoptional
Render style
Example: {}
titlestringoptional
Title
Example: {}
data[].keywordstringoptional
Keyword. The keyword text of the search query
Example: phone case
data[].keywordPopularityRankintegeroptional
Keyword popularity rank. This keyword's monthly search volume ranking among all Amazon keywords; lower values indicate higher search volume
Example: 1
data[].estimatedWeeklySearchVolumeintegeroptional
Estimated weekly search volume. Estimated weekly search count for this keyword on Amazon, reflecting its search popularity
Example: 1
data[].supplyDemandRationumberoptional
Supply-demand ratio. Ratio of supply to demand, formula: search result product count / monthly search volume; lower values indicate less competition and greater opportunity
Example: 1
data[].totalSearchResultProductCountintegeroptional
Total search result product count. Total number of products displayed for this keyword (including natural search, ad placements, recommendation placements, etc.)
Example: 1
data[].naturalSearchProductCountintegeroptional
Natural search product count. Number of products displayed in natural search results for this keyword (excluding ad placements)
Example: 1
data[].sponsoredProductsCountintegeroptional
SP ad product count. Number of products running Sponsored Products ads for this keyword
Example: 1
data[].brandAdProductCountintegeroptional
Brand ad product count. Number of products running brand ads for this keyword
Example: 1
data[].videoAdProductCountintegeroptional
Video ad product count. Number of products running video ads for this keyword
Example: 1
data[].paidAdvertisingProductCountintegeroptional
Total PPC ad product count. Total number of products running any PPC paid ads for this keyword (including SP, brand ads, video ads, etc.)
Example: 1
data[].amazonChoiceProductCountintegeroptional
Amazon's Choice product count. Number of products with the Amazon's Choice badge for this keyword
Example: 1
data[].topRatedProductCountintegeroptional
Top Rated recommended product count. Number of products appearing in the Top Rated (high rating) recommendation placement for this keyword
Example: 1
data[].searchRecommendationProductCountintegeroptional
Search recommendation product count. Number of products recommended by Amazon when searching this keyword
Example: 1
data[].editorialRecommendationsProductCountintegeroptional
Editorial Recommendations product count. Number of products appearing in the editorial recommendation placement for this keyword
Example: 1
data[].recNonadProductCountintegeroptional
Recommendation placement non-ad product count. Number of non-ad (organic) products in recommendation placements for this keyword
Example: 1
data[].recAdProductCountintegeroptional
Recommendation placement ad product count. Number of ad products in recommendation placements for this keyword
Example: 1
data[].trackedAsinTotalCountintegeroptional
SIF tracked ASIN deduplicated total count. Deduplicated count of ASINs that SIF has tracked with exposure scores across all positions (natural/ad/recommendation) for this keyword (upstream field: totalAsinNum)
Example: 1
data[].totalMarketplaceKeywordCountintegeroptional
Total marketplace keyword count. Total number of keywords for this site, used to understand overall market size
Example: 1
data[].dataPeriodStartDatestringoptional
Data period start date. ABA week start date corresponding to the returned data (yyyy-MM-dd)
Example: 2026-01-01
data[].dataPeriodEndDatestringoptional
Data period end date. ABA week end date corresponding to the returned data (yyyy-MM-dd)
Example: 2026-01-01
data[].keywordDataUpdateTimestringoptional
Keyword data update time
Example: phone case
errcodeintegeroptional
Upstream status code returned by the provider.
Example: {}
errmsgstringoptional
Upstream status message returned by the provider.
Example: {}
messagestringoptional
Provider-specific message.
Example: {}
sourceTypestringoptional
Provider-specific source platform type.
Example: {}
sourceToolstringoptional
Provider-specific source tool name.
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",
  "country": "US",
  "last7d": true
}

Example structuredContent

{
  "total": 1,
  "data": [
    {
      "keyword": "phone case",
      "keywordPopularityRank": 1,
      "estimatedWeeklySearchVolume": 1,
      "supplyDemandRatio": 1,
      "totalSearchResultProductCount": 1,
      "naturalSearchProductCount": 1,
      "sponsoredProductsCount": 1,
      "brandAdProductCount": 1,
      "videoAdProductCount": 1,
      "paidAdvertisingProductCount": 1,
      "amazonChoiceProductCount": 1,
      "topRatedProductCount": 1,
      "searchRecommendationProductCount": 1,
      "editorialRecommendationsProductCount": 1,
      "recNonadProductCount": 1,
      "recAdProductCount": 1,
      "trackedAsinTotalCount": 1,
      "totalMarketplaceKeywordCount": 1,
      "dataPeriodStartDate": "2026-01-01",
      "dataPeriodEndDate": "2026-01-01",
      "keywordDataUpdateTime": "phone case"
    }
  ],
  "costTime": 1,
  "costToken": 1,
  "columns": []
}