Enriquecimento de Dados

Visão geral

O enriquecimento de dados é o processo de pegar registros brutos de produtos e melhorar progressivamente sua qualidade pelos estágios do pipeline. Este guia cobre o fluxo completo — desde o import inicial pelo Bronze, normalização Silver, pontuação Gold — até o enriquecimento avançado via web scraping com Bright Data.

Passo 1 — Import (Bronze)

O primeiro passo é colocar seus dados no sistema. Todos os imports chegam na camada Bronze: brutos, sem modificação e idempotentes.

Métodos de import

Método	Melhor para
Upload CSV/Excel	Planilhas de fornecedores existentes
Import por URL	Raspar páginas de produto diretamente da web
API (`POST /api/workspace/{workspaceId}/catalogs/{catalogId}/products`)	Feeds programáticos
Feed MCP	Sincronização de catálogo em tempo real de sistemas externos

Após o import, produtos ficam visíveis no catálogo com pipeline_stage: "bronze".

Passo 2 — Silver (Normalizar)

O Silver limpa e normaliza seus dados brutos: padroniza capitalização, valida URLs de imagens, detecta duplicatas e mapeia campos para o schema da Alana.

Executar Silver via UI

Abra seu catálogo
Selecione os produtos que deseja normalizar (ou use Selecionar Todos)
Clique em Ações em Lote → Normalizar
Um indicador de progresso exibe normalizado / total
Quando concluído, revise o painel de resultados: campos mapeados, duplicatas encontradas, URLs quebradas

Executar Silver via API

curl -X POST "https://app.alana.shopping/api/workspace/WORKSPACE_ID/catalogs/CATALOG_ID/batch/silver" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scope": "all"}'

const response = await fetch(
  `https://app.alana.shopping/api/workspace/${workspaceId}/catalogs/${catalogId}/batch/silver`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ scope: 'all' }),
  }
);
const result = await response.json();
console.log(`${result.processed} produtos normalizados em ${result.duration_ms}ms`);

import requests

response = requests.post(
    f"https://app.alana.shopping/api/workspace/{workspace_id}/catalogs/{catalog_id}/batch/silver",
    headers={"Authorization": f"Bearer {api_key}"},
    json={"scope": "all"}
)
result = response.json()
print(f"{result['processed']} produtos normalizados em {result['duration_ms']}ms")

Resultados do Silver

Após o Silver, cada produto contém:

fieldsNormalized — quantidade de campos transformados
duplicateOf — ID do produto se uma duplicata foi detectada
urlsValidated — quantidade de URLs de imagens/mídia verificadas
pipeline_stage: "silver"

Passo 3 — Gold (Pontuar & Analisar)

O Gold produz uma pontuação de otimização (0–100) e uma lista de lacunas — os campos que, se preenchidos, mais aumentariam a pontuação.

Executar Gold via UI

Selecione produtos no catálogo
Clique em Ações em Lote → Analisar
Um indicador de progresso exibe analisados / total
Quando concluído, cada produto exibe seu badge de pontuação e destaques de lacunas

Executar Gold via API

curl -X POST "https://app.alana.shopping/api/workspace/WORKSPACE_ID/catalogs/CATALOG_ID/batch/gold" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scope": "all"}'

const response = await fetch(
  `https://app.alana.shopping/api/workspace/${workspaceId}/catalogs/${catalogId}/batch/gold`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ scope: 'all' }),
  }
);
const { results, catalogSummary } = await response.json();
console.log(`Pontuação média: ${catalogSummary.avgScore}`);

import requests

response = requests.post(
    f"https://app.alana.shopping/api/workspace/{workspace_id}/catalogs/{catalog_id}/batch/gold",
    headers={"Authorization": f"Bearer {api_key}"},
    json={"scope": "all"}
)
data = response.json()
print(f"Pontuação média: {data['catalogSummary']['avgScore']}")

Passo 4 — Revisar pontuações no Canvas

Após o Gold, abra o Canvas para revisar e agir sobre os resultados do enriquecimento:

Ordene produtos por pontuação (crescente) para encontrar os itens de menor qualidade
Para cada produto, o painel Lacunas mostra exatamente quais campos estão ausentes
Use o editor inline para preencher lacunas diretamente no Canvas
Execute novamente o Gold nos produtos editados para atualizar a pontuação

Passo 5 — Enriquecimento via Bright Data

Para produtos com dados incompletos, a Alana integra com o Bright Data para enriquecer via web scraping, análise SERP e presets de datasets.

Import por URL com web scraping

Ao importar via URL de produto, o Web Scraper do Bright Data extrai dados estruturados diretamente da página do produto.

curl -X POST "https://app.alana.shopping/api/workspace/WORKSPACE_ID/url-import" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/produto/tenis-running-azul",
    "catalogId": "CATALOG_ID",
    "method": "web_scraper"
  }'

const response = await fetch(
  `https://app.alana.shopping/api/workspace/${workspaceId}/url-import`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      url: 'https://example.com/produto/tenis-running-azul',
      catalogId,
      method: 'web_scraper',
    }),
  }
);
const { jobId } = await response.json();

import requests

response = requests.post(
    f"https://app.alana.shopping/api/workspace/{workspace_id}/url-import",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "url": "https://example.com/produto/tenis-running-azul",
        "catalogId": catalog_id,
        "method": "web_scraper",
    }
)
job = response.json()
print(f"Job ID: {job['jobId']}")

Análise SERP para SEO

Use a API SERP do Bright Data para descobrir palavras-chave de alto valor para seus produtos. Os resultados são usados para otimizar títulos, descrições e campos meta durante a pontuação Gold.

curl -X POST "https://app.alana.shopping/api/workspace/WORKSPACE_ID/catalogs/CATALOG_ID/enrich/serp" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "productIds": ["prod_123", "prod_456"],
    "locale": "pt-BR"
  }'

const response = await fetch(
  `https://app.alana.shopping/api/workspace/${workspaceId}/catalogs/${catalogId}/enrich/serp`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      productIds: ['prod_123', 'prod_456'],
      locale: 'pt-BR',
    }),
  }
);

import requests

response = requests.post(
    f"https://app.alana.shopping/api/workspace/{workspace_id}/catalogs/{catalog_id}/enrich/serp",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "productIds": ["prod_123", "prod_456"],
        "locale": "pt-BR",
    }
)

Presets de datasets para análise competitiva

Os presets de datasets do Bright Data extraem dados estruturados de concorrentes por categorias como eletrônicos, roupas e produtos domésticos — úteis para comparar seu catálogo com os líderes de mercado. Presets disponíveis:

electronics_specs — especificações técnicas de grandes varejistas
apparel_sizing — tabelas de tamanho e dados de caimento
grocery_nutrition — informações nutricionais e ingredientes
home_goods_dimensions — dimensões físicas e materiais

Fluxo completo de enriquecimento

Boas práticas

Sempre execute o Silver antes do Gold

A pontuação Gold depende de dados normalizados. Executar Gold em dados Bronze brutos produz pontuações artificialmente baixas porque campos como marca e categoria ainda não estão vinculados.

Use enriquecimento SERP para produtos prioritários

A análise SERP tem um custo por consulta. Execute-a nos SKUs de maior tráfego ou novos lançamentos de produtos, não em catálogos inteiros.

Priorize lacunas por impacto na pontuação

A lista de lacunas é ordenada por impacto. Preencher a primeira lacuna aumentará mais a pontuação do que preencher a última. Foque nas 2–3 primeiras lacunas por produto.

Execute o Gold novamente após cada sessão de edição

As pontuações não são ao vivo — elas refletem a última vez que o Gold foi executado. Execute o Gold novamente após preencher lacunas para obter pontuações atualizadas.

Primeiros Passos

Conceitos Fundamentais

Guias

Visão geral

Passo 1 — Import (Bronze)

Métodos de import

Passo 2 — Silver (Normalizar)

Executar Silver via UI

Executar Silver via API

Resultados do Silver

Passo 3 — Gold (Pontuar & Analisar)

Executar Gold via UI

Executar Gold via API

Passo 4 — Revisar pontuações no Canvas

Passo 5 — Enriquecimento via Bright Data

Import por URL com web scraping

Análise SERP para SEO

Presets de datasets para análise competitiva

Fluxo completo de enriquecimento

Boas práticas

​Visão geral

​Passo 1 — Import (Bronze)

​Métodos de import

​Passo 2 — Silver (Normalizar)

​Executar Silver via UI

​Executar Silver via API

​Resultados do Silver

​Passo 3 — Gold (Pontuar & Analisar)

​Executar Gold via UI

​Executar Gold via API

​Passo 4 — Revisar pontuações no Canvas

​Passo 5 — Enriquecimento via Bright Data

​Import por URL com web scraping

​Análise SERP para SEO

​Presets de datasets para análise competitiva

​Fluxo completo de enriquecimento

​Boas práticas

Visão geral

Passo 1 — Import (Bronze)

Métodos de import

Passo 2 — Silver (Normalizar)

Executar Silver via UI

Executar Silver via API

Resultados do Silver

Passo 3 — Gold (Pontuar & Analisar)

Executar Gold via UI

Executar Gold via API

Passo 4 — Revisar pontuações no Canvas

Passo 5 — Enriquecimento via Bright Data

Import por URL com web scraping

Análise SERP para SEO

Presets de datasets para análise competitiva

Fluxo completo de enriquecimento

Boas práticas