Amazon MCP Server

Amazon MCP Server

Um servidor de Model Context Protocol (MCP) hospedado que dá ao Claude, Cursor, Windsurf e qualquer outro cliente MCP quatro ferramentas somente leitura da Amazon. Execute uma pesquisa por palavra-chave, leia um produto pelo ASIN, consulte um vendedor e navegue pelo estoque desse vendedor, tudo em JSON estruturado, sem conta de desenvolvedor Amazon e sem nada para hospedar.

Ele lê páginas públicas da Amazon que um visitante não autenticado pode ver, em qualquer um dos 23 domínios regionais.

1.000 créditos grátis todo mês, sem cartão de crédito, o que equivale a 200 chamadas à Amazon na taxa de 5 créditos.

https://mcp.hasdata.com/api/mcp?apis=amazon

Conteúdo

• O que você precisa
• Início rápido
• Exemplos de prompts
• Ferramentas
• Erros e caminhos de falha
• Preços, plano gratuito e limites
• Seleção de ferramentas
• Como se compara
• FAQ
• Links HasData
• Desenvolvimento
• Contribuição
• Licença

O que você precisa

Um cliente MCP e uma chave de API HasData do painel, gratuita para criar sem cartão, e o plano gratuito cobre cerca de 200 chamadas por mês na taxa de 5 créditos. Este é um servidor remoto, então o caminho mais simples é uma URL e um cabeçalho x-api-key, sem contêiner para executar. Um cliente que só fala stdio o acessa por meio de um lançador leve, publicado como @hasdata/amazon-mcp no npm e hasdata-amazon-mcp no PyPI, mostrado abaixo.

Início rápido

A URL do servidor é a mesma para todos os clientes. Nós a executamos na prática no Claude Code e no Claude Desktop. Os outros blocos seguem o formato documentado de cada cliente para um servidor remoto.

Clientes com suporte a OAuth podem adicionar a mesma URL como conector e entrar sem colocar uma chave em um arquivo de configuração.

claude mcp add --transport http amazon "https://mcp.hasdata.com/api/mcp?apis=amazon" \
  --header "x-api-key: HASDATA_API_KEY"

{
  "mcpServers": {
    "amazon": {
      "command": "npx",
      "args": ["-y", "@hasdata/amazon-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "amazon": {
      "command": "uvx",
      "args": ["hasdata-amazon-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "amazon": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=amazon",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "amazon": {
      "serverUrl": "https://mcp.hasdata.com/api/mcp?apis=amazon",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "servers": {
    "amazon": {
      "type": "http",
      "url": "https://mcp.hasdata.com/api/mcp?apis=amazon",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

Exemplos de prompts

Cada um destes cai em uma ferramenta, ou em duas em sequência quando a segunda precisa de um identificador que a primeira retorna.

• Encontre suportes para notebook abaixo de US$ 40 na Amazon e ordene-os pela média das avaliações dos clientes.
• Quanto custa o ASIN B0DHJ7SBDR agora, e quantos outros vendedores o oferecem?
• Compare o preço deste ASIN em amazon.com e amazon.de.
• Quem é o vendedor por trás do ASIN B0DHJ7SBDR, e qual é a avaliação vitalícia dele?
• Navegue por tudo que o vendedor ATQQBVXK188KS estoca e destaque os itens com desconto.
• Pesquise fones de ouvido sem fio com entrega para 10001 e diga quais chegam mais rápido.

Um prompt que nomeia um produto em vez de um ASIN faz duas chamadas: uma pesquisa para resolver o ASIN e uma consulta de produto para lê-lo. Um prompt que nomeia um vendedor pela marca em vez do ID do vendedor tem o mesmo formato: uma consulta de produto para encontrar o ID do vendedor e uma consulta de vendedor para ler o perfil.

Ferramentas

Quatro ferramentas, 5 créditos por chamada bem-sucedida. Toda ferramenta aceita domain para trocar de marketplace, um de 23 valores, www.amazon.com pelos marketplaces europeus, asiáticos e outros regionais, e language quando o marketplace oferece mais de um.

Obter resultados de pesquisa da Amazon

hasdata_amazon_search_getSearchResults

Uma página de resultados de pesquisa para uma palavra-chave.

Retorna productResults, um array ads de posicionamentos patrocinados, e pagination com totalResults, currentPage, nextPageUrl e otherPageUrls. Cada resultado traz position, asin, title, url, isSponsored, um objeto price, image, reviews com rating e totalReviews, um objeto badges, boughtInPastMonth e deliveryInfo.

Um resultado de pesquisa é deliberadamente enxuto. Marca, recursos, variações, imagens e o vendedor não estão aqui; eles vêm da ferramenta de produto abaixo. Resolva o ASIN primeiro e depois leia o produto.

{
  "position": 1,
  "asin": "B077B9W343",
  "title": "Nulaxy Ergonomic Adjustable Laptop Stand for Desk, Dual Foldable Computer Riser...",
  "isSponsored": false,
  "price": { "symbol": "$", "currentPrice": 15.99, "beforePrice": 17.99 },
  "image": "https://m.media-amazon.com/images/I/61jtA8kHq9L.jpg",
  "reviews": { "totalReviews": 16800, "rating": 4.7 },
  "badges": { "amazonChoice": true, "amazonPrime": false, "bestSeller": false },
  "boughtInPastMonth": "10K+",
  "deliveryInfo": { "freeDelivery": "Join Prime", "fastestDelivery": "Mon, Sep 14" },
  "url": "https://www.amazon.com/dp/B077B9W343"
}

Obter detalhes do produto da Amazon

hasdata_amazon_product_getProductDetails

Um produto completo, pelo ASIN.

Retorna um objeto product com asin, url, title, brand, isAvailable, condition, um objeto price, primaryFeatures e um mapa features mais amplo, featureBullets, description, variants, breadcrumbs, whatIsInTheBox, coleções de imagens e vídeos, specification, reviewsInfo, as estimativas de entrega e o seller atual com sellerUrl.

O objeto price contém currentPrice, beforePrice quando o item está com desconto, discount, priceFrom e otherOfferQuantity. Esse último campo é uma contagem de ofertas concorrentes, que a chamada base informa sem buscá-las. Peça otherSellers apenas quando as ofertas em si forem necessárias, porque isso dobra o preço da chamada.

{
  "asin": "B0DHJ7SBDR",
  "title": "Apple iPhone 16 Pro Max, 1TB, Desert Titanium",
  "brand": "Apple",
  "condition": "Refurbished - Excellent",
  "price": {
    "symbol": "$",
    "currentPrice": 974,
    "beforePrice": 949.99,
    "discount": "-11%",
    "otherOfferQuantity": 11
  },
  "seller": "WirelessSource",
  "deliveryIsoDate": "2026-09-11T00:00:00.000Z"
}

Obter detalhes do vendedor da Amazon

hasdata_amazon_seller_getSellerDetails

O perfil público da loja de um vendedor.

Retorna um objeto seller com sellerId, url, storefrontUrl, name, businessName, businessAddress, um bloco about e quatro janelas de avaliação chamadas oneMonthRatings, threeMonthRatings, twelveMonthRating e lifetimeRating. Cada janela traz totalVotes, averageRating e uma distribuição por estrelas com tanto votes quanto percent.

As quatro janelas são o que torna esta ferramenta digna de uma chamada. Uma média vitalícia de 4,5 em 2.701 votos e uma média mensal de 2 em 4 votos descrevem vendedores muito diferentes, e só o par mostra um declínio em andamento.

{
  "sellerId": "ATQQBVXK188KS",
  "name": "Expercom - Apple Premier Partner",
  "businessName": "Expercom of Utah, Inc",
  "lifetimeRating": { "totalVotes": 2701, "averageRating": 4.5 },
  "oneMonthRatings": { "totalVotes": 4, "averageRating": 2 }
}

Obter produtos do vendedor da Amazon

hasdata_amazon_seller_products_getSellerProducts

Uma página do que um vendedor estoca.

Retorna productResults e pagination, com o mesmo formato da saída da ferramenta de pesquisa. Cada item traz position, asin, title, url, price, image, reviews, badges, boughtInPastMonth, deliveryInfo e colorUrls. Percorra pagination para chegar ao restante do catálogo em vez de adivinhar números de página.

Erros e caminhos de falha

Planeje estes cenários em vez de assumir um caminho feliz.

Uma pesquisa sem correspondências retorna um resultado bem-sucedido com um array productResults vazio, não um erro. requestMetadata.status ainda é ok. Teste o comprimento do array antes de iterar.

Um ASIN que não existe no marketplace escolhido responde com um erro, não com um produto vazio. O mesmo ASIN frequentemente existe em um domínio e não em outro, então uma falha em www.amazon.de não significa que o ASIN está errado.

Um ID de vendedor também é limitado ao marketplace. O ID que um produto em www.amazon.com retorna não será resolvido em outro domínio.

Um preço pode estar ausente em um anúncio ativo. Itens fora de estoque, vendidos apenas por outros vendedores ou bloqueados por uma promoção voltam sem um currentPrice utilizável. Leia isAvailable antes de comparar preços.

deliveryZip e shippingLocation mudam a resposta, não apenas a linha de entrega. Disponibilidade, preço e a combinação de vendedores mudam com o destino, então uma comparação entre códigos postais precisa manter todos os outros parâmetros fixos.

Resultados que trazem dados também trazem um requestMetadata.id que vale citar no suporte.

Preços, plano gratuito e limites

Cada ferramenta da Amazon custa 5 créditos por chamada bem-sucedida. Ativar otherSellers adiciona 5 créditos à chamada de produto, 10 em vez de 5, então deixe desativado a menos que as ofertas concorrentes sejam o objetivo. O tamanho da resposta não muda o preço.

O plano gratuito é 1.000 créditos todo mês sem cartão, o que equivale a 200 chamadas à Amazon na taxa base. Ele se renova com o ciclo de faturamento, então um agente de baixo volume funciona no plano gratuito indefinidamente.

Os planos pagos começam em US$ 49 por mês para 200.000 créditos, o que equivale a 40.000 chamadas. O preço unitário cai com o volume, de US$ 1,23 por 1.000 chamadas no plano inicial para US$ 0,50 no Business, US$ 0,42 no Growth e US$ 0,37 nos maiores planos de alto volume.

Seu plano também define a concorrência. O plano gratuito permite 1 solicitação por vez, o Startup 15, o Business 30, o Growth 50, e os planos de alto volume vão de 200 a 1.500. Repita a tentativa no 429 com backoff em qualquer coisa não supervisionada, porque um agente que se espalha por vários ASINs atingirá o teto antes de você. Uma solicitação que retorna com status diferente de 200 não é cobrada. Uma chamada bem-sucedida que não encontra nada ainda é uma chamada.

Seleção de ferramentas

Duas regras cobrem a maior parte dos casos.

Comece pelo que o prompt lhe fornece. Uma palavra-chave vai para a ferramenta de busca, um ASIN vai direto para a ferramenta de produto, e um ID de vendedor vai para uma das duas ferramentas de vendedor. Gastar uma chamada de busca para chegar a um ASIN que você já possui é o desperdício mais comum.

Depois, escolha pela profundidade. As ferramentas de busca e de produtos do vendedor retornam o mesmo formato de item resumido, bom para ranqueamento, filtragem e varreduras de preço em muitos produtos. A ferramenta de produto é a única que retorna marca, recursos, variações, imagens e o vendedor, e é a única que vale a pena chamar quando a pergunta é sobre um único item.

Como se compara

A própria Product Advertising API da Amazon é a rota oficial para esses dados, e é um instrumento diferente.

A linha que decide é a elegibilidade. A Product Advertising API é feita para afiliados e seu acesso depende de vendas que você já realizou, o que a descarta para pesquisa, monitoramento e qualquer coisa que um agente faça em seu nome. Quando você se qualifica e precisa apenas de itens anunciáveis, a API oficial é a melhor opção.

FAQ

Existe um servidor MCP oficial da Amazon?

A Amazon não publica um. Este é mantido pela HasData e lê páginas públicas da Amazon.

O que é um servidor MCP da Amazon?

Um servidor MCP expõe ferramentas que um cliente de IA pode chamar. Este transforma resultados de busca da Amazon, páginas de produto e vitrines de vendedores em JSON sobre o qual um agente pode raciocinar, sem um navegador ou uma biblioteca de scraping em sua stack.

Preciso de uma conta Amazon ou chave de API?

Não. A única credencial é a sua chave HasData.

Quais marketplaces são cobertos?

Todos os 23 domínios que a API aceita, de www.amazon.com até os marketplaces europeus e asiáticos. Passe domain para alternar. Preços, disponibilidade e a mistura de vendedores diferem por marketplace, então uma comparação entre domínios é uma comparação real, em vez de uma conversão de moeda.

Por que um resultado de busca não tem marca ou recursos?

A Amazon não os coloca na página de resultados. A ferramenta de busca retorna o que a página mostra, e a ferramenta de produto retorna a página do item. Essa divisão é a razão pela qual as duas ferramentas custam o mesmo e retornam profundidades diferentes.

O que significa otherOfferQuantity?

O número de outros vendedores que oferecem o mesmo item, conforme relatado pela página do produto. Ele chega com a chamada base. As ofertas em si precisam de otherSellers, que custa 5 créditos a mais.

Posso usar isso junto com outras APIs da HasData?

Sim. Uma chave cobre tudo, e um endpoint atende a todos através do parâmetro apis. Aponte um cliente para ?apis=amazon,google_serp para obter ambos os conjuntos de ferramentas em uma conexão, ou para mcp.hasdata.com/api/mcp para o catálogo completo.

A HasData é afiliada à Amazon?

Não. A HasData é um serviço independente e não é afiliada, endossada ou patrocinada pela Amazon. Amazon é uma marca registrada de seu respectivo proprietário. As ferramentas trabalham apenas com dados publicamente disponíveis, e você é responsável por usar os resultados em conformidade com os termos da Amazon e a lei que se aplica a você.

Conformidade e dados pessoais

Os perfis de vendedores carregam um nome comercial e um endereço comercial, que são publicados pela Amazon na página da vitrine. Trate-os como registros comerciais, em vez de dados livres, e verifique suas próprias obrigações antes de armazená-los.

Links da HasData

• Amazon Scraper API, os endpoints REST por trás dessas ferramentas
• Documentação da API
• Documentação do servidor MCP
• Preços
• Painel

Outros servidores MCP da HasData: Google Search, Google Maps, Google Trends, Google Flights, DuckDuckGo, YouTube, TikTok, Instagram, Zillow, Airbnb, Booking.com, Indeed.

Desenvolvimento

O lançador é uma ponte stdio fina para o servidor remoto, então não há nada para compilar.

npm install
HASDATA_API_KEY=your_key_here npm test

Os testes em test/ verificam o contrato da ferramenta, a parte que pode quebrar sem um commit aqui. Eles verificam que ?apis=amazon retorna a contagem esperada de ferramentas, que nenhum nome mudou, que toda ferramenta ainda declara seu parâmetro obrigatório e carrega uma descrição, e que a chave em uso é realmente aceita. Essa última verificação chama uma ferramenta de verdade e custa 5 créditos, que é o preço de um canário que pode falhar pelo motivo certo.

Mais um teste cobre uma ferramenta que este README não documenta. O servidor também lista uma ferramenta de avaliações cujo endpoint upstream está aposentado e responde com um erro, então documentá-la enviaria os leitores a um beco sem saída. O teste fixa esse estado em vez de ignorá-lo, e falha no dia em que o endpoint retorna ou no dia em que o servidor remove a ferramenta, que é quando este README precisa de uma decisão.

A suíte de contrato também roda semanalmente em um cronograma, porque a lista de ferramentas upstream pode mudar sem que ninguém toque neste repositório.

Contribuindo

Uma tabela de ferramentas, uma amostra de resposta ou um comportamento documentado que não corresponda à realidade vale uma issue. Há um modelo exatamente para isso. Pull requests são bem-vindos para o mesmo, e para qualquer coisa no lançador.

Licença

MIT, veja LICENSE.