# Amazon MCP Server (`seemuapps/amazon-mcp`) Actor

MCP server exposing Amazon tools. Product, search, reviews, seller, global product. For any AI agent or LLM client.

- **URL**: https://apify.com/seemuapps/amazon-mcp.md
- **Developed by:** [Andrew](https://apify.com/seemuapps) (community)
- **Categories:** E-commerce, MCP servers, Agents
- **Stats:** 4 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.00005 / actor start

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Amazon MCP Server

The all-in-one MCP server for Amazon. Plug any AI agent - Claude, Cursor, ChatGPT, VS Code, or your own - into a single endpoint and pull live data from Amazon: full product detail, search results, reviews, seller storefronts, and listings from any regional Amazon domain.

### What you get

- **Full product detail** - title, ASIN, price, currency, rating, review count, seller, brand, availability, main image, description, and category for any amazon.com listing
- **Search results** - keyword search across any Amazon domain with configurable pages-per-keyword
- **Reviews** - flat per-review records with star rating, headline, body text, author, date, and verified-purchase flag, plus the parent product's totals
- **Seller storefronts** - seller name, ID, rating, review count, business name, and registered business address
- **Global product detail** - same fields as get-product plus `country_domain`, for any regional Amazon (de, co.uk, co.jp, fr, es, it, ca, com.au, in, com.mx, com.br, etc.)
- **Image hosting** - the main image of every product is saved to the run's Apify Key-Value Store and returned as `imageStorageUrl`, so you can embed it in your reply without fighting Amazon's CDN headers
- **One endpoint, five tools** - no glue code, no per-tool integrations, no scraping infrastructure to maintain

### Use cases

- E-commerce research - pull full catalogs of competitor listings into a sheet for analysis
- Price monitoring - track price, availability, and stock signals across products and regions
- Review analysis - extract review text in bulk for sentiment, theme, and complaint mining
- Competitive intelligence - compare brand/seller positioning, ratings, and assortment
- Supplier vetting - verify a third-party seller's storefront, business name, and address before placing orders
- AI shopping agents - give an LLM live grounding for product comparison, gift-finding, and buying advice
- Cross-region arbitrage - compare the same ASIN across amazon.de, amazon.co.uk, amazon.co.jp, etc.

### Tools exposed

| Tool                 | Returns                                                                       |
|----------------------|-------------------------------------------------------------------------------|
| `get-product`        | Full product detail for one or more amazon.com URLs                           |
| `search-products`    | Ranked search results for one or more keywords on any Amazon domain           |
| `get-reviews`        | Flat list of reviews for one or more product URLs                             |
| `get-seller`         | Storefront metadata for one or more third-party seller pages                  |
| `get-global-product` | Full product detail from any regional Amazon domain (de, co.uk, co.jp, etc.) |

### How to use

Use Apify's hosted MCP gateway - it generates ready-to-paste config snippets for Claude Desktop, Cursor, VS Code, ChatGPT, and any other MCP-compatible client:

**[mcp.apify.com/?tools=seemuapps/amazon-mcp](https://mcp.apify.com/?tools=seemuapps/amazon-mcp)**

Open the link, sign in, and copy the snippet for your client.

#### Where to get your Apify API token

Go to **[console.apify.com/settings/integrations](https://console.apify.com/settings/integrations)** and copy your **Personal API token**. (Sign in or create a free account if you haven't already.)

The token authorizes calls to the MCP server and is what Apify uses to bill you for tool calls.

### Pricing (pay-per-event)

| Tool                 | Event                   | Charged                                                |
|----------------------|-------------------------|--------------------------------------------------------|
| `get-product`        | `product-record`        | Once per product successfully returned                 |
| `search-products`    | `search-result-record`  | Once per search-result item successfully returned      |
| `get-reviews`        | `review-record`         | Once per review successfully returned                  |
| `get-seller`         | `seller-record`         | Once per seller record successfully returned           |
| `get-global-product` | `product-record`        | Once per product successfully returned                 |

Failed batches are not charged. Partial failures (e.g. one bad URL in a batch) are reported in the response without aborting the whole call.

### Notes

- Calls to the upstream data provider are **async snapshot-based** - for larger inputs each tool can take **30 seconds to ~2 minutes** to return. Configure your MCP client's timeout accordingly.
- All five tools accept a `maxItems` cap (1-1000, default 1000) so you can keep individual calls bounded.
- `get-product` and `get-global-product` save each product's main image to the run's Apify Key-Value Store and return a permanent signed `imageStorageUrl` - use that link to embed the image in your reply rather than the raw Amazon CDN URL.
- `search-products` defaults to `https://www.amazon.com` but accepts any Amazon domain URL; pair with `pagesToSearch` to pull more than the first results page per keyword.
- `get-seller` URLs follow the format `https://www.amazon.com/sp?seller=SELLER_ID`.

### Related Amazon actors

Part of a complete Amazon toolkit - explore the rest of the suite:

- [Amazon Product Scraper](https://apify.com/seemuapps/amazon-product-scraper) - Product details from any product URL
- [Amazon Product Search Scraper](https://apify.com/seemuapps/amazon-product-search-scraper) - Search results by keyword across pages
- [Amazon Global Product Scraper](https://apify.com/seemuapps/amazon-global-product-scraper) - Product data from any Amazon regional domain
- [Amazon Review Scraper](https://apify.com/seemuapps/amazon-review-scraper) - Customer reviews from any product page
- [Amazon Seller Scraper](https://apify.com/seemuapps/amazon-seller-scraper) - Seller info - rating, reviews, business details

# Actor input Schema

## `tool` (type: `string`):

Pick a tool to run and save results to the dataset, or leave empty to start the actor as an MCP Standby server.

## `urls` (type: `array`):

Amazon URLs - required by get-product (product pages), get-reviews (product pages), get-seller (seller pages), and get-global-product (regional product pages).

## `keywords` (type: `array`):

Search keywords - required by search-products.

## `domain` (type: `string`):

Amazon domain URL for search-products. Defaults to https://www.amazon.com.

## `pagesToSearch` (type: `integer`):

Search-results pages per keyword for search-products.

## `zipcode` (type: `string`):

US zip code for localized pricing on get-product (optional).

## `language` (type: `string`):

Language code (e.g. en\_US) for get-product (optional).

## `boughtPastMonth` (type: `integer`):

Filter products by minimum units purchased in the past month for get-global-product (optional).

## `maxItems` (type: `integer`):

Maximum records to return when running a tool directly (1-1000).

## Actor input object example

```json
{
  "tool": "",
  "urls": [
    "https://www.amazon.com/dp/B0CRMZHDG8"
  ],
  "keywords": [
    "wireless headphones"
  ],
  "domain": "https://www.amazon.com/",
  "pagesToSearch": 1,
  "maxItems": 50
}
```

# Actor output Schema

## `results` (type: `string`):

Records produced by the selected tool: products (get-product, get-global-product), search results (search-products), reviews (get-reviews), or sellers (get-seller). One record per row.

## `keyValueStore` (type: `string`):

Primary product images saved by get-product and get-global-product (returned as imageStorageUrl in each record).

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://www.amazon.com/dp/B0CRMZHDG8"
    ],
    "keywords": [
        "wireless headphones"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("seemuapps/amazon-mcp").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://www.amazon.com/dp/B0CRMZHDG8"],
    "keywords": ["wireless headphones"],
}

# Run the Actor and wait for it to finish
run = client.actor("seemuapps/amazon-mcp").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://www.amazon.com/dp/B0CRMZHDG8"
  ],
  "keywords": [
    "wireless headphones"
  ]
}' |
apify call seemuapps/amazon-mcp --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,seemuapps/amazon-mcp"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/9jYq4PSkhLvR3AS20/builds/pdAOkvNHMaCOW7WZn/openapi.json