DataDoe

oficial

Servidor MCP hospedado para Amazon Seller Central, Vendor Central e Amazon Ads: agentes de IA leem dados em tempo real e atualizam anúncios, pedidos e campanhas publicitárias

O que você pode fazer com DataDoe MCP?

  • Consultar dados de vendas da Amazon — Solicite pedidos, vendas, tráfego, estoque, devoluções ou liquidações por SKU, entre marketplaces e períodos.
  • Criar exportações personalizadas — Crie exportações com filtros semelhantes a SQL, GROUP BY, agregações e intervalos de datas, retornadas como CSV ou JSON.
  • Analisar Amazon Ads — Analise o desempenho de campanhas, palavras-chave e termos de pesquisa, incluindo métricas de ACoS, ROAS e participação nas impressões.
  • Atualizar anúncios e pedidos — Altere títulos, tópicos, preços e imagens, ou cancele pedidos e confirme envios por meio de Actions.
  • Gerenciar campanhas de Ads — Adicione, atualize, remova ou pause campanhas, grupos de anúncios, alvos e anúncios, com uma etapa de validação dryRun.
  • Executar consultas do AMC — Valide, inicie e obtenha resultados de consultas e fluxos de trabalho do Amazon Marketing Cloud.

Documentação

Amazon Seller MCP Server - DataDoe

Servidor MCP hospedado do Amazon Seller Central e Vendor Central com acesso de leitura e gravação. Conecte Claude, ChatGPT, Cursor, Codex, Gemini e GitHub Copilot aos dados em tempo real da Amazon SP-API e da Amazon Ads API e, em seguida, permita que seu agente de IA aja com base neles: atualize listagens, gerencie pedidos e otimize campanhas do Amazon Ads. A DataDoe cuida da aprovação de desenvolvedor da SP-API, do OAuth e dos limites de taxa para que seu agente de IA comece a trabalhar em menos de um minuto.

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

🔗 Comece um teste grátis de 14 dias · 📘 Documentação · ⚡ Ações · 📊 Esquema de dados da Amazon · 🎥 Demonstração em vídeo


🚀 Início rápido

  1. Cadastre-se na DataDoe e conecte sua conta do Amazon Seller Central ou Vendor Central.

  2. Crie uma chave de API MCP da DataDoe em Integrações MCP da DataDoe.

  3. Cole a configuração abaixo no seu cliente de IA (Claude, Cursor, Codex, Gemini, GitHub Copilot, ChatGPT ou qualquer ferramenta compatível com MCP):

    {
      "mcpServers": {
        "datadoe": {
          "url": "https://mcp.datadoe.com/mcp/v1",
          "headers": {
            "datadoe-mcp-key": "<YOUR_DATADOE_MCP_KEY>"
          }
        }
      }
    }
    
  4. Pergunte ao seu agente de IA: "Mostre meus 10 principais ASINs por receita no mês passado em todos os marketplaces da Amazon."

Pronto. A DataDoe executa o servidor MCP em uma infraestrutura hospedada, então sua equipe não precisa implantar nada localmente nem esperar pela aprovação de desenvolvedor da Amazon SP-API.


O que é o DataDoe MCP?

DataDoe MCP é um servidor hospedado do Model Context Protocol (MCP) para vendedores, fornecedores e agências da Amazon. Ele disponibiliza seus dados em tempo real da Amazon Selling Partner API (SP-API) e da Amazon Ads API por meio de ferramentas MCP compatíveis com Claude, ChatGPT, Cursor, Codex CLI, Gemini CLI, GitHub Copilot, Claude Desktop, n8n, NanoClaw e qualquer outro cliente compatível com MCP.

O DataDoe MCP oferece ao seu agente de IA duas camadas sobre sua conta da Amazon:

  • Uma camada de leitura - pedidos por SKU, vendas, gastos com anúncios, tráfego, estoque, listagens, devoluções, liquidações, análises de marca e catálogo, retornados como respostas estruturadas das ferramentas ou exportações CSV e JSON para download.
  • Uma camada de gravação (Actions) - seu agente pode alterar sua conta da Amazon por meio da SP-API e da Amazon Ads API: atualizar listagens, cancelar pedidos, confirmar envios e gerenciar campanhas, grupos de anúncios, alvos e anúncios do Amazon Ads.

Criar sua própria integração com a Amazon SP-API normalmente exige registro de desenvolvedor da SP-API, fluxo de token de atualização OAuth, endpoints específicos de cada marketplace, lógica de limitação de taxa e de 2 a 4 semanas para aprovação da Amazon. A DataDoe cuida de tudo isso. Você recebe uma única URL MCP autenticada para ler e executar ações nos seus dados da Amazon.

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

Para quem é o DataDoe MCP?

  • Vendedores da Amazon (FBA, FBM, vários marketplaces) - obtenha respostas instantâneas com seus próprios dados de vendedor sem alternar para o Seller Central.
  • Agências da Amazon que gerenciam várias contas de clientes - consulte todas as contas conectadas do Seller Central / Vendor Central em um único servidor MCP.
  • Fornecedores com Vendor Central - leia dados 1P junto com dados 3P usando as mesmas ferramentas.
  • Desenvolvedores e criadores de IA - lance agentes de IA, painéis e ferramentas internas com conhecimento da Amazon sem escrever sua própria integração com a SP-API.
  • Equipes de operações - automatize relatórios recorrentes via Claude Code, Cursor, n8n ou qualquer ferramenta de fluxo de trabalho compatível com MCP.

Por que usar o DataDoe MCP?

  • ✅ Não é necessária aprovação da SP-API - a DataDoe cuida do registro de desenvolvedor da SP-API, do OAuth, dos tokens de atualização e dos limites de taxa em seu nome.
  • ✅ Configuração em 30 segundos - cole a URL MCP e sua chave de API na configuração do cliente de IA. A DataDoe executa o servidor em uma infraestrutura hospedada.
  • ✅ Mais de 20 integrações documentadas prontas para uso: Claude, ChatGPT, Cursor, Codex, Gemini CLI, GitHub Copilot, n8n, CrewAI, os SDKs de agente do Claude e da OpenAI, Excel / Word / PowerPoint via Claude e qualquer outro cliente compatível com MCP.
  • ✅ Resolução no nível de SKU - aprofunde-se em ASINs individuais, listagens pai, marketplaces, períodos, campanhas de anúncios, relatórios de palavras-chave, liquidações e devoluções.
  • ✅ Vários marketplaces e contas - um servidor MCP cobre todos os marketplaces da Amazon (US, UK, DE, FR, IT, ES, CA, AU, JP, MX e outros) no Seller Central e no Vendor Central.
  • ✅ Projetado para IA desde o início - exports_create aceita grupos de filtros semelhantes a SQL, GROUP BY, agregações e intervalos de datas, para que seu agente de IA possa criar relatórios complexos com uma única chamada de ferramenta.
  • ✅ Um plano, um preço - US$ 97/mês com teste grátis de 14 dias. Consulte preços.
  • ✅ Leitura e gravação - com Actions, seu agente não apenas gera relatórios: ele atualiza listagens, gerencia pedidos e otimiza o Amazon Ads, com uma etapa de validação dryRun e controles por tipo.
  • ✅ Infraestrutura hospedada sempre ativa - a DataDoe gerencia os limites de taxa da SP-API, a rotação de tokens e a manutenção contínua.

O que você pode perguntar ao DataDoe MCP?

Exemplos de perguntas que seu agente de IA pode responder com o DataDoe MCP conectado:

  • "Quais foram meus 20 principais ASINs por receita no mês passado em todos os marketplaces da Amazon?"
  • "Concilie minhas liquidações da Amazon com os pedidos do primeiro trimestre e mostre quaisquer divergências."
  • "Quais campanhas do Amazon Ads tiveram ACoS acima de 40% na semana passada e qual foi o gasto total delas?"
  • "Mostre as unidades em estoque com risco de ruptura nos próximos 14 dias."
  • "Crie um painel diário de KPIs com vendas, tráfego e gastos com anúncios dos últimos 90 dias."
  • "Quais termos de pesquisa nos meus relatórios de PPC geraram mais cliques, mas nenhuma conversão?"
  • "Busque todas as devoluções da Amazon do SKU ABC-123 nos últimos 60 dias e resuma os motivos das devoluções."
  • "Compare mês a mês a participação de voz dos termos de pesquisa nas análises da minha marca."

E, com Actions ativadas, seu agente pode agir com base no que encontrar:

  • "Aumente em 20% o orçamento diário da minha campanha de Sponsored Products com o maior ACoS."
  • "Pause todas as campanhas com ACoS acima de 50% na semana passada."
  • "Atualize o preço do SKU ABC-123 para 19.99 e atualize seus tópicos."
  • "Confirme o envio do pedido 123-4567890-1234567 com o código de rastreamento UPS 1Z999..."

Actions: gravar na Amazon

As Actions permitem que seu agente de IA faça alterações nas contas conectadas do Amazon Seller Central, Vendor Central e Amazon Ads por meio da SP-API e da Amazon Ads API. Cada Action é registrada e auditável.

O que seu agente pode fazer:

  • Listagens - atualizar o título, os tópicos, a descrição, a palavra-chave genérica, a palavra-chave do tipo de item e as imagens (AMAZON_LISTINGS_UPDATE), atualizar preços de contas do Seller Central (AMAZON_LISTINGS_PRICING_UPDATE) e visualizar uma alteração de listagem com a Action *_VERIFY correspondente antes de enviá-la.
  • Pedidos - cancelar um item de pedido, confirmar o envio, comprar frete, solicitar uma avaliação, enviar uma mensagem ao comprador ou pesquisar pedidos atuais (AMAZON_ORDERS_FIND) e métricas de pedidos (AMAZON_ORDERS_GET_METRICS).
  • Vendor Central - confirmar pedidos de compra, enviar remessas e recuperar etiquetas, listas de embalagem e o status das transações.
  • Amazon Ads - adicionar, atualizar, remover e localizar campanhas, grupos de anúncios, alvos, anúncios, associações de anúncios e regras de lance de Sponsored Products em Sponsored Products, Brands, Display, TV e Amazon DSP.

Como funciona - o agente executa cada Action por meio destas ferramentas MCP:

  1. actions_details_schema_get - obter o esquema do payload para o tipo de Action.
  2. actions_start com dryRun=true - validar o payload sem executá-lo.
  3. actions_start - executar a Action e obter um ID de ação.
  4. actions_get - consultar até que seja concluída e, em seguida, ler o result.

Use actions_list para revisar Actions anteriores (filtre por status, tipo, criador e data).

Os tipos de Action ficam desativados por padrão e são ativados por tipo em Configurações > Actions. Quando um tipo está desativado, actions_start rejeita execuções reais, mas ainda permite a validação de dryRun.

Exemplo 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",
        "bulletPoints": ["Keeps drinks cold for 24 hours", "Leak-proof lid"]
      }
    ]
  }
}

A execução de uma Action custa 3 AI Tokens para até 100 alterações, mais 1 AI Token por cada 100 alterações adicionais. Consulte a documentação de Actions para ver o catálogo completo e os esquemas de payload.

Ferramentas MCP disponíveis

O DataDoe MCP disponibiliza as seguintes ferramentas para seu cliente de IA:

FerramentaCategoriaO que faz
sellers_and_vendors_listContaLista os vendedores e fornecedores da Amazon conectados à sua organização DataDoe, com tipo de conta, marketplace e detalhes da conexão.
sellers_and_vendors_getContaRetorna um vendedor ou fornecedor, incluindo se a conexão precisa ser reautorizada.
sellers_and_vendors_renameContaRenomeia um vendedor ou fornecedor. Os nomes são exclusivos dentro da organização.
sellers_and_vendors_invitation_createContaCria um link de uso único para conectar uma nova conta da Amazon ou reconectar uma conta existente.
sellers_and_vendors_invitations_getContaLista os convites pendentes ou retorna um convite e seu status.
sellers_and_vendors_invitation_revokeContaRevoga um convite pendente para que o link não possa mais ser usado.
organization_and_subscription_details_getContaRetorna o perfil da sua organização DataDoe, o plano de assinatura, a situação do faturamento e os saldos de AI Token.
exports_sources_getDadosPesquisa o catálogo DataDoe de fontes de exportação de dados da Amazon (pedidos, vendas e tráfego, desempenho de anúncios, estoque, listagens, liquidações, devoluções, análise de marca e muito mais) por palavra-chave.
exports_source_getDadosRetorna as colunas (paginadas) e os metadados de uma fonte de exportação, incluindo se é necessário informar um período de datas.
exports_createDadosCria uma exportação de dados da Amazon a partir de qualquer fonte. Oferece suporte a filtros semelhantes a SQL, HAVING, GROUP BY, agregações (sum / avg / count / countDistinct / min / max), intervalos de datas (DAY / WEEK / MONTH), paginação e saída em CSV ou JSON.
exports_getDadosRetorna o status e os metadados de uma tarefa de exportação em andamento ou concluída.
exports_listDadosLista as tarefas de exportação da organização com paginação e filtros opcionais por ID de exportação.
exports_raw_url_getDadosRetorna uma URL de download para uma exportação concluída, válida até 15 minutos após a criação da exportação.
exports_raw_downloadDadosRetorna o conteúdo bruto da exportação (CSV ou JSON) diretamente na resposta da ferramenta.
exports_deleteDadosExclui uma exportação pelo ID.
files_createArquivosCria e envia um arquivo utilitário (imagens de listagem, imagens A+ ou arquivos de mensagens de pedido) como conteúdo codificado em base64.
files_listArquivosLista os arquivos utilitários da organização com paginação e filtros.
files_getArquivosRetorna os metadados de um arquivo utilitário pelo ID.
files_download_url_getArquivosRetorna uma URL de download para um arquivo enviado, válida até 15 minutos após a criação do arquivo.
files_deleteArquivosExclui um arquivo utilitário e o objeto armazenado correspondente, se houver.
datadoe_user_docs_table_of_contents_getDocumentaçãoRetorna o índice da documentação do usuário DataDoe, útil quando um agente precisa consultar recursos ou funcionalidades sob demanda.
datadoe_user_docs_page_getDocumentaçãoRetorna o conteúdo completo de uma página nomeada da documentação DataDoe.
actions_details_schema_getAçõesRetorna o JSON Schema do payload details, o modo de acesso (READ ou WRITE), se esse tipo de Action está habilitado e a ferramenta de início.
actions_startAçõesInicia uma Action READ ou WRITE na sua conta da Amazon (listagens, pedidos, A+ Content, Multi-Channel Fulfillment, Amazon Ads). Defina dryRun=true para validar sem executar. Retorna um ID de ação.
actions_getAçõesRetorna o status e o result de uma Action pelo ID; consulte novamente após actions_start.
actions_listAçõesRetorna o histórico paginado de Actions, com filtros por status, tipo, criador e data.
cogs_upsertCOGSCria ou atualiza linhas de custo dos produtos vendidos para uma conta do Seller Central.
cogs_deleteCOGSExclui linhas de COGS de uma conta do Seller Central com filtros opcionais.
vendor_code_upsertCódigos de fornecedorCria ou atualiza linhas de códigos de fornecedor para uma conta com conexão ao Vendor Central.
vendor_code_deleteCódigos de fornecedorExclui linhas de códigos de fornecedor de uma conta com conexão ao Vendor Central, com filtros opcionais.
sqp_asins_getSQPRetorna a lista de ASINs de Search Query Performance (SQP) de uma conta do Seller Central. A DataDoe armazena até 252 ASINs.
sqp_asins_addSQPAdiciona até 252 ASINs por chamada à lista de SQP de uma conta do Seller Central.
sqp_asins_removeSQPRemove até 252 ASINs por chamada da lista de SQP de uma conta do Seller Central.
plugins_getPluginsRetorna as Memories e Skills salvas na organização, além dos Files prontos para o usuário.
plugins_memories_createPluginsCria um Plugin de memória para o usuário ou a organização.
plugins_memories_editPluginsAtualiza um Plugin de memória para o usuário ou a organização.
plugins_memories_deletePluginsExclui um Plugin de memória do usuário ou da organização.
plugins_skills_getPluginsRetorna um elemento Skill (SKILL.md ou arquivo de suporte) listado por plugins_get.
plugins_files_getPluginsRetorna o conteúdo convertido para Markdown de um plugin File listado por plugins_get.
amc_workflows_findAMCLista os workflows ativos do Amazon Marketing Cloud (AMC), com suas programações e hash de estado.
amc_workflows_createAMCCria um workflow AMC (SQL com programações opcionais diárias ou semanais) sem executá-lo.
amc_workflows_updateAMCAtualiza o SQL e/ou as programações de um workflow AMC.
amc_workflows_deleteAMCExclui um workflow AMC e suas programações.
amc_query_validateAMCExecuta uma simulação de um workflow, SQL bruto ou modelo de consulta na Amazon sem iniciar uma execução.
amc_query_startAMCInicia uma consulta AMC sob demanda a partir de um workflow, SQL bruto ou modelo de consulta.
amc_query_cancelAMCCancela uma consulta AMC pendente ou em execução.
amc_query_results_findAMCLista o histórico de resultados de consultas AMC com filtros.
amc_query_result_getAMCRetorna um resultado de consulta AMC, incluindo URLs de download temporárias quando disponível.
amc_schema_findAMCConsulta o esquema AMC ativo: um índice de tabelas ou os campos de uma fonte de dados.
amc_operation_getAMCRetorna o status de uma operação AMC assíncrona, como uma alteração de workflow ou o início incerto de uma consulta.
amc_query_templates_findAMCLista modelos de consulta AMC prontos e, quando uma conta está selecionada, informa se ela pode executar cada um.
amc_query_template_getAMCRetorna um modelo de consulta AMC, incluindo seu SQL.
datadoe_support_ticket_createSuporteEnvia uma solicitação de suporte à equipe DataDoe.
datadoe_support_ticket_checkSuporteConsulta uma solicitação de suporte e qualquer resposta. Verifique aproximadamente uma vez por hora.
datadoe_support_ticket_updateSuporteAdiciona mais informações a uma solicitação de suporte existente.

As ferramentas do Amazon Marketing Cloud (AMC) estão disponíveis somente mediante solicitação e são listadas pelo servidor ativo apenas após a concessão de acesso. Consulte Amazon Marketing Cloud.


Configuração rápida por cliente de IA

Os trechos abaixo são a configuração mínima necessária. Para ver guias passo a passo de cada cliente de IA, consulte a lista de Guias de configuração por cliente no final desta seção.

Claude.ai · Claude Desktop

Adicione DataDoe como um conector personalizado: abra Customize > Connectors, clique em Add e cole https://mcp.datadoe.com/mcp/v1 como URL do servidor MCP. O Claude entra na DataDoe usando OAuth, então você não precisa de uma chave de API. Consulte Usando o Claude.

Claude Code

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

O nome e a URL do servidor devem vir antes de --header. Você também pode omitir --header e entrar com OAuth executando /mcp no Claude Code e escolhendo Authenticate.

Cursor

Adicione a ~/.cursor/mcp.json (global) ou a .cursor/mcp.json (por projeto):

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

GitHub Copilot (VS Code)

Adicione a .vscode/mcp.json (por projeto) ou à configuração MCP do usuário (MCP: Open User Configuration):

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

Codex CLI · Gemini CLI · ChatGPT · n8n · NanoClaw · qualquer outro cliente MCP

O DataDoe MCP funciona como um servidor MCP remoto genérico. Configure seu cliente com:

  • URL: https://mcp.datadoe.com/mcp/v1
  • Transporte: HTTP Streamable
  • Cabeçalho de autenticação: datadoe-mcp-key: <YOUR_DATADOE_MCP_KEY> (crie uma chave em Integrações MCP da DataDoe)

Guias de configuração por cliente

Para ver guias passo a passo de configuração por cliente de IA, consulte as páginas dedicadas da documentação DataDoe:

Raiz da documentação completa: www.datadoe.com/hub/docs


Quais dados da Amazon estão disponíveis?

O DataDoe MCP expõe todas as tabelas de dados da Amazon disponíveis na DataDoe: mais de 130 tabelas do Seller Central, Vendor Central e Amazon Ads, incluindo:

  • Pedidos e vendas: itens de linha de pedidos, desempenho de pedidos, vendas e tráfego, reembolsos
  • Amazon Ads: campanhas, grupos de anúncios, palavras-chave, termos de pesquisa, produtos / marcas / display patrocinados, métricas de ACoS / ROAS / participação nas impressões
  • Estoque: estoque FBA, recomendações de reposição, estoque sem oferta, idade, unidades em risco
  • Listagens e catálogo: catálogo de ASINs, atributos de produtos, titularidade da oferta em destaque, variações
  • Finanças: liquidações, tarifas, reservas, reembolsos, depósitos
  • Devoluções: devoluções de clientes, motivos de devolução, devoluções FBA
  • Análise de marca: desempenho de consultas de pesquisa, cesta de mercado, compras recorrentes, dados demográficos
  • Tráfego: sessões, visualizações de página, taxa de conversão, por ASIN e marketplace

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


O que o DataDoe MCP NÃO é

Para evitar confusão ao avaliar servidores MCP da Amazon:

  • ❌ Não é um servidor MCP auto-hospedado. O DataDoe MCP está hospedado em mcp.datadoe.com. Este repositório do GitHub é a fachada de esquema usada para publicar o DataDoe MCP em registros MCP públicos (Official MCP Registry, mcpservers.org, glama.ai, mcpmarket.com, Cline, smithery.ai e outros).
  • ❌ Não é um wrapper de SP-API que você opera por conta própria. A DataDoe gerencia o registro de desenvolvedor da SP-API, o fluxo OAuth, a rotação de refresh tokens, os endpoints de marketplace e o tratamento de limites de taxa. Você fornece sua conta da Amazon; nós cuidamos do restante.
  • ❌ Não é um servidor gratuito de código aberto. O DataDoe MCP faz parte de uma assinatura DataDoe: US$ 97/mês, com período de avaliação gratuita de 14 dias.

Documentação e recursos


Licença

MIT. A fachada de esquema do DataDoe MCP neste repositório é de código aberto. O servidor MCP hospedado, o aplicativo DataDoe e a infraestrutura DataDoe são proprietários e fornecidos pela DataDoe, Inc.


Como iniciar e conectar localmente (para indexação e listagem)

Este servidor é apenas uma fachada de esquema do servidor DataDoe MCP real, criada para expor o DataDoe MCP a vários registros MCP. É um servidor sem operações: não faz nada além de expor o esquema do DataDoe MCP. Se quiser usar o DataDoe MCP de verdade, consulte a documentação do DataDoe MCP.

1. Instalar dependências

yarn install

2. Compilar o servidor local

yarn build

Isso compila o código-fonte TypeScript em dist/index.js.

3. Iniciar o servidor

yarn start

O servidor se comunica por stdio, então o processo deve ser iniciado pelo seu cliente MCP, e não aberto em um navegador.

4. Conecte-se a partir de um cliente MCP

Para uma configuração local, aponte seu cliente para o ponto de entrada compilado. Um mcp.json típico se parece com isto:

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

Se o seu cliente oferecer suporte a caminhos de workspace definidos por variáveis de ambiente, geralmente você pode substituir o caminho absoluto pelo local real do clone na sua máquina.


DataDoe é um produto da DataDoe, Inc. · datadoe.com