Integración con agentes

La configuración solo se hace una vez. Después no necesitas buscar rutas de la API, escribir JSON ni ejecutar comandos. Describe la tarea en Codex, Claude Code o Cursor, y el agente llama a Ecommerce Data API y te devuelve una respuesta clara en texto.

Ayúdame a configurar en este ordenador la integración de Ecommerce Data API con agentes. Completa los pasos que puedas ejecutar con seguridad en lugar de darme solo instrucciones generales.

Objetivo: instalar la CLI de Ecommerce Data API, la Skill y la configuración de MCP local para el cliente Codex, Claude Code o Cursor que esté disponible.
Documentación: https://ecommercedataapi.com/es/docs/launcher

Requisitos:
1. Detecta el sistema operativo, la versión de Node.js y los clientes Codex, Claude Code y Cursor instalados. Windows necesita Node.js 18 o posterior.
2. Comprueba si tu terminal se ejecuta realmente en mi entorno de usuario local. Si estás en un sandbox aislado, sin acceso a mi red local ni a mi directorio de usuario, no intentes instalar nada. Dime exactamente qué comando debo pegar en mi propio Windows Terminal, PowerShell o terminal de macOS/Linux.
3. Cuando puedas operar el terminal local con seguridad, sigue el flujo de instalación documentado, con validación de Manifest y SHA-256. Instala solo los clientes detectados o elegidos explícitamente, y cada cliente por separado si hay más de uno.
4. No uses atajos sin verificar del tipo irm | iex o curl | bash. No modifiques el código de mi proyecto, la configuración del sistema ni la configuración de otros agentes.
5. No pidas, muestres, guardes ni añadas una API key en este chat. Si no tengo una clave, envíame a https://ecommercedataapi.com/es/settings/apikeys/create. Cuando el instalador la pida, deja que la introduzca yo en el aviso local seguro.
6. Tras la instalación, ejecuta ecomdata doctor y ecomdata mcp status para comprobar la CLI, la autenticación, la red, el Catalog y la configuración de MCP. Si la autenticación está incompleta, explícame cómo ejecutar ecomdata login.
7. Termina con una lista breve: sistema operativo, agentes conectados, directorios de la Skill, estado de la configuración de MCP, resultados de la verificación y los pasos manuales que aún me queden.

Empieza en tres pasos

1. Prepara una API key

Si no tienes una, créala en la página de API keys.

2. Elige un agente e instala

Elige el agente que quieres conectar primero. El instalador añade por defecto la Skill y la configuración de MCP nativo, e instala la CLI ecomdata. El identificador de cliente y la ubicación de la Skill son:

Usa el comando de tu sistema operativo. Ejecútalo en tu propio terminal local, no dentro del sandbox de un chat de IA.

macOS o Linux

Abre el Terminal. Este ejemplo instala la Skill y el MCP local para Codex:

curl -fsSL https://ecommercedataapi.com/install.sh | bash -s -- --yes --only codex

Sustituye codex por claude-code para Claude Code o por cursor para Cursor. El instalador pide la API key mediante una entrada local segura. Usa --skip-mcp solo si quieres deliberadamente la Skill y la CLI sin MCP.

Windows PowerShell

Abre Windows Terminal o PowerShell en tu propio ordenador. Si el equipo solo tiene un agente compatible, pega este comando de instalación rápida de una línea. El instalador detecta Codex, Claude Code o Cursor y pide la API key mediante una entrada local segura:

$base='https://ecommercedataapi.com';$manifest=Invoke-RestMethod "$base/launcher/manifest.json";$installer=Join-Path $env:TEMP 'ecomdata-install.ps1';Invoke-WebRequest "$base/install.ps1" -OutFile $installer;if((Get-FileHash $installer -Algorithm SHA256).Hash.ToLowerInvariant() -ne $manifest.installers.windows_powershell.sha256){throw 'Installer checksum mismatch.'};& $installer -Yes

Para elegir un agente concreto, o si el equipo tiene más de uno, usa el comando siguiente. Este ejemplo instala Codex:

$base = 'https://ecommercedataapi.com'
$manifest = Invoke-RestMethod "$base/launcher/manifest.json"
$installer = Join-Path $env:TEMP 'ecomdata-install.ps1'
Invoke-WebRequest "$base/install.ps1" -OutFile $installer
if ((Get-FileHash $installer -Algorithm SHA256).Hash.ToLowerInvariant() -ne $manifest.installers.windows_powershell.sha256) { throw 'Installer checksum mismatch.' }
& powershell.exe -NoProfile -ExecutionPolicy Bypass -File $installer -Yes -Only codex

Sustituye codex por claude-code o cursor según corresponda. Añade -SkipMcp solo si quieres deliberadamente la Skill y la CLI sin MCP. Windows no necesita WSL. Antes hay que tener instalado Node.js 18 o posterior.

La API key se pide mediante una entrada local segura. No aparece en el comando de instalación, en el historial del shell ni en un archivo .env del proyecto.

3. Usa la Skill y el MCP nativo en tu agente

Tras la instalación, cierra y vuelve a abrir el agente elegido, e inicia una conversación nueva:

Para conectar más de un agente en el mismo ordenador, ejecuta el instalador una vez por cada destino, por ejemplo --only codex y después --only claude-code. Los clientes usan la misma cuenta de API key y los mismos Credits, pero cada uno tiene su propia Skill y su propia configuración de cliente MCP.

Elige la integración adecuada

Ecommerce Data API tiene tres superficies de integración independientes:

El MCP nativo del instalador funciona por stdio local y usa la credencial ya configurada para ecomdata; no pongas una API key en una URL de MCP ni en la configuración del cliente. Los clientes compatibles con MCP remoto pueden prescindir del instalador y añadir el endpoint remoto público /mcp en https://ecommercedataapi.com/mcp, que inicia sesión con OAuth en el navegador. Consulta Añadir MCP remoto.

El MCP nativo instalado expone estas cuatro herramientas:

• ecommerce_api_search
• ecommerce_api_describe
• ecommerce_api_call
• ecommerce_account

4. Pregunta directamente al agente

Abre Codex, Claude Code o Cursor y escribe una pregunta de negocio:

Tú:

Busca en Amazon US los datos del producto con ASIN B08CK5Z5Q1. Devuelve la
marca, el precio, la valoración y el número de reseñas, y dime si merece la pena
investigarlo más.

Agente:

Consulta completada:
- Producto: ...
- Marca: ...
- Precio actual: ...
- Valoración y número de reseñas: ...

Valoración breve: ...

Los campos y valores reales proceden de la respuesta actual de la API. También puedes pedir un análisis más completo:

Busca las palabras clave de tráfico del ASIN B08CK5Z5Q1 en Amazon US. Lista las
20 primeras por volumen de búsqueda, incluye la proporción de tráfico orgánico y
resume las palabras clave que merecen atención.

El agente hace automáticamente lo siguiente:

1. Encuentra la API más adecuada para la tarea.
2. Comprueba los datos obligatorios, como el marketplace, el ASIN y la palabra clave.
3. Llama a la API.
4. Organiza los datos devueltos en una respuesta legible.

Cuando falta un dato obligatorio, el agente hace una pregunta breve, por ejemplo: «¿Qué marketplace de Amazon debo usar?».

Qué incluir en una petición

En la mayoría de los casos, indica:

• Objetivo: qué quieres encontrar, comparar o analizar.
• Sujeto: un ASIN, una palabra clave, una categoría o una marca registrada.
• Marketplace: por ejemplo, Amazon US, UK o JP.
• Salida: por ejemplo, las 20 primeras, ordenadas por volumen de búsqueda, una tabla o una conclusión breve.

No necesitas conocer el nombre de una API, la ruta de un endpoint ni un campo JSON.

Credits y confirmación

Normalmente el agente ejecuta directamente una sola petición de lectura. Antes de una operación por lotes o de una tarea que pueda consumir más Credits, explica las llamadas y el coste estimados y espera tu confirmación.

Supervisar una lista fija de ASIN

Para una lista de competidores que quieres revisar cada día, usa ecomdata watch en lugar de pedirle al agente que repita las mismas consultas. Cada ejecución hace las mismas llamadas, guarda cada observación en tu ordenador e informa de lo que ha cambiado desde la anterior.

ecomdata watch add B08CK5Z5Q1 --marketplace US
ecomdata watch list
ecomdata watch run --max-credits 50
ecomdata watch diff
ecomdata watch remove B08CK5Z5Q1 --marketplace US

• Fija un presupuesto en cada ejecución. watch run exige --max-credits. Si la lista necesita más llamadas que el presupuesto, la ejecución se detiene antes de la primera llamada.
• Comprueba el producto al añadirlo. watch add muestra el título, la marca, el precio y el ranking que ha encontrado. Elimina el ASIN si no es el producto que querías.
• Interpreta bien no_new_observation. Significa que el servicio ha devuelto el mismo registro que la vez anterior. No demuestra que no haya cambiado nada.
• Un valor ausente no es cero. Un precio o un ranking que aparece como null no se observó en esa ejecución.

El informe compara con las observaciones guardadas en tu ordenador, así que la referencia solo abarca el tiempo que la lista lleva en marcha. No se sube nada y no se envía ninguna notificación. Para ejecutarlo sin supervisión, programa el comando con tu sistema operativo, por ejemplo con cron o el Programador de tareas.

Solución de problemas

Estos comandos solo hacen falta para problemas de instalación, autenticación o conexión:

ecomdata login
ecomdata doctor
ecomdata update
ecomdata mcp serve
ecomdata mcp status
ecomdata mcp install --client codex
ecomdata mcp uninstall --client codex

• login: vuelve a configurar la API key.
• doctor: comprueba la cuenta, el saldo, la red y el Catalog.
• update: actualiza la CLI o la Skill.
• mcp serve: inicia el servidor stdio local. El cliente configurado lo inicia automáticamente; ejecútalo a mano solo para diagnosticar el arranque de MCP.
• mcp status: muestra si la configuración de MCP local existe para los clientes compatibles, sin mostrar la API key.
• mcp install --client <client>: añade la configuración de MCP local tras una instalación hecha con --skip-mcp.
• mcp uninstall --client <client>: elimina solo la configuración de MCP local de ese cliente; no elimina la Skill ni la CLI.

Si la conversación actual no detecta Ecommerce Data API justo después de la instalación, ejecuta ecomdata mcp status e inicia una conversación nueva con el agente. Reinicia el cliente solo si la conversación nueva sigue sin detectar la Skill o las herramientas MCP. Vuelve a ejecutar ecomdata mcp install cuando el estado indique que un cliente elegido no está configurado. Sustituye codex por claude-code o cursor para esos clientes.

Los cambios del Catalog y de las APIs habituales están disponibles de inmediato, sin reinstalar. Ejecuta ecomdata update solo cuando cambie el comportamiento de la CLI o de la Skill.