Amazon Search Intelligence SF
Amazon Keyword Summary MCP
Compare competitor traffic from search, ads, and recommendations. Call the Amazon Keyword Summary API via REST or MCP with your Nexscope API key.
Amazon Keyword Summary 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. Check Keyword Traffic Sources
Prompt: Show the available Amazon product traffic associated with [KEYWORD] in [MARKETPLACE].
2. Check The Latest Seven Days
Prompt: Show the available Amazon product traffic associated with [KEYWORD] in [MARKETPLACE]. Use the latest seven-day reporting window.
3. Check A Custom Reporting Period
Prompt: Show the available Amazon product traffic associated with [KEYWORD] in [MARKETPLACE]. Use the reporting period from [START_DATE] through [END_DATE] instead of the latest seven days. Keep the returned coverage and dates explicit.
4. Focus On Selected Competing Products
Prompt: Show the available Amazon product traffic associated with [KEYWORD] in [MARKETPLACE]. Keep only products [ASINS] in the keyword results.
5. Review Several Result Pages
Prompt: Show the available Amazon product traffic associated with [KEYWORD] in [MARKETPLACE]. Collect up to 3 pages for this research task. Request 10 results per page. Stop sooner if there is no next page, an empty result or an error. Deduplicate matching identifiers and do not describe the sample as the full market.
6. Prioritize Results By Search Visibility
Prompt: Show the available Amazon product traffic associated with [KEYWORD] in [MARKETPLACE]. Put [RANKING_PRIORITY] first, choosing all traffic keywords, natural traffic keywords, brand ad keywords, video ad keywords, AC recommended keywords, ER recommended keywords, TR recommended keywords, total keyword exposure score, organic-rank exposure score, Sponsored Products exposure score, brand-ad exposure score, video-ad exposure score, AC recommendation exposure score, TR recommendation exposure score or ER recommendation exposure score. Use [ASCENDING_OR_DESCENDING] order.
7. Find Keywords By Traffic Source
Prompt: Show the available Amazon product traffic associated with [KEYWORD] in [MARKETPLACE]. Filter for [KEYWORD_SEGMENT], choosing organic search, Sponsored Products ads, video ads, Sponsored Brands ads, PPC advertising keywords, search recommendation keywords or Sponsored Products recommendations. Use one segment for this request.
8. Find New Search And Recommendation Keywords
Prompt: Show the available Amazon product traffic associated with [KEYWORD] in [MARKETPLACE]. Show newly appearing [KEYWORD_SEGMENT], choosing traffic keywords, organic keywords, advertising keywords, all Sponsored Products keywords, Sponsored Products search keywords or Sponsored Products recommendation keywords. Use one segment for this request.
9. Review Search And Recommendation Keywords
Prompt: Show the available Amazon product traffic associated with [KEYWORD] in [MARKETPLACE]. Use the full-period segment for [KEYWORD_SEGMENT], choosing organic keywords, advertising keywords, all Sponsored Products keywords, Sponsored Products search keywords or Sponsored Products recommendation keywords. Use one segment for this request.
10. Review Brand-Ad Keywords
Prompt: Show the available Amazon product traffic associated with [KEYWORD] in [MARKETPLACE]. Use the full-period segment for [KEYWORD_SEGMENT], choosing all Sponsored Brands keywords, Sponsored Brands regular keywords or Sponsored Brands video keywords. Use one segment for this request.
11. Find New Brand-Ad Keywords
Prompt: Show the available Amazon product traffic associated with [KEYWORD] in [MARKETPLACE]. Show newly appearing [KEYWORD_SEGMENT], choosing all Sponsored Brands keywords, Sponsored Brands regular keywords or Sponsored Brands video keywords. Use one segment for this request.
What You Need to Provide
Replace the bracketed placeholders with your own research inputs. Keep source estimates, reporting periods and missing information explicit.
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/jsonAuthentication
Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxUsing an API key? Get your key from API Access and include it in the Authorization header shown above.
Call this MCP tool
nexscope_amazon_keyword_summaryhttps://api.nexscope.ai/mcptools/callInitialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.
{
"jsonrpc": "2.0",
"id": "amazon-keyword-summary-1",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_keyword_summary",
"arguments": {
"country": "US",
"last7d": true,
"pageNum": 1,
"pageSize": 10,
"searchKeyword": "phone case"
}
}
}MCP 2025-11-25 · Streamable HTTPProgress 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 |
|---|---|---|---|
searchKeyword | string | required | Search keyword, translate to the corresponding country's language whenever possible. Max length 1000 characters Example: phone case |
country | string | optional | Country site, default US. Options (13 total): US, UK, DE, CA, JP, FR, ES, IT, MX, AU, AE, BR, SA |
asins | string | optional | ASIN filter list, comma-separated; if not provided, returns all ASINs for this keyword. Max length 1000 characters Example: B072MQ5BRX |
condition | string | optional | Condition filter, only one at a time.<br>Flag type: nfPosition (natural traffic keyword), isSpAd (SP ad keyword), isVedioAd (video ad keyword), isBrandAd (brand ad keyword), isPPCAd (PPC ad keyword), isSearchRecommend (search recommendation keyword), acAd (SP recommendation)<br>Period count type: totalPeriod.in (new incoming traffic keywords), nfKeywordCnt.total / .in, adKeywordCnt.total / .in, allSpKeywordCnt.total / .in, spKeywordCnt.total / .in, recSpKeywordCnt.total / .in, allSbKeywordCnt.total / .in, sbKeywordCnt.total / .in, sbvKeywordCnt.total / .in |
last7d | boolean | optional | Whether to get last 7 days data, default true. When false, use startDate/endDate range Example: true |
startDate | string | optional | Start date yyyy-MM-dd (effective when last7d=false; if omitted, the latest system full week is used) Example: 2026-01-01 |
endDate | string | optional | End date yyyy-MM-dd (paired with startDate) Example: 2026-01-01 |
sortBy | string | optional | Sort field. Options: totalKeywordNum (all traffic keywords), naturalKeywordNum (natural traffic keywords), brandKeywordNum (brand ad keywords), vedioKeywordNum (video ad keywords), acKeywordNum (AC recommended keywords), erKeywordNum (ER recommended keywords), trKeywordNum (TR recommended keywords), sumScore (total keyword exposure score), totalNfScore, totalSpSocre (note spelling), totalBrandScore, totalVedioScore, totalAcScore, totalTrScore, totalErScore |
pageNum | integer | optional | Page number, default 1 Example: 1 |
pageSize | integer | optional | Results per page, min 10, max 100, default 100 Example: 10 |
desc | boolean | optional | Whether to sort descending, default true Example: true |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
code | string | optional | sf business return code, `"1"` indicates success |
msg | string | optional | news |
total | integer | optional | The actual amount of data returned this time |
data | array | optional | ASIN keyword traffic data array |
columns | array | optional | render column |
type | string | optional | rendering style |
title | string | optional | Title |
costTime | integer | optional | Time consuming (ms) |
costToken | integer | optional | Consume token |
asin | string | optional | ASIN code |
productTitle | string | optional | Product title |
productImageUrl | string | optional | Main image URL |
productPrice | number | optional | Product selling price |
customerRatingCount | integer | optional | Total customer ratings |
productStarRating | number | optional | Product star rating |
productRatingScore | number | optional | Product rating value |
productUpdateTime | string | optional | Product update time |
dataPeriodStartDate | string | optional | Data period start date |
totalExposureScore | number | optional | Total exposure score |
totalExposureRatio | number | optional | Total traffic share |
naturalSearchExposureScore | number | optional | Total organic search exposure score |
naturalSearchExposureRatio | number | optional | Natural search exposure ratio |
sponsoredProductsExposureScore | number | optional | SP ad impression total score |
sponsoredProductsExposureRatio | number | optional | SP advertising exposure ratio |
brandAdExposureScore | number | optional | Total brand advertising exposure score |
brandAdExposureRatio | number | optional | Brand advertising exposure proportion |
videoAdExposureScore | number | optional | Total video ad exposure score |
videoAdExposureRatio | number | optional | Video ad exposure ratio |
amazonsChoiceExposureScore | number | optional | AC exposure total score |
amazonsChoiceExposureRatio | number | optional | AC exposure ratio |
editorialRecommendationsExposureScore | number | optional | ER total exposure score |
editorialRecommendationsExposureRatio | number | optional | ER exposure ratio |
topRatedExposureScore | number | optional | TR exposure total score |
topRatedExposureRatio | number | optional | TR exposure ratio |
recommendPositionExposureScore | number | optional | Recommended position exposure total score |
recommendAdExposureScore | number | optional | Recommended advertising exposure score |
recommendAdExposureRatio | number | optional | Recommended advertising traffic share |
recommendNonadExposureScore | number | optional | Recommended position non-advertising exposure score |
recommendNonadExposureRatio | number | optional | Recommended non-advertising traffic share |
comprehensiveNaturalExposureScore | number | optional | Comprehensive organic traffic score |
comprehensiveNaturalExposureRatio | number | optional | Combined organic traffic share |
keywordTotalExposureScore | number | optional | The total score of this keyword |
keywordNaturalExposureScore | number | optional | Natural score for this keyword |
keywordSponsoredProductsExposureScore | number | optional | SP score of this keyword |
keywordBrandAdExposureScore | number | optional | Brand advertising score for this keyword |
keywordVideoAdExposureScore | number | optional | Video ad score for this keyword |
keywordAmazonsChoiceExposureScore | number | optional | AC score of this keyword |
keywordRecommendExposureScore | number | optional | Recommended position score for this keyword |
keywordRecommendAdExposureScore | number | optional | Advertising score for recommended positions for this keyword |
keywordRecommendNonadExposureScore | number | optional | This keyword recommendation position is not an advertising score |
keywordComprehensiveNaturalExposureScore | number | optional | Comprehensive natural score for this keyword |
ppcTrafficSources | array | optional | PPC Traffic Source Tags |
naturalSearchTrafficSources | array | optional | Organic search traffic source tag |
amazonRecommendationSources | array | optional | Amazon Recommended Source Mark |
promotionalDealSources | array | optional | Promotion source tag |
Format Illustration
Illustrative example with fictional data, not a live tool call.
Illustrative Question
Which products receive exposure for “phone case” on Amazon US over the last seven days?
Illustrative Response Explanation
The illustrative result contains one product, ASIN B000000001, with a total exposure score of 200 and natural-search exposure score of 150. These are exposure metrics, not clicks or purchases.
About this sample: Illustrative example only. Names, identifiers and numbers are fictional; no live tool call was made. Your results depend on your account, inputs and available data.
Published sample data is not available for this page. A format illustration or workflow guide is not a substitute for a published result.
View the MCP Request & Response Format
Examples
Illustrative example with fictional data, not a live tool call.
The JSON-RPC envelope below illustrates how the shown arguments and payload fit into MCP. It is not captured network traffic or proof of a successful call. Workflow-only examples do not include a result.
MCP Request
{
"jsonrpc": "2.0",
"id": "amazon-keyword-summary-example",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_keyword_summary",
"arguments": {
"country": "US",
"last7d": true,
"pageNum": 1,
"pageSize": 10,
"searchKeyword": "phone case"
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "amazon-keyword-summary-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"total\":1,\"data\":[{\"asin\":\"B000000001\",\"productTitle\":\"Example phone case\",\"totalExposureScore\":200,\"naturalSearchExposureScore\":150}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"total": 1,
"data": [
{
"asin": "B000000001",
"productTitle": "Example phone case",
"totalExposureScore": 200,
"naturalSearchExposureScore": 150
}
]
}
},
"isError": false
}
}