DataDoe

Servidor MCP hospedado para vendedores e fornecedores da Amazon. Conecte Claude, ChatGPT, Cursor, Codex, Gemini, GitHub Copilot a dados ao vivo das APIs SP-API e Ads da Amazon.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP Amazon Seller - DataDoe

Servidor MCP hospedado para Amazon Seller Central e Vendor Central com acesso de leitura e escrita. Conecte Claude, ChatGPT, Cursor, Codex, Gemini e GitHub Copilot a dados ao vivo da Amazon SP-API e Amazon Ads API, e deixe seu agente de IA agir sobre eles: atualize anúncios, gerencie pedidos e otimize campanhas de Amazon Ads. A DataDoe cuida da aprovação de desenvolvedor SP-API, OAuth e limites de taxa para que seu agente de IA comece a trabalhar em menos de um minuto.

🔗 Inicie um teste gratuito · 📘 Documentação · ⚡ Ações · 📊 Esquema de dados da Amazon · 🎥 Demonstração em vídeo

🚀 Início rápido

Cadastre-se na DataDoe e conecte sua conta Amazon Seller Central ou Vendor Central.
Crie uma chave de API MCP da DataDoe em Integrações MCP da DataDoe.

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>"
      }
    }
  }
}

Pergunte ao seu agente de IA: "Mostre meus 10 principais ASINs por receita no mês passado em todos os marketplaces da Amazon."

É isso. A DataDoe executa o servidor MCP em infraestrutura hospedada, então sua equipe não precisa implantar nada localmente nem aguardar a 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 expõe seus dados ao vivo da Amazon Selling Partner API (SP-API) e Amazon Ads API por meio de ferramentas MCP que funcionam 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 Amazon:

Uma camada de leitura - pedidos em nível de SKU, vendas, gastos com anúncios, tráfego, inventário, anúncios, devoluções, liquidações, análise de marca e catálogo, retornados como respostas estruturadas de ferramentas ou exportações baixáveis em CSV e JSON.
Uma camada de escrita (Ações) - seu agente pode alterar sua conta Amazon por meio da SP-API e Amazon Ads API: atualizar anúncios, cancelar pedidos, confirmar remessas e gerenciar campanhas de Amazon Ads, grupos de anúncios, alvos e anúncios.

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

Para quem é o DataDoe MCP?

Vendedores da Amazon (FBA, FBM, multi-marketplace) - obtenha respostas instantâneas dos seus próprios dados de venda sem alternar o contexto para o Seller Central.
Agências da Amazon que gerenciam múltiplas contas de clientes - consulte todas as contas conectadas do Seller Central / Vendor Central a partir de 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 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?

✅ Sem necessidade de aprovação SP-API - a DataDoe cuida do registro de desenvolvedor SP-API, OAuth, tokens de atualização e limites de taxa em seu nome.
✅ Configuração em 30 segundos - cole a URL MCP e sua chave de API na configuração do seu cliente de IA. A DataDoe executa o servidor em infraestrutura hospedada.
✅ Mais de 20 integrações documentadas prontas para uso: Claude, ChatGPT, Cursor, Codex, Gemini CLI, GitHub Copilot, n8n, CrewAI, SDKs de Agentes Claude e OpenAI, Excel / Word / PowerPoint via Claude e qualquer outro cliente compatível com MCP.
✅ Resolução em nível de SKU - aprofunde-se em ASINs individuais, anúncios principais, marketplaces, períodos de tempo, campanhas de anúncios, relatórios de palavras-chave, liquidações e devoluções.
✅ Multi-marketplace, multi-conta - um único servidor MCP cobre todos os marketplaces da Amazon (EUA, Reino Unido, Alemanha, França, Itália, Espanha, Canadá, Austrália, Japão, México e outros) no Seller Central e Vendor Central.
✅ Nativo de IA por design - exports_create aceita grupos de filtros no estilo 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.
✅ Leitura e escrita - com Ações, seu agente não apenas relata, mas atualiza anúncios, gerencia pedidos e otimiza Amazon Ads, com uma etapa de validação dryRun e controles por tipo.
✅ Infraestrutura hospedada sempre ativa - a DataDoe gerencia limites de taxa da SP-API, rotação de tokens e 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 1º trimestre e mostre quaisquer discrepâncias."
"Quais campanhas de Amazon Ads tiveram ACoS acima de 40% na semana passada e qual foi o gasto total?"
"Mostre unidades de inventário em risco de falta de estoque nos próximos 14 dias."
"Crie um painel de KPIs diários com vendas, tráfego e gastos com anúncios dos últimos 90 dias."
"Quais termos de pesquisa em meus relatórios de PPC geraram mais cliques, mas zero conversões?"
"Busque todas as devoluções da Amazon para o SKU ABC-123 nos últimos 60 dias e resuma os motivos das devoluções."
"Compare minha participação de voz por termo de pesquisa da análise de marca mês a mês."

E com Ações habilitadas, seu agente pode agir sobre o que encontrar:

"Aumente o orçamento diário da minha campanha de Sponsored Products com melhor ACoS em 20%."
"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 bullet points."
"Confirme a remessa do pedido 123-4567890-1234567 com rastreamento UPS 1Z999..."

Ações: escrever na Amazon

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

O que seu agente pode fazer:

Anúncios - atualizar título, bullet points, descrição, preço, palavra-chave genérica e palavra-chave de tipo de item (AMAZON_LISTINGS_UPDATE).
Pedidos - cancelar um item de pedido com um motivo (AMAZON_ORDERS_CANCEL) ou confirmar remessa e enviar rastreamento (AMAZON_ORDERS_CONFIRM_SHIPMENT).
Amazon Ads - adicionar, atualizar, remover e encontrar campanhas, grupos de anúncios, alvos, anúncios e associações de anúncios em Sponsored Products, Brands, Display, TV e Amazon DSP.

Como funciona - o agente executa cada Ação por meio destas ferramentas MCP:

actions_details_schema_get - obtenha o esquema de payload para o tipo de Ação.
actions_start com dryRun=true - valide o payload sem executar.
actions_start - execute a Ação e obtenha um ID de ação.
actions_get - consulte até concluir e leia o result.

Use actions_list para revisar Ações anteriores (filtre por status, tipo, criador e data).

Os tipos de Ação ficam desabilitados por padrão e são habilitados por tipo em Configurações > Ações. Quando um tipo está desabilitado, actions_start rejeita execuções ao vivo, mas ainda permite validação 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",
        "price": 19.99
      }
    ]
  }
}

Executar uma Ação custa 2 tokens de IA para até 100 entidades, mais 1 token por 100 adicionais. Consulte a documentação de Ações para o catálogo completo e esquemas de payload.

Ferramentas MCP disponíveis

O DataDoe MCP expõe as seguintes ferramentas ao seu cliente de IA:

Ferramenta	Categoria	O que faz
`sellers_and_vendors_list`	Conta	Lista vendedores e fornecedores da Amazon conectados à sua organização DataDoe, com paginação e filtros opcionais por nome e código de país do marketplace.
`organization_and_subscription_details_get`	Conta	Retorna o perfil da sua organização DataDoe e o plano de assinatura ativo.
`exports_sources_get`	Dados	Pesquisa o catálogo da DataDoe de modelos pré-criados de exportação de dados da Amazon (pedidos, vendas e tráfego, desempenho de anúncios, inventário, anúncios, liquidações, devoluções, análise de marca e mais).
`exports_create`	Dados	Cria uma exportação de dados da Amazon de qualquer fonte. Suporta filtros no estilo SQL, GROUP BY, agregações (soma / média / contagem / contagemDistinta / mínimo / máximo), intervalos de datas (DIA / SEMANA / MÊS), paginação e saída em CSV ou JSON.
`exports_get`	Dados	Retorna status e metadados de um trabalho de exportação em andamento ou concluído.
`exports_list`	Dados	Lista trabalhos de exportação da organização com paginação e filtros opcionais por ID de exportação.
`exports_raw_url_get`	Dados	Retorna uma URL de download de uso único servida pelo servidor MCP da DataDoe para uma exportação concluída.
`exports_raw_download`	Dados	Retorna o conteúdo bruto da exportação (CSV ou JSON) diretamente na resposta da ferramenta.
`exports_delete`	Dados	Exclui uma exportação pelo seu ID.
`files_create`	Arquivos	Cria e envia um arquivo utilitário (imagens de anúncio ou A+) como conteúdo codificado em base64.
`files_list`	Arquivos	Lista arquivos utilitários da organização com paginação e filtros.
`files_get`	Arquivos	Retorna metadados de um arquivo utilitário por ID.
`files_download_url_get`	Arquivos	Retorna uma URL de download de uso único para um arquivo enviado.
`files_delete`	Arquivos	Exclui um arquivo utilitário e seu objeto armazenado quando presente.
`datadoe_user_docs_table_of_contents_get`	Documentação	Retorna o sumário da documentação do usuário da DataDoe, útil quando um agente precisa consultar recursos ou capacidades sob demanda.
`datadoe_user_docs_page_get`	Documentação	Retorna o conteúdo completo de uma página nomeada da documentação da DataDoe.
`actions_details_schema_get`	Ações	Retorna o JSON Schema do payload `details` necessário para iniciar um determinado tipo de Ação.
`actions_start`	Ações	Inicia uma Ação que altera sua conta Amazon (anúncios, pedidos, Amazon Ads). Defina `dryRun=true` para validar sem executar. Retorna um ID de ação.
`actions_get`	Ações	Retorna o status e o `result` de uma Ação por ID; consulte após `actions_start`.
`actions_list`	Ações	Retorna o histórico de Ações paginado, filtrável por status, tipo, criador e data.
`cogs_upsert`	COGS	Cria ou atualiza linhas de custo dos produtos vendidos para um vendedor ou fornecedor.
`cogs_delete`	COGS	Exclui linhas de COGS para um vendedor ou fornecedor com filtros opcionais.
`vendor_code_upsert`	Códigos de fornecedor	Cria ou atualiza linhas de código de fornecedor para um vendedor ou fornecedor.
`vendor_code_delete`	Códigos de fornecedor	Exclui linhas de código de fornecedor para um vendedor ou fornecedor com filtros opcionais.
`plugins_get`	Plugins	Retorna os Plugins da DataDoe habilitados (Memórias, Habilidades e Arquivos) para o usuário.
`plugins_memories_create`	Plugins	Cria um Plugin de memória para o usuário ou organização.
`plugins_memories_edit`	Plugins	Atualiza um Plugin de memória para o usuário ou organização.
`plugins_skills_get`	Plugins	Retorna um elemento de Habilidade (SKILL.md ou arquivo de suporte) listado por plugins_get.
`plugins_files_get`	Plugins	Retorna conteúdo markdown convertido para um Plugin de Arquivo listado por plugins_get.

Configuração rápida por cliente de IA

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

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

Adicione ao ~/.cursor/mcp.json (global) ou .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 ao seu mcp.json do 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 · 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 do DataDoe)

Guias de configuração por cliente

Para guias de configuração passo a passo por cliente de IA, consulte as páginas de documentação dedicadas do 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 no DataDoe, 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 patrocinados / marcas / display, métricas de ACoS / ROAS / participação de impressões
Inventário: inventário FBA, recomendações de reposição, inventário encalhado, idade, unidades em risco
Listagens e catálogo: catálogo ASIN, atributos de produto, propriedade da caixa de compra, variações
Finanças: liquidações, taxas, 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, compra repetida, dados demográficos
Tráfego: sessões, visualizações de página, taxa de conversão, por ASIN, por 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 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 SP-API que você opera por conta própria. O DataDoe possui o registro de desenvolvedor SP-API, fluxo OAuth, rotação de tokens de atualização, endpoints de marketplace e tratamento de limites de taxa. Você traz sua conta da Amazon; nós cuidamos do resto.
❌ Não é um servidor open-source gratuito. O DataDoe MCP requer uma assinatura do DataDoe. Para uma alternativa gratuita auto-hospedada, consulte os servidores MCP da comunidade indexados em mcpservers.org.

Documentação e recursos

Licença

MIT. A fachada de esquema do DataDoe MCP neste repositório é open-source. O servidor MCP hospedado, o aplicativo DataDoe e a infraestrutura do DataDoe são proprietários e operados pela Deltologic.

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

Este servidor é apenas uma fachada de esquema do servidor MCP real do DataDoe, criado para expor o DataDoe MCP a vários registros MCP. É um servidor no-op: ele não faz nada além de expor o esquema do DataDoe MCP. Se você quiser realmente usar o DataDoe MCP, 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 via stdio, então o processo deve ser iniciado pelo seu cliente MCP em vez de aberto em um navegador.

4. Conectar 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 suportar caminhos de workspace baseados em ambiente, você geralmente pode substituir o caminho absoluto pelo local real do clone na sua máquina.

O DataDoe é operado pela Deltologic · datadoe.com