DataDoe

Servidor MCP alojado para vendedores y proveedores de Amazon. Conecta Claude, ChatGPT, Cursor, Codex, Gemini, GitHub Copilot con datos en vivo de las API SP-API y Ads API de Amazon.

Documentación

Servidor MCP de Amazon Seller - DataDoe

Servidor MCP alojado para Amazon Seller Central y Vendor Central con acceso de lectura y escritura. Conecta Claude, ChatGPT, Cursor, Codex, Gemini y GitHub Copilot a datos en vivo de Amazon SP-API y Amazon Ads API, y deja que tu agente de IA actúe sobre ellos: actualiza listados, gestiona pedidos y optimiza campañas de Amazon Ads. DataDoe se encarga de la aprobación de desarrollador SP-API, OAuth y los límites de tasa para que tu agente de IA empiece a trabajar en menos de un minuto.

Amazon Seller & Vendor SP-API Selling Partner API Amazon Ads API MCP Server Read and Write AI clients supported smithery badge License: MIT

🔗 Comienza una prueba gratuita · 📘 Documentación · ⚡ Acciones · 📊 Esquema de datos de Amazon · 🎥 Demo en video


🚀 Inicio rápido

  1. Regístrate en DataDoe y conecta tu cuenta de Amazon Seller Central o Vendor Central.

  2. Crea una clave API MCP de DataDoe en Integraciones MCP de DataDoe.

  3. Pega la configuración a continuación en tu cliente de IA (Claude, Cursor, Codex, Gemini, GitHub Copilot, ChatGPT o cualquier herramienta compatible con MCP):

    {
      "mcpServers": {
        "datadoe": {
          "url": "https://mcp.datadoe.com/mcp/v1",
          "headers": {
            "datadoe-mcp-key": "<YOUR_DATADOE_MCP_KEY>"
          }
        }
      }
    }
    
  4. Pregunta a tu agente de IA: "Muéstrame mis 10 ASIN principales por ingresos del último mes en todos los marketplaces de Amazon."

Eso es todo. DataDoe ejecuta el servidor MCP en infraestructura alojada, por lo que tu equipo no necesita implementar nada localmente ni esperar la aprobación de desarrollador de Amazon SP-API.


¿Qué es DataDoe MCP?

DataDoe MCP es un servidor alojado de Model Context Protocol (MCP) para vendedores, proveedores y agencias de Amazon. Expone tus datos en vivo de la API de Selling Partner de Amazon (SP-API) y de Amazon Ads API a través de herramientas MCP que funcionan con Claude, ChatGPT, Cursor, Codex CLI, Gemini CLI, GitHub Copilot, Claude Desktop, n8n, NanoClaw y cualquier otro cliente compatible con MCP.

DataDoe MCP brinda a tu agente de IA dos capas sobre tu cuenta de Amazon:

  • Una capa de lectura: pedidos a nivel de SKU, ventas, gasto en anuncios, tráfico, inventario, listados, devoluciones, liquidaciones, análisis de marca y catálogo, devueltos como respuestas de herramientas estructuradas o exportaciones descargables en CSV y JSON.
  • Una capa de escritura (Acciones): tu agente puede cambiar tu cuenta de Amazon a través de SP-API y Amazon Ads API: actualizar listados, cancelar pedidos, confirmar envíos y gestionar campañas de Amazon Ads, grupos de anuncios, targets y anuncios.

Crear tu propia integración con Amazon SP-API normalmente requiere registro de desarrollador SP-API, flujo de token de actualización OAuth, endpoints específicos por marketplace, lógica de limitación de tasa y de 2 a 4 semanas de aprobación de Amazon. DataDoe se encarga de todo eso. Obtienes una única URL MCP autenticada tanto para leer como para actuar sobre tus datos de Amazon.

DataDoe MCP - Amazon Seller Central, Vendor Central, and Amazon Ads data for AI agents via SP-API

¿Para quién es DataDoe MCP?

  • Vendedores de Amazon (FBA, FBM, multi-marketplace): obtén respuestas instantáneas de tus propios datos de vendedor sin cambiar de contexto a Seller Central.
  • Agencias de Amazon que gestionan múltiples cuentas de clientes: consulta todas las cuentas conectadas de Seller Central / Vendor Central desde un solo servidor MCP.
  • Proveedores con Vendor Central: lee datos 1P junto con datos 3P con las mismas herramientas.
  • Desarrolladores y creadores de IA: lanza agentes de IA conscientes de Amazon, paneles y herramientas internas sin escribir tu propia integración SP-API.
  • Equipos de operaciones: automatiza informes recurrentes mediante Claude Code, Cursor, n8n o cualquier herramienta de flujo de trabajo compatible con MCP.

¿Por qué usar DataDoe MCP?

  • No se necesita aprobación SP-API: DataDoe gestiona el registro de desarrollador SP-API, OAuth, tokens de actualización y límites de tasa en tu nombre.
  • Configuración en 30 segundos: pega la URL MCP y tu clave API en la configuración de tu cliente de IA. DataDoe ejecuta el servidor en infraestructura alojada.
  • Más de 20 integraciones documentadas listas para usar: Claude, ChatGPT, Cursor, Codex, Gemini CLI, GitHub Copilot, n8n, CrewAI, los SDK de Agentes de Claude y OpenAI, Excel / Word / PowerPoint vía Claude, y cualquier otro cliente compatible con MCP.
  • Resolución a nivel de SKU: profundiza en ASIN individuales, listados principales, marketplaces, períodos de tiempo, campañas de anuncios, informes de palabras clave, liquidaciones, devoluciones.
  • Multi-marketplace, multi-cuenta: un solo servidor MCP cubre todos los marketplaces de Amazon (EE. UU., Reino Unido, Alemania, Francia, Italia, España, Canadá, Australia, Japón, México y más) tanto en Seller Central como en Vendor Central.
  • Diseñado para IA de forma nativa: exports_create acepta grupos de filtros similares a SQL, GROUP BY, agregaciones e intervalos de fechas, para que tu agente de IA pueda crear informes complejos con una sola llamada de herramienta.
  • Lectura y escritura: con Acciones, tu agente no solo informa, sino que actualiza listados, gestiona pedidos y optimiza Amazon Ads, con un paso de validación dryRun y controles por tipo.
  • Infraestructura alojada siempre activa: DataDoe gestiona los límites de tasa de SP-API, la rotación de tokens y el mantenimiento continuo.

¿Qué puedes preguntar a DataDoe MCP?

Ejemplos de preguntas que tu agente de IA puede responder con DataDoe MCP conectado:

  • "¿Cuáles fueron mis 20 ASIN principales por ingresos el mes pasado en todos los marketplaces de Amazon?"
  • "Concilia mis liquidaciones de Amazon con los pedidos del primer trimestre y muestra cualquier discrepancia."
  • "¿Qué campañas de Amazon Ads tuvieron un ACoS superior al 40% la semana pasada y cuál fue su gasto total?"
  • "Muestra las unidades de inventario en riesgo de quedarse sin stock en los próximos 14 días."
  • "Crea un panel de KPI diario con ventas, tráfico y gasto en anuncios de los últimos 90 días."
  • "¿Qué términos de búsqueda en mis informes de PPC generaron más clics pero cero conversiones?"
  • "Trae todas las devoluciones de Amazon para el SKU ABC-123 en los últimos 60 días y resume los motivos de devolución."
  • "Compara mi participación de voz por término de búsqueda en análisis de marca mes a mes."

Y con Acciones habilitadas, tu agente puede actuar sobre lo que encuentra:

  • "Aumenta el presupuesto diario de mi campaña de Sponsored Products con mejor ACoS en un 20%."
  • "Pausa todas las campañas con ACoS superior al 50% la semana pasada."
  • "Actualiza el precio del SKU ABC-123 a 19.99 y actualiza sus viñetas."
  • "Confirma el envío del pedido 123-4567890-1234567 con el seguimiento de UPS 1Z999..."

Acciones: escribir en Amazon

Las Acciones permiten que tu agente de IA realice cambios en tus cuentas conectadas de Amazon Seller Central, Vendor Central y Amazon Ads a través de SP-API y Amazon Ads API. Cada Acción se registra y es auditable.

Lo que tu agente puede hacer:

  • Listados: actualizar el título, viñetas, descripción, precio, palabra clave genérica y palabra clave de tipo de artículo (AMAZON_LISTINGS_UPDATE).
  • Pedidos: cancelar un artículo de pedido con un motivo (AMAZON_ORDERS_CANCEL) o confirmar el envío y cargar el seguimiento (AMAZON_ORDERS_CONFIRM_SHIPMENT).
  • Amazon Ads: agregar, actualizar, eliminar y encontrar campañas, grupos de anuncios, targets, anuncios y asociaciones de anuncios en Sponsored Products, Brands, Display, TV y Amazon DSP.

Cómo funciona: el agente ejecuta cada Acción a través de estas herramientas MCP:

  1. actions_details_schema_get: obtén el esquema de payload para el tipo de Acción.
  2. actions_start con dryRun=true: valida el payload sin ejecutarlo.
  3. actions_start: ejecuta la Acción y obtén un id de acción.
  4. actions_get: consulta hasta que se complete y luego lee el result.

Usa actions_list para revisar Acciones pasadas (filtra por estado, tipo, creador y fecha).

Los tipos de Acción están deshabilitados por defecto y se habilitan por tipo en Configuración > Acciones. Cuando un tipo está deshabilitado, actions_start rechaza ejecuciones en vivo pero aún permite la validación dryRun.

Ejemplo de payload details para AMAZON_LISTINGS_UPDATE:

{
  "type": "AMAZON_LISTINGS_UPDATE",
  "sellerOrVendorId": "<SELLER_OR_VENDOR_UUID>",
  "dryRun": true,
  "details": {
    "changes": [
      {
        "sku": "ABC-123",
        "language_tag": "en_US",
        "name": "Stainless Steel Water Bottle 750ml",
        "price": 19.99
      }
    ]
  }
}

Ejecutar una Acción cuesta 2 tokens de IA por hasta 100 entidades, más 1 token por cada 100 adicionales. Consulta la documentación de Acciones para el catálogo completo y los esquemas de payload.

Herramientas MCP disponibles

DataDoe MCP expone las siguientes herramientas a tu cliente de IA:

HerramientaCategoríaQué hace
sellers_and_vendors_listCuentaLista los vendedores y proveedores de Amazon conectados a tu organización de DataDoe, con paginación y filtros opcionales por nombre y código de país del marketplace.
organization_and_subscription_details_getCuentaDevuelve el perfil de tu organización de DataDoe y el plan de suscripción activo.
exports_sources_getDatosBusca en el catálogo de DataDoe de plantillas de exportación de datos de Amazon preconstruidas (pedidos, ventas y tráfico, rendimiento de anuncios, inventario, listados, liquidaciones, devoluciones, análisis de marca y más).
exports_createDatosCrea una exportación de datos de Amazon desde cualquier fuente. Admite filtros similares a SQL, GROUP BY, agregaciones (sum / avg / count / countDistinct / min / max), intervalos de fechas (DAY / WEEK / MONTH), paginación y salida en CSV o JSON.
exports_getDatosDevuelve el estado y los metadatos de un trabajo de exportación en curso o completado.
exports_raw_url_getDatosDevuelve una URL de descarga única servida por el servidor MCP de DataDoe para una exportación completada.
exports_raw_downloadDatosDevuelve el contenido bruto de la exportación (CSV o JSON) en línea en la respuesta de la herramienta.
exports_deleteDatosElimina una exportación por su ID.
files_createArchivosCrea y sube un archivo de utilidad (imágenes de listado o A+) como contenido codificado en base64.
files_listArchivosLista los archivos de utilidad de la organización con paginación y filtros.
files_getArchivosDevuelve metadatos de un archivo de utilidad por id.
files_download_url_getArchivosDevuelve una URL de descarga única para un archivo subido.
files_deleteArchivosElimina un archivo de utilidad y su objeto almacenado cuando esté presente.
datadoe_user_docs_table_of_contents_getDocsDevuelve la tabla de contenidos de la documentación de usuario de DataDoe, útil cuando un agente necesita buscar funciones o capacidades bajo demanda.
datadoe_user_docs_page_getDocsDevuelve el contenido completo de una página de documentación de DataDoe con nombre.
actions_details_schema_getAccionesDevuelve el Esquema JSON del payload details requerido para iniciar un tipo de Acción determinado.
actions_startAccionesInicia una Acción que cambia tu cuenta de Amazon (listados, pedidos, Amazon Ads). Establece dryRun=true para validar sin ejecutar. Devuelve un id de acción.
actions_getAccionesDevuelve el estado y el result de una Acción por id; consulta después de actions_start.
actions_listAccionesDevuelve el historial de Acciones paginado, filtrable por estado, tipo, creador y fecha.
extensions_getExtensionesDevuelve todos los Memories y Skills agregados por el usuario.
extensions_memories_createExtensionesCrea un Memory para el usuario u organización.
extensions_memories_editExtensionesActualiza un Memory para el usuario u organización.

Configuración rápida por cliente de IA

Los fragmentos a continuación son la configuración mínima que necesitas. Para guías paso a paso por cliente de IA, consulta la lista de Guías de configuración por cliente al final de esta sección.

Claude Desktop · Claude.ai

{
  "mcpServers": {
    "datadoe": {
      "url": "https://mcp.datadoe.com/mcp/v1",
      "headers": {
        "datadoe-mcp-key": "<YOUR_DATADOE_MCP_KEY>"
      }
    }
  }
}

Claude Code

claude mcp add datadoe \
  --transport http \
  --url https://mcp.datadoe.com/mcp/v1 \
  --header "datadoe-mcp-key: <YOUR_DATADOE_MCP_KEY>"

Cursor

Agrega a ~/.cursor/mcp.json (global) o .cursor/mcp.json (por proyecto):

{
  "mcpServers": {
    "datadoe": {
      "url": "https://mcp.datadoe.com/mcp/v1",
      "headers": {
        "datadoe-mcp-key": "<YOUR_DATADOE_MCP_KEY>"
      }
    }
  }
}

GitHub Copilot (VS Code)

Agrega a tu mcp.json de VS Code:

{
  "mcpServers": {
    "datadoe": {
      "url": "https://mcp.datadoe.com/mcp/v1",
      "headers": {
        "datadoe-mcp-key": "<YOUR_DATADOE_MCP_KEY>"
      }
    }
  }
}

Codex CLI · Gemini CLI · ChatGPT · n8n · NanoClaw · cualquier otro cliente MCP

DataDoe MCP funciona como un servidor MCP remoto genérico. Configura tu cliente con:

  • URL: https://mcp.datadoe.com/mcp/v1
  • Transporte: HTTP Streamable
  • Cabecera de autenticación: datadoe-mcp-key: <YOUR_DATADOE_MCP_KEY> (crea una clave en Integraciones MCP de DataDoe)

Guías de configuración por cliente

Para guías de configuración paso a paso por cliente de IA, consulta las páginas dedicadas de documentación de DataDoe:

Raíz de documentación completa: www.datadoe.com/hub/docs


¿Qué datos de Amazon están disponibles?

DataDoe MCP expone todas las tablas de datos de Amazon disponibles en DataDoe, incluyendo:

  • Pedidos y ventas: líneas de pedido, rendimiento de pedidos, ventas y tráfico, reembolsos
  • Amazon Ads: campañas, grupos de anuncios, palabras clave, términos de búsqueda, productos / marcas / display patrocinados, métricas de ACoS / ROAS / cuota de impresiones
  • Inventario: inventario FBA, recomendaciones de reposición, inventario varado, antigüedad, unidades en riesgo
  • Listados y catálogo: catálogo de ASIN, atributos de producto, propiedad de la Buy Box, variaciones
  • Finanzas: liquidaciones, tarifas, reservas, reembolsos, depósitos
  • Devoluciones: devoluciones de clientes, motivos de devolución, devoluciones FBA
  • Analítica de marca: rendimiento de consultas de búsqueda, cesta de mercado, compra repetida, datos demográficos
  • Tráfico: sesiones, visitas a páginas, tasa de conversión, por ASIN, por marketplace

Esquema completo: www.datadoe.com/hub/data-scheme


Lo que DataDoe MCP NO es

Para evitar confusiones al evaluar servidores MCP de Amazon:

  • No es un servidor MCP autoalojado. DataDoe MCP está alojado en mcp.datadoe.com. Este repositorio de GitHub es la fachada de esquema utilizada para publicar DataDoe MCP en registros MCP públicos (Official MCP Registry, mcpservers.org, glama.ai, mcpmarket.com, Cline, smithery.ai y otros).
  • No es un envoltorio de SP-API que operes tú mismo. DataDoe posee el registro de desarrollador de SP-API, el flujo OAuth, la rotación de tokens de actualización, los endpoints de marketplace y el manejo de límites de tasa. Tú aportas tu cuenta de Amazon; nosotros nos encargamos del resto.
  • No es un servidor gratuito de código abierto. DataDoe MCP requiere una suscripción a DataDoe. Para una alternativa gratuita autoalojada, consulta los servidores MCP de Amazon de la comunidad indexados en mcpservers.org.

Documentación y recursos


Licencia

MIT. La fachada de esquema de DataDoe MCP en este repositorio es de código abierto. El servidor MCP alojado, la aplicación DataDoe y la infraestructura de DataDoe son propietarios y están operados por Deltologic.


Cómo iniciar y conectar localmente (para indexación y listado)

Este servidor es solo una fachada de esquema del servidor real de DataDoe MCP, creado para exponer DataDoe MCP a varios registros MCP. Es un servidor no-op: no hace nada más que exponer el esquema de DataDoe MCP. Si quieres usar realmente DataDoe MCP, consulta la documentación de DataDoe MCP.

1. Instalar dependencias

yarn install

2. Compilar el servidor local

yarn build

Esto compila el código fuente de TypeScript en dist/index.js.

3. Iniciar el servidor

yarn start

El servidor se comunica a través de stdio, por lo que el proceso está diseñado para ser lanzado por tu cliente MCP en lugar de abrirse en un navegador.

4. Conectar desde un cliente MCP

Para una configuración local, apunta tu cliente al punto de entrada compilado. Un mcp.json típico se ve así:

{
  "mcpServers": {
    "datadoe": {
      "command": "node",
      "args": ["/absolute/path/to/datadoe-mcp/dist/index.js"]
    }
  }
}

Si tu cliente admite rutas de espacio de trabajo basadas en variables de entorno, normalmente puedes intercambiar la ruta absoluta por la ubicación real del clon en tu máquina.


DataDoe es operado por Deltologic · datadoe.com