Busca dados de referência de um produto pelo código EAN/GTIN. Fontes: (1) Open Food Facts (alimentos), (2) busca web (DuckDuckGo) quando o EAN não está nas bases — comum em moda/marca própria BR. IMPORTANTE: a busca web prioriza o EAN NU (mostra o que o código realmente é); product_hint é opcional e só usado como segunda query de validação, NUNCA para sobrepor o resultado do EAN. Retorna candidates com título/URL reais para o lojista validar — o agente NUNCA deve afirmar que um candidato É o produto sem confirmação do lojista.

Busca imagens candidatas de um produto por EAN/GTIN. Retorna até N URLs de imagem com fonte e score. Usa Open Food Facts (sem key) e URLs já informadas no ERP.

Pipeline completo de enriquecimento: higieniza título (Title Case, remove ruído), gera bullets de benefícios, descrição HTML mobile-first, SEO (slug/meta/keywords), schema.org JSON-LD, busca imagem por EAN e normaliza atributos. Entrada = produto bruto de ERP; IMPORTANTE: com with_images=false (padrão) o output NÃO embute a imagem em base64 — a image_url vem como URL simples e o JSON fica leve para o agente ler. Use with_images=true somente se precisar da imagem processada inline (cuidado: base64 deixa o output com 100k+ tokens). saída = produto pronto para a loja própria (storefront).

Valida a completeza de um produto/listing para publicação em storefront: título, descrição, imagem, atributos obrigatórios, schema.org JSON-LD e SEO on-page. Retorna score 0-100, lista de issues (error/warning) e pronto-para-publicar (score >= 70).

Orquestrador de lote: aplica o pipeline de enriquecimento a uma lista de produtos brutos, um a um, e devolve relatório consolidado (produtos enriquecidos, falhas, warnings) pronto para importação na storefront.

Raspa e diagnostica a página de um produto na loja própria do cliente (storefront). Extrai título, preço, descrição, imagem, marca, schema.org e EAN; retorna um diagnóstico de prontidão por seção. Ideal para: o lojista cola o link do produto e o agente audita.

Analisa a imagem de um produto (por URL): resolução, proporção, fundo, nitidez e prontidão para a loja. IMPORTANTE: use o campo human_summary na resposta ao lojista — os demais campos (width, height, mean_rgb, border_stddev, sharpness, aspect_ratio) são DIAGNÓSTICO INTERNO e NUNCA devem ser descritos a humanos. Nunca cite valores RGB, pixels ou desvio-padrão em texto destinado ao cliente.

Baixa as imagens de um produto para EXIBIÇÃO no chat. Aceita: (a) URL da página (raspa e baixa todas as imagens do produto), ou (b) lista direta de URLs. Retorna data-URLs (renderizáveis no markdown) + caminhos locais.

Converte um produto enriquecido (saída de enrich_product) no payload pronto da Shopify Admin GraphQL (productCreate) para PUBLICAÇÃO AUTOMÁTICA na loja, sem copiar/colar. Retorna a query GraphQL e o payload JSON com title, descriptionHtml, handle, vendor, tags (SEO), metafields (gtin, meta_title, meta_description) e imagem.

Extrai texto de um PRINT/foto da página de produto (tesseract OCR, pt-BR). Ideal quando o lojista manda um print da loja própria ou do concorrente em vez de link: o agente lê o título, preço e marca direto da imagem.