Amazon ABA & Business Insights

Amazon Keyword Intelligence MCP

Explore weekly Amazon Brand Analytics search-term data. Call the Amazon Keyword Intelligence API via REST or MCP with your Nexscope API key.

CostRecent Avg. 12 · Range 10–26 credits / callOnline Test

Amazon Keyword Intelligence 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. Research Weekly Search Terms

Prompt: Use Amazon Brand Analytics search-term data for [MARKETPLACE] to investigate this question: [RESEARCH_QUESTION].

2. Download Keyword Research

Prompt: Research [RESEARCH_QUESTION] using Amazon Brand Analytics data for [MARKETPLACE]. [INCLUDE_OR_SKIP] a CSV download link for the returned results.

3. Compare Click Share With Conversion Share

Prompt: Use Amazon Brand Analytics search-term data for [MARKETPLACE] to investigate this question: [RESEARCH_QUESTION]. For each returned search term, reporting week and region, compare the clicked products using their click and conversion shares. Show conversion share minus click share in percentage points only when both fractions are returned; never treat that difference as conversion rate.

4. Prioritize Weekly Search Terms

Prompt: Use Amazon Brand Analytics search-term data for [MARKETPLACE] to investigate this question: [RESEARCH_QUESTION]. Order the returned terms by search-frequency rank, with lower ranks first. Keep reporting weeks and regions separate and show which clicked ASINs belong to each term. Do not interpret rank as search volume.

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/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_amazon_keyword_intelligence

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": "amazon-keyword-intelligence-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_keyword_intelligence",
    "arguments": {
      "analysisDescription": "Find Amazon Brand Analytics search demand for phone case in the US marketplace",
      "createDownloadUrl": false,
      "region": "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
`analysisDescription`	`string`	required	Natural language description that precisely expresses the query intent Example: Analyze Amazon Brand Analytics search demand for phone case in the US marketplace
`region`	`string`	optional	Site code, default US. Options: US, DE, BR, CA, AU, JP, AE, ES, FR, IT, SA, TR, MX, SE, NL Example: US
`createDownloadUrl`	`boolean`	optional	Whether to generate a CSV download link, default false Example: false

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`success`	`boolean`	optional	Whether the query is successful.
`tables`	`array`	optional	Resulting data array; each element contains `data` (data row), `columns` (column definition), and `name` (sheet name).
`total`	`integer`	optional	Total number of results.
`downloadUrl`	`string`	optional	The CSV file address returned when `createDownloadUrl` is `true`.
`msg`	`string`	optional	Additional message.
`downloadNote`	`string`	optional	Tips for downloading.
`code`	`string`	optional	Return code.
`costTime`	`integer`	optional	Time taken, in milliseconds.
`costToken`	`integer`	optional	The token consumed by this call.
`data`	`array`	optional	Query result data rows. The actual columns will vary depending on the query conditions.
`columns`	`array`	optional	Result column definition.
`name`	`string`	optional	Sheet name.
`searchTerm`	`string`	optional	Consumer search keywords.
`reportStartDate`	`string`	optional	The start date of the data collection week.
`region`	`string`	optional	Amazon site code.
`searchFrequencyRank`	`integer`	optional	Search popularity ranking; the smaller the value, the higher the search popularity, and 1 is the most popular.
`clickedAsin`	`string`	optional	The ASIN of the clicked product.
`clickedItemName`	`string`	optional	The clicked product name.
`clickShareRank`	`integer`	optional	The click share ranking of this ASIN under this search term.
`clickShare`	`number`	optional	The click share received by this ASIN, ranging from 0 to 1.
`conversionShare`	`number`	optional	The conversion share obtained by this ASIN, ranging from 0 to 1.

Example Q&A

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

Your Question

Show the returned Brand Analytics figures for “garage door handle kit” in the US.

Example Answer

For the report beginning September 6, 2026, the sample reports a search frequency rank of 2,088,543. One clicked product is ASIN B000KKX9SU, with a click share of 0.0938 and conversion share of 0.2 as returned. Repeated rows occur in the sample; they should not be summed as independent observations.

About this sample: Search frequency rank is not search volume. Shares are retained as returned, and this historical sample is not the latest available report. The MCP JSON normalizes numeric strings to the numeric types in the documented schema; the original published REST sample remains available separately.

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

{
  "analysisDescription": "List the top 40 Amazon search terms by Brand Analytics search frequency rank (smaller rank = higher search volume) for the most recent available report week in the US marketplace, restricted to search terms containing or closely matching any of: door handle kit, trim replacement kit, auto interior accessories, car trim panel, replacement car parts interior. For each term return reportStartDate, searchTerm, searchFrequencyRank, and the top clicked ASINs with clickedAsin, clickedItemName, clickShare and conversionShare.",
  "region": "US",
  "createDownloadUrl": false
}

Response

{
  "code": 0,
  "msg": null,
  "data": {
    "tables": [
      {
        "data": [
          {
            "searchterm": "garage door handle kit",
            "clickShare": "0.0938",
            "reportstartdate": "2026-09-06",
            "clickeditemname": "Prime-Line GD 52121 Tee Latching Handle, Diecast Zinc (Single Pack)",
            "clickedasin": "B000KKX9SU",
            "searchfrequencyrank": "2088543",
            "conversionShare": "0.2"
          },
          {
            "searchterm": "garage door handle kit",
            "clickShare": "0.0938",
            "reportstartdate": "2026-09-06",
            "clickeditemname": "Prime-Line GD 52121 Tee Latching Handle, Diecast Zinc (Single Pack)",
            "clickedasin": "B000KKX9SU",
            "searchfrequencyrank": "2088543",
            "conversionShare": "0.2"
          },
          {
            "searchterm": "garage door handle kit",
            "clickShare": "0.0938",
            "reportstartdate": "2026-09-06",
            "clickeditemname": "Garage Door Lock Kit, Complete Set with Spring Latch and Keyed Handle",
            "clickedasin": "B0D9LSBTLP",
            "searchfrequencyrank": "2088543",
            "conversionShare": "0.0"
          },
          {
            "searchterm": "garage door handle kit",
            "clickShare": "0.0938",
            "reportstartdate": "2026-09-06",
            "clickeditemname": "Garage Door Lock Kit, Complete Set with Spring Latch and Keyed Handle",
            "clickedasin": "B0D9LSBTLP",
            "searchfrequencyrank": "2088543",
            "conversionShare": "0.0"
          },
          {
            "searchterm": "garage door handle kit",
            "clickShare": "0.0938",
            "reportstartdate": "2026-09-06",
            "clickeditemname": "QZATTCAEN Heavy-Duty Garage Door Lock Kit, Universal L-Handle with Inside Side Latch, Copper Cylinder & Keys, Zinc Alloy Handle, Complete Hardware Set for Shed Barn Garage Doors, 3 Sizes Screws-1 Set",
            "clickedasin": "B0GT95PT1V",
            "searchfrequencyrank": "2088543",
            "conversionShare": "0.0"
          },
          {
            "searchterm": "garage door handle kit",
            "clickShare": "0.0938",
            "reportstartdate": "2026-09-06",
            "clickeditemname": "QZATTCAEN Heavy-Duty Garage Door Lock Kit, Universal L-Handle with Inside Side Latch, Copper Cylinder & Keys, Zinc Alloy Handle, Complete Hardware Set for Shed Barn Garage Doors, 3 Sizes Screws-1 Set",
            "clickedasin": "B0GT95PT1V",
            "searchfrequencyrank": "2088543",
            "conversionShare": "0.0"
          }
        ],
        "columns": [
          {
            "filterable": true,
            "cellType": "text",
            "field": "reportstartdate",
            "sortable": true,
            "title": "reportstartdate"
          },
          {
            "filterable": true,
            "cellType": "text",
            "field": "searchterm",
            "sortable": true,
            "title": "searchterm"
          },
          {
            "filterable": true,
            "cellType": "number",
            "field": "searchfrequencyrank",
            "sortable": true,
            "title": "searchfrequencyrank"
          },
          {
            "filterable": true,
            "cellType": "text",
            "field": "clickedasin",
            "sortable": true,
            "title": "clickedasin"
          },
          {
            "filterable": true,
            "cellType": "text",
            "field": "clickeditemname",
            "sortable": true,
            "title": "clickeditemname"
          },
          {
            "filterable": true,
            "cellType": "number",
            "field": "clickShare",
            "description": "该ASIN获得的点击数占该搜索词总点击数的比例，取值范围：0-1",
            "sortable": true,
            "title": "点击占比"
          },
          {
            "filterable": true,
            "cellType": "number",
            "field": "conversionShare",
            "description": "该ASIN获得的购买数占该搜索词总购买数的比例，取值范围：0-1",
            "sortable": true,
            "title": "转化占比"
          }
        ],
        "name": "美国站最新一周汽车内饰配件相关搜索词Top 40",
        "userExplanation": "筛选美国站最新一周的数据，查找包含以下任一短语的搜索词：door handle kit（门把手套件）、trim replacement kit（装饰条更换套件）、auto interior accessories（汽车内饰配件）、car trim panel（汽车装饰板）、replacement car parts interior（内饰替换配件）。按搜索频率排名升序排列，返回排名前40的搜索词，以及每个搜索词对应的被点击ASIN、商品名称、点击占比和转化占比。站点：美国站。返回数量：40个搜索词。",
        "analysisStatement": ""
      }
    ],
    "total": 6,
    "downloadNote": "如需下载结果，请在消息栏发\"下载CSV文件\"告诉我。",
    "costTime": 44428,
    "success": true,
    "type": "tablesListWorkbenches",
    "title": "数据挖掘结果"
  }
}

View the MCP Request & Response Format

Examples