// docs

Mercado Livre -> Google -> AI -> Website -> Casa dos Dados

Parte de produtos no Mercado Livre, consolida vendedores unicos, usa uma escada de buscas no Google, valida sites oficiais com IA e pode usar diretorios de CNPJ como fallback para descobrir empresa e contatos.

Template ID

mercadolivre-google-website-cdd-seller-enrichment

Etapas

6

Formato final

JSON / CSV

Execução

Dashboard + API key

O que este workflow faz

Este workflow foi desenhado para prospeccao seller-first. A GeckoAPI percorre resultados do Mercado Livre, abre cada produto, extrai o seller principal e os otherSellers, executa multiplas queries no Google, rankeia candidatos, usa IA para decidir entre visitar, fazer preflight ou descartar e, quando necessario, usa paginas de CNPJ como apoio para achar empresa, contatos e CNPJ valido.

Quando usar

  • Mapear sellers de categorias fragmentadas no Mercado Livre.
  • Encontrar vendedores com operacao propria fora do marketplace.
  • Montar listas outbound com site oficial, telefone, email e dados empresariais.

Como usar no dashboard

  1. PASSO 1

    No Dashboard, selecione o template de Mercado Livre seller enrichment.

  2. PASSO 2

    Informe a keyword e quantas paginas do Mercado Livre o workflow deve percorrer.

  3. PASSO 3

    Revise a estimativa maxima de creditos, incluindo a etapa de validacao com IA.

  4. PASSO 4

    Acompanhe a coleta de produtos, a consolidacao dos sellers, a busca no Google e a validacao do site oficial.

  5. PASSO 5

    Ao final, baixe o artifact em JSON ou CSV com um item por vendedor unico.

Etapas do workflow

Mercado Livre Busca

#1

ml_search

Pesquisa produtos no Mercado Livre a partir da keyword e deduplica PDPs.

Mercado Livre Produto

#2

ml_product

Abre o produto e extrai o seller principal e os otherSellers disponiveis.

Google Search

#3

google_search

Executa uma escada de queries no Google e guarda candidatos de site oficial e diretorios de CNPJ.

AI Website Match

#4

ai_website_match

Usa IA para decidir entre visitar direto, fazer preflight ou descartar os candidatos rankeados.

Website Contact

#5

website_contact

Extrai telefones, emails, WhatsApp, redes sociais e CNPJ do site validado ou do diretorio de CNPJ escolhido no preflight.

Casa dos Dados

#6

casa_dos_dados

Enriquece o CNPJ identificado quando o website aponta para uma empresa unica.

Campos de input

Estes são os campos usados no dashboard e no body do POST /v1/workflows/runs.

Campo Tipo Obrigatório Como usar Exemplo
Keyword
keyword
text Sim

Termo pesquisado no Mercado Livre.

peca para robo aspirador
Paginas
pages
number Sim

Quantidade de paginas do Mercado Livre que o workflow deve percorrer.

2
Formato final
outputFormat
output_format Sim

Formato do artifact final.

CSV funciona bem para operacao e CRM. JSON preserva a estrutura completa do seller e da evidencias.

csv

Executar este template via API

O payload abaixo já usa este templateId e um body real compatível com o endpoint público. Depois da criação, acompanhe o run em GET /v1/workflows/runs/{runId}/status e, se necessário, cancele com POST /v1/workflows/runs/{runId}/cancel.

Ver guia completo da API de workflows
Criar workflow
curl -X POST https://api.geckoapi.com.br/v1/workflows/runs \
+  -H "Authorization: Bearer SUA_CHAVE" \
+  -H "Content-Type: application/json" \
+  -d '{
  "templateId": "mercadolivre-google-website-cdd-seller-enrichment",
  "input": {
    "keyword": "peca para robo aspirador",
    "pages": 2,
    "outputFormat": "csv"
  }
}'

Cancelar um workflow faz o resultado coletado até então se perder para consumo final, então use esse endpoint com cautela.

O que você recebe no arquivo final

Cada run gera um artifact seller-centric. O item final combina identidade do vendedor, produtos de origem, candidatos do Google, decisao da IA, dados do website e enrichment empresarial.

Perfil consolidado do seller com sinais do Mercado Livre.
Lista de produtos de origem usados como evidencia de matching.
Historico de queries do Google, candidatos rankeados e decisao da IA sobre visitar, preflight ou descartar.
Contatos, redes sociais, CNPJ e enrichment empresarial tanto de site oficial quanto de diretorio de CNPJ validado.

Envelope do artifact

O arquivo final sempre carrega metadados do run, o input original, a estimativa usada na criação e o resumo operacional da execução.

artifact.json
{
  "runId": "run_ml_123",
  "correlationId": "corr_ml_123",
  "templateId": "mercadolivre-google-website-cdd-seller-enrichment",
  "outputFormat": "json",
  "generatedAt": "2026-03-29T12:00:00.000Z",
  "input": {
    "keyword": "peca para robo aspirador",
    "pages": 2,
    "outputFormat": "json"
  },
  "estimate": {
    "maxCredits": 780,
    "breakdown": [],
    "caps": []
  },
  "summary": {
    "status": "completed",
    "completedTasks": 64,
    "failedTasks": 2,
    "discoveredStores": 41,
    "uniqueStores": 18
  },
  "items": [
    {
      "seller": {
        "itemId": "mercadolivre_seller#5521",
        "name": "Roboparts",
        "sellerId": "5521",
        "sellerUrl": "https://www.mercadolivre.com.br/perfil/ROBOPARTS",
        "sellerLevel": "5_green",
        "powerSellerStatusTitle": "MercadoLider",
        "otherSellersAvailable": true
      },
      "sourceProducts": [
        {
          "title": "Escova lateral para robo aspirador",
          "url": "https://produto.mercadolivre.com.br/MLB-123"
        }
      ],
      "website": {
        "status": "completed",
        "selectedUrl": "https://roboparts.com.br/",
        "canonicalUrl": "https://roboparts.com.br/",
        "domain": "roboparts.com.br",
        "title": "Roboparts",
        "description": "Pecas para robo aspirador",
        "phones": [
          "11999998888"
        ],
        "emails": [
          "contato@roboparts.com.br"
        ],
        "whatsAppNumbers": [
          "5511999998888"
        ],
        "facebookUrls": [],
        "instagramUrls": [
          "https://www.instagram.com/roboparts/"
        ],
        "addressSnippets": [],
        "contactPageUrls": [
          "https://roboparts.com.br/contato"
        ]
      },
      "cnpj": {
        "status": "identified",
        "value": "12345678000199",
        "candidates": [
          "12345678000199"
        ]
      },
      "casaDosDados": {
        "status": "completed",
        "extractedAt": "2026-03-29T12:02:00.000Z",
        "data": {
          "razao_social": "Roboparts Comercio Ltda"
        }
      },
      "enrichment": {
        "googleSearchQuery": "Roboparts",
        "googleSearchStatus": "completed",
        "googleCandidates": [
          {
            "position": 1,
            "url": "https://roboparts.com.br/",
            "domain": "roboparts.com.br",
            "title": "Roboparts",
            "description": "Pecas para robo aspirador"
          }
        ],
        "aiWebsiteMatchStatus": "completed",
        "aiWebsiteMatchDecision": "visit",
        "aiWebsiteMatchConfidence": 0.94,
        "aiWebsiteMatchSelectedUrl": "https://roboparts.com.br/",
        "aiWebsiteMatchSelectedDomain": "roboparts.com.br",
        "aiWebsiteMatchSelectedTitle": "Roboparts",
        "aiWebsiteMatchSelectedPosition": 1,
        "aiWebsiteMatchReason": "Nome, dominio e categoria batem com o seller.",
        "aiWebsiteMatchBrandSignals": [
          "brand-name-in-domain",
          "category-match"
        ],
        "lastError": null
      },
      "workflow": {
        "runId": "run_ml_123",
        "templateId": "mercadolivre-google-website-cdd-seller-enrichment",
        "outputFormat": "json"
      }
    }
  ]
}
Path Tipo Descrição Exemplo
correlationId string Chave de correlacao para observabilidade. corr_ml_123
estimate.maxCredits number 780
generatedAt ISO-8601 string Horario em que o artifact foi consolidado. 2026-03-29T12:00:00.000Z
input.keyword string peca para robo aspirador
input.pages number 2
items[] WorkflowMercadoLivreSellerExportItem {"seller":{"itemId":"mercadolivre_seller#5521","name":"Roboparts","sellerId":"5521","sellerUrl":"https://www.mercadolivre.com.br/perfil/ROBOPARTS","sellerLevel":"5_green","powerSellerStatusTitle":"MercadoLider","otherSellersAvailable":true},"sourceProducts":[{"title":"Escova lateral para robo aspirador","url":"https://produto.mercadolivre.com.br/MLB-123"}],"website":{"status":"completed","selectedUrl":"https://roboparts.com.br/","canonicalUrl":"https://roboparts.com.br/","domain":"roboparts.com.br","title":"Roboparts","description":"Pecas para robo aspirador","phones":["11999998888"],"emails":["contato@roboparts.com.br"],"whatsAppNumbers":["5511999998888"],"facebookUrls":[],"instagramUrls":["https://www.instagram.com/roboparts/"],"addressSnippets":[],"contactPageUrls":["https://roboparts.com.br/contato"]},"cnpj":{"status":"identified","value":"12345678000199","candidates":["12345678000199"]},"casaDosDados":{"status":"completed","extractedAt":"2026-03-29T12:02:00.000Z","data":{"razao_social":"Roboparts Comercio Ltda"}},"enrichment":{"googleSearchQuery":"Roboparts","googleSearchStatus":"completed","googleCandidates":[{"position":1,"url":"https://roboparts.com.br/","domain":"roboparts.com.br","title":"Roboparts","description":"Pecas para robo aspirador"}],"aiWebsiteMatchStatus":"completed","aiWebsiteMatchDecision":"visit","aiWebsiteMatchConfidence":0.94,"aiWebsiteMatchSelectedUrl":"https://roboparts.com.br/","aiWebsiteMatchSelectedDomain":"roboparts.com.br","aiWebsiteMatchSelectedTitle":"Roboparts","aiWebsiteMatchSelectedPosition":1,"aiWebsiteMatchReason":"Nome, dominio e categoria batem com o seller.","aiWebsiteMatchBrandSignals":["brand-name-in-domain","category-match"],"lastError":null},"workflow":{"runId":"run_ml_123","templateId":"mercadolivre-google-website-cdd-seller-enrichment","outputFormat":"json"}}
outputFormat "json" | "csv" Formato final do artifact. json
runId string Identificador do run. run_ml_123
summary.completedTasks number 64
summary.discoveredStores number 41
summary.failedTasks number 2
summary.status WorkflowRunStatus completed
summary.uniqueStores number 18
templateId string Template executado. mercadolivre-google-website-cdd-seller-enrichment

Estrutura de cada item

Cada item representa um seller unico do Mercado Livre. O artifact deixa explicito quando nao foi encontrado um site oficial validado, evitando falsos positivos forçados.

item.json
{
  "seller": {
    "itemId": "mercadolivre_seller#5521",
    "name": "Roboparts",
    "sellerId": "5521",
    "sellerUrl": "https://www.mercadolivre.com.br/perfil/ROBOPARTS",
    "sellerLevel": "5_green",
    "powerSellerStatusTitle": "MercadoLider",
    "otherSellersAvailable": true
  },
  "sourceProducts": [
    {
      "title": "Escova lateral para robo aspirador",
      "url": "https://produto.mercadolivre.com.br/MLB-123"
    }
  ],
  "website": {
    "status": "skipped",
    "selectedUrl": null,
    "canonicalUrl": null,
    "domain": null,
    "title": null,
    "description": null,
    "phones": [],
    "emails": [],
    "whatsAppNumbers": [],
    "facebookUrls": [],
    "instagramUrls": [],
    "addressSnippets": [],
    "contactPageUrls": []
  },
  "cnpj": {
    "status": "not_found",
    "value": null,
    "candidates": []
  },
  "casaDosDados": {
    "status": "skipped",
    "extractedAt": null,
    "data": null
  },
  "enrichment": {
    "googleSearchQuery": "Roboparts",
    "googleSearchStatus": "completed",
    "googleCandidates": [],
    "aiWebsiteMatchStatus": "completed",
    "aiWebsiteMatchDecision": "skip",
    "aiWebsiteMatchConfidence": 0.32,
    "aiWebsiteMatchSelectedUrl": null,
    "aiWebsiteMatchSelectedDomain": null,
    "aiWebsiteMatchSelectedTitle": null,
    "aiWebsiteMatchSelectedPosition": null,
    "aiWebsiteMatchReason": "Nenhum resultado parece ser um site oficial confiavel.",
    "aiWebsiteMatchBrandSignals": [],
    "lastError": null
  },
  "workflow": {
    "runId": "run_ml_123",
    "templateId": "mercadolivre-google-website-cdd-seller-enrichment",
    "outputFormat": "json"
  }
}
Path Tipo Descrição Exemplo
casaDosDados.status WorkflowEnrichmentStatus skipped
cnpj.status WorkflowCnpjStatus not_found
cnpj.value string | null null
enrichment.aiWebsiteMatchDecision "visit" | "skip" | null Decisao da IA sobre visitar ou nao o site. skip
enrichment.googleCandidates[] { position: number, url: string, domain: string | null, title: string | null, description: string | null } N/A
seller.itemId string mercadolivre_seller#5521
seller.name string | null Roboparts
seller.sellerId string | null 5521
seller.sellerUrl string | null https://www.mercadolivre.com.br/perfil/ROBOPARTS
sourceProducts[] { title: string | null, url: string | null } {"title":"Escova lateral para robo aspirador","url":"https://produto.mercadolivre.com.br/MLB-123"}
website.selectedUrl string | null null
website.status WorkflowEnrichmentStatus skipped
workflow.runId string run_ml_123

Observações importantes

  • Nem todo seller do Mercado Livre possui um site oficial encontravel; o workflow preserva explicitamente o caminho sem match.
  • A validacao com IA prioriza precisao. Isso reduz falso positivo, mas tambem pode pular sellers com presenca web fraca.
  • Casa dos Dados so roda quando o website aponta para um CNPJ unico e nao ambiguo.
Grátis para sempre

Rodar este workflow no dashboard?

Use o template no dashboard para estimar créditos, acompanhar a execução por etapa e baixar o artifact final.

WhatsApp