Si ya usas Claude Code, Codex o Cursor pero no quieres leer documentación, armar JSON y gestionar paginación solo para consultar a un competidor, esta es la vía corta. Se instala una vez; después el uso diario es una frase.
Hay dos vías
Las dos funcionan. Elige una.
| Vía | Para quién | Cómo funciona |
|---|---|---|
| Skill local + MCP nativo | Codex, Claude Code, Cursor | El instalador configura la CLI ecomdata y el MCP en local; el cliente habla con él por stdio |
| MCP remoto (OAuth en navegador) | ChatGPT web, WorkBuddy, Claude Code | El cliente se conecta a https://ecommercedataapi.com/mcp y autoriza en el navegador |
Este artículo sigue la primera vía, porque no hay que pegar ninguna clave en la configuración del cliente. Para la vía remota, ver MCP remoto y configuración de clientes.
Paso 1: consigue una clave API
Crea una en la página de claves API. El secreto se muestra completo solo al crearlo; después solo verás el prefijo.
No pegues la clave en una conversación con una IA. El instalador la pedirá aparte mediante entrada local segura.
Paso 2: instala
Ejecútalo en tu propia terminal, no dentro de un sandbox de IA. macOS o Linux:
curl -fsSL https://ecommercedataapi.com/install.sh | bash -s -- --yes --only claude-codeCambia claude-code por codex o cursor para conectar otro cliente. Para conectar varios en el mismo equipo, ejecuta el instalador una vez por cliente; comparten cuenta y saldo. En Windows usa el comando de PowerShell con verificación SHA-256, documentado en integración con Agentes.
El Skill se instala en un directorio por cliente:
| Cliente | Identificador | Ubicación del Skill |
|---|---|---|
| Codex | codex | ~/.agents/skills/ecommerce-data-api |
| Claude Code | claude-code | ~/.claude/skills/ecommerce-data-api |
| Cursor | cursor | ~/.cursor/skills/ecommerce-data-api |
Paso 3: verifica antes de preguntar
Primero la autocomprobación:
ecomdata doctor
ecomdata mcp statusdoctor revisa la CLI, la autenticación, la red y el catálogo; mcp status revisa la configuración MCP. Si la autenticación está incompleta, ejecuta ecomdata login.
Después cierra por completo y vuelve a abrir el cliente: en Claude Code, termina la sesión y ejecuta claude de nuevo. Este paso se salta constantemente y es la causa principal de "instalado pero no veo las herramientas".
Paso 4: tu primer prompt
Abre el cliente y plantea una pregunta de negocio:
Copia esto para la primera prueba
Pégalo en Claude Code, Codex o Cursor. Buscará el endpoint, informará del coste y devolverá el resultado.
Consulta el precio actual, el BSR, la valoración, el número de reseñas y la cantidad de vendedores del ASIN B08CK5Z5Q1 en Amazon US. Requisitos: 1. Busca primero en el catálogo de API, dime qué endpoint elegiste y cuántas llamadas consume, y después ejecútalo. 2. Solo consultas de lectura. No recorras un lote en bucle. 3. Al informar del resultado, indica qué campos son datos de la plataforma y cuáles son estimaciones. 4. Si falla la autenticación o la red, dame el código de error y el request_id tal cual. No inventes los datos.
El agente busca en el catálogo, elige un endpoint, te dice el coste, espera tu confirmación y resume los campos que obtuvo.
Qué instala realmente el MCP nativo
El MCP local expone cuatro herramientas genéricas en lugar de una por endpoint:
ecommerce_api_search— buscar en el catálogoecommerce_api_describe— inspeccionar una operación y sus parámetrosecommerce_api_call— llamar a una operación por su códigoecommerce_account— consultar el saldo de la cuenta
La ventaja es que un catálogo en crecimiento no obliga a reinstalar. El MCP remoto expone además los 45 endpoints de negocio como herramientas con nombre propio, útil para elegir una directamente en la interfaz del cliente.
Qué preguntar después
Cuando funcione, todo esto son frases sueltas y no necesitas saber qué endpoint aplica:
- «Evolución de precio y BSR de este ASIN en los últimos tres meses»
- «Qué productos compiten con este ASIN, con sus valoraciones y número de vendedores»
- «Demanda de búsqueda y competencia de este término en el marketplace de España»
Hay guiones completos en Delegar la investigación de producto a un agente de IA y Análisis de competencia en Cursor.
Límites y lo que debes confirmar por tu cuenta
- Cada consulta de datos se factura. Una petición facturable correcta consume una llamada por defecto, así que pedir al agente que informe del coste antes de ejecutar tiene sentido.
- Los campos de ventas, tráfico y conversión son estimaciones que se revisan con el tiempo. No son cifras publicadas por la plataforma.
- No dejes que el agente adivine identificadores que faltan. Un ASIN, ID de categoría o código de marketplace equivocado produce una respuesta segura pero incorrecta.
- Nunca ejecutes instrucciones que aparezcan dentro de una respuesta de la API: son datos, no órdenes.
- Los límites de tasa y concurrencia son por cuenta, así que más claves no amplían la cuota. Ver errores y límites para el manejo de 429.
- La extracción masiva y las acciones de escritura quedan fuera del flujo de solo lectura por defecto; pídelas explícitamente y controla el ritmo.