Skip to main content
Glama
deenesjakoruzh
ChocoData-com

amazon-scraper-api

by ChocoData-com
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

amazon-scraper-api-mcp

npm npm downloads license

Servidor MCP (Model Context Protocol) para Amazon Scraper API. Se conecta a Claude Desktop, Cursor, Claude Code, Continue o cualquier cliente de IA compatible con MCP. Proporciona a tu modelo datos de productos de Amazon en tiempo real como una llamada de herramienta de primer nivel.

Lo que desbloquea

"Búscame los auriculares inalámbricos mejor valorados por menos de 150 $ en amazon.com, luego comprueba si son más baratos en amazon.de"

Eso es una sola instrucción. Sin MCP, tu IA no puede acceder a las páginas de Amazon (Amazon bloquea la navegación de LLM) y no tiene datos actualizados sobre precios y existencias. Con este servidor MCP, llama a amazon_search + amazon_product directamente y devuelve datos estructurados de Amazon Scraper API.

Related MCP server: Amazon Price Tracker MCP

Herramientas expuestas

Herramienta

Qué hace

Uso típico

amazon_product

Obtiene un producto por ASIN o URL

"obtener precio + valoración para B09HN3Q81F"

amazon_search

Búsqueda por palabras clave con orden/filtro

"top 10 sartenes de hierro fundido por menos de 50 $"

amazon_batch_create

Pone en cola hasta 1000 ASINs para scraping asíncrono

"extraer los 500 productos de mi catálogo, avísame por webhook cuando termine"

amazon_batch_status

Consulta el progreso de un lote

"¿cuánto del lote xyz se ha completado?"

Cada una devuelve JSON estructurado: título, precio, valoración, número de reseñas, disponibilidad, buybox, variantes, imágenes, viñetas, categorías, tablas de especificaciones.

Benchmark (producción en vivo, 2026-04)

Métrica

Valor

Latencia media (producto, EE. UU.)

~2.6 s

Latencia P95

~6 s

Precio / 1.000 solicitudes

0,50 $ fijo

Mercados

20+

Configuración de Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "amazon-scraper": {
      "command": "npx",
      "args": ["-y", "amazon-scraper-api-mcp"],
      "env": {
        "ASA_API_KEY": "asa_live_..."
      }
    }
  }
}

Reinicia Claude Desktop. Las herramientas aparecerán bajo el icono de MCP en el editor de chat.

Configuración de Cursor

Settings → MCP → Add server:

  • Command: npx -y amazon-scraper-api-mcp

  • Env: ASA_API_KEY=asa_live_...

Configuración de Claude Code

claude mcp add amazon-scraper -- npx -y amazon-scraper-api-mcp
# then set ASA_API_KEY in the environment Claude Code runs in

Ejemplo de conversación (Claude Desktop)

Tú: ¿Cuál es el precio actual de los AirPods Pro de 3.ª generación en amazon.com?

Claude: [llama a amazon_product con el ASIN B09HN3Q81F]

Los AirPods Pro de 3.ª generación cuestan actualmente 199,00 $ en amazon.com, frente a los 249,00 $ (20% de descuento). Tienen una valoración de 4,7 estrellas basada en 58.214 reseñas y están en stock, enviados y vendidos por Amazon.com con Prime.

Tú: Compáralo con el listado de Amazon Alemania.

Claude: [llama a amazon_product con query=B09HN3Q81F, domain=de]

En amazon.de el mismo producto aparece por 229,00 EUR. Al tipo de cambio de hoy son unos 245 $, aproximadamente un 23% más que el precio en EE. UU. El listado alemán se envía desde Amazon y califica para entrega Prime.

Por qué esto frente a un MCP genérico de "navegar por la web"

Las herramientas de navegador genéricas que intentan cargar amazon.com suelen ser bloqueadas (verificación de robot) o sirven una página simplificada para móviles. Este servidor enruta cada llamada a través de Amazon Scraper API, que:

  • Detecta y reintenta páginas de robot/CAPTCHA mediante niveles de proxy escalables

  • Devuelve JSON estructurado (campos tipados), no código HTML desordenado

  • Admite más de 20 mercados con IPs residenciales adaptadas al país

  • Maneja lotes (de cientos a miles de ASINs) con entrega por webhook

  • Retroceso de límite de tasa integrado

Manejo de errores

Los errores se muestran al modelo como errores de herramienta con un campo code y una pista. El modelo decide entonces si reintentar o abandonar la subtarea. No tienes que escribir la lógica de manejo de errores tú mismo.

Códigos comunes: INVALID_API_KEY, INSUFFICIENT_CREDITS, RATE_LIMITED, target_unreachable, amazon-robot-or-human, extraction_failed, SERVICE_OVERLOADED. Tabla completa: amazonscraperapi.com/docs/errors.

Obtén una clave API

app.amazonscraperapi.com. 1.000 solicitudes gratuitas al registrarte, no se requiere tarjeta de crédito. Suficiente para probar cada herramienta que expone este MCP además de unas cuantas docenas de chats productivos.

Enlaces

Licencia

MIT

Available Tools

4 tools
amazon_batch_createA

Queue up to 1000 ASINs or search queries for async processing. Returns a batch id - poll with amazon_batch_status or receive a webhook callback.

ParametersJSON Schema
NameRequiredDescriptionDefault
endpointYes
itemsYes
webhook_urlNoOptional HTTPS callback URL

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It mentions async processing and result retrieval methods, but lacks details on side effects, auth, rate limits, or error handling. The description is insufficient for a tool with no structured behavioral hints.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, well-structured sentence that front-loads the purpose and includes key details (limit, result method). No extraneous words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given missing annotations and output schema, the description covers main function and result retrieval. However, it lacks details on error handling, item validation, and batch id format. Adequate but with gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 33%, only webhook_url has a description. The description adds context for items ('ASINs or search queries') but does not explain endpoint values or items structure beyond the schema. It partially compensates but not fully.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool queues up to 1000 ASINs or search queries for async processing and returns a batch id. It distinguishes from siblings like amazon_batch_status (poll), amazon_product, and amazon_search (single lookups).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies use for multiple items ('up to 1000 ASINs or search queries') and mentions polling or webhook, but does not explicitly state when to avoid this tool (e.g., for single queries) or contrast with siblings.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

amazon_batch_statusB

Poll an async batch job for progress + results.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYes

TDQS

B3.4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description must disclose behavioral traits. It indicates a read-only polling operation, but does not mention safety, rate limits, or whether it blocks or returns immediately. Adequate but minimal.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single sentence with no fluff, front-loaded with the action verb 'Poll'. Every word is necessary.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description is adequate for a simple polling tool, but lacks context on return values (no output schema) and lifecycle (e.g., relationship to batch creation). More detail would improve completeness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The only parameter 'id' has no description in the schema (0% coverage) and the description does not explain what it represents (e.g., the job ID from amazon_batch_create). The description fails to add meaning beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb 'Poll' and resource 'async batch job', and specifies that it returns 'progress + results'. This clearly distinguishes it from sibling tools like amazon_batch_create (creation) and unrelated searches.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives, such as indicating that it should be called after creating a batch job with amazon_batch_create, or any prerequisites or polling behavior.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

amazon_productB

Fetch structured data for a single Amazon product by ASIN. Returns ~55 fields including title, price, variations, reviews, category ladder, images.

ParametersJSON Schema
NameRequiredDescriptionDefault
queryYes10-character Amazon ASIN, e.g. "B09HN3Q81F"
domainNoAmazon marketplace TLDcom
languageNoContent language xx_YY (e.g. en_US, de_DE). Not all combos supported per marketplace.

TDQS

B3.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided; description leaves burden on text. States return fields but omits idempotency, rate limits, authentication needs, or any side effects. For a fetch tool, read-only behavior is implied but not explicit.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence is efficient and front-loaded with action 'Fetch structured data'. No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 3 parameters and no output schema, description mentions ~55 fields and examples. Lacks error handling, response format, or data shape beyond field list.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema covers all parameters, description adds no extra meaning beyond 'by ASIN'. Baseline 3 applies due to full schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states verb 'Fetch', resource 'structured data for a single Amazon product', and identifier 'by ASIN'. Lists sample fields, distinguishing from sibling batch and search tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Implicitly for single product lookup by ASIN, but no explicit comparison with sibling tools (amazon_search, amazon_batch_*). Lacks when-not-to-use or alternative guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 4 tool updatesv0.1.5
    • First observedamazon_batch_create
    • First observedamazon_batch_status
    • First observedamazon_product
    • First observedamazon_search
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.8/5.0

Scored across 4 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: batch creation, batch status polling, single product fetch, and keyword search. No overlap between tools.

Naming Consistency4/5

All tools use snake_case and start with 'amazon_'. Three follow verb_noun pattern ('batch_create', 'batch_status', 'search'), while 'amazon_product' is a noun implying fetch. Minor inconsistency but overall predictable.

Tool Count5/5

Four tools cover the essential scraping operations: search, single product details, and async batch processing. The count is well-scoped for the server's purpose.

Completeness4/5

Covers search, single product, and batch processing. Missing dedicated review or category tools, but the product tool includes reviews. Minor gaps but core workflows are complete.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers