Catalog Intelligence Agent

Agente MCP de enriquecimento autônomo de catálogo para STOREFRONTS (lojas próprias). Trilha Catalog & Content — Hackathon Agents for Commerce (Deco, 01–09/08/2026).

Recebe dados brutos de ERP (título em CAIXA ALTA, sem descrição, marca genérica, sem imagem) e devolve o produto pronto para publicar na loja própria do lojista — com título SEO, bullets de benefícios, descrição HTML mobile-first, slug/meta, schema.org JSON-LD e imagem.

Não é integrador de marketplace: foca no motor central de higienização que qualquer storefront (deco.cx, VTEX, Shopify, Nuvemshop…) consome via um agente de IA.

Ferramentas MCP (5)

Related MCP server: VitaFlow Shopify MCP

Impacto financeiro (pitch)

• Operação de 5.000 SKUs gasta ~200 h/mês de equipe de catálogo → R$ 5.000/mês em horas (R$25/h)

• Concorrência (PIMs + IA): US$600–1.000/mês para 500 SKUs — nosso custo ≈ R$0–50/lote

• Demo inteira roda em free tiers (~R$0)

Execução

npm install
npm run build        # tsc → dist/
npm run dev          # modo dev (tsx watch) — MCP server stdio
npm start            # node dist/server.js — MCP server stdio
npm test             # testes unitários (9): EAN, validate, schema
npm run smoke        # smoke end-to-end do protocolo MCP (6 checks, stdio)

Conectar em um cliente MCP

Claude Desktop / Cursor / CLI:

{ "mcpServers": { "catalog-intelligence": { "command": "node", "args": ["/caminho/para/dist/server.js"] } } }

deco Studio (Custom Connection): rode o servidor HTTP e aponte a Connection para o endpoint:

PORT=8788 node dist/http.js     # Streamable HTTP em http://localhost:8788/mcp

No Studio: Agent → Settings → Connections → Add Connection → Custom Connection → cole a URL → selecione as tools do agente.

Teste com MCP Inspector

npx @modelcontextprotocol/inspector node dist/server.js

Exemplo

Entrada (ERP):

{ "ean": "7891234567890", "title": "FURADEIRA IMPACTO 750W 110V", "brand": "SEM MARCA" }

Saída (storefront):

{
  "title": "Furadeira de Impacto 750W 110V",
  "slug": "furadeira-de-impacto-750w-110v",
  "meta_title": "Furadeira de Impacto 750W 110V — Compre Online",
  "bullets": ["✅ Potência de 750W...", "✅ Mandril 13mm...", "✅ Ideal para uso doméstico e profissional..."],
  "description_html": "<p>Furadeira de impacto profissional...</p>",
  "seo_keywords": ["furadeira", "furadeira de impacto", "750w"],
  "schema_org": { "@type": "Product", "name": "Furadeira de Impacto 750W 110V", "sku": "7891234567890", "brand": {"@type":"Brand","name":"..."} },
  "image_url": "https://...",
  "warnings": []
}

Stack

• TypeScript ESM (Node 22+)

• @modelcontextprotocol/sdk (MCP) + zod (schemas)

• Transportes: stdio (dev) + Streamable HTTP (deco Studio)

• IA: qualquer endpoint OpenAI-compatível via env (AI_ENDPOINT, AI_MODEL, AI_API_KEY) — sem key, o agente funciona 100% determinístico

• Zero dependências proprietárias — sem regras de marketplace, sem pricing engine

Env vars

Integração com deco Studio

O servidor é um MCP server padrão — pluga como Connection customizada no Studio (control plane de agentes da Deco). A demo mostra o agente rodando dentro do Studio: conectar → chamar enrich_product → ver trace/custo no Monitor.

Author

Carlos Nunes — ClickPim (consultor Amazon BR / automação de catálogo). Submissão individual, hackathon Agents for Commerce — trilha Catalog & Content.