Atualização em Massa do CMS

Crie ou atualize vários itens CMS com validação abrangente, aprovação granular e capacidade de reversão.

Aviso Importante

SEMPRE use as ferramentas MCP do Webflow para todas as operações:

Use data_sites_tool do Webflow MCP com ação list_sites para listar sites disponíveis
Use data_cms_tool do Webflow MCP com ação get_collection_list para listar coleções CMS
Use data_cms_tool do Webflow MCP com ação get_collection_details para buscar esquemas de coleção
Use data_cms_tool do Webflow MCP com ação list_collection_items para recuperar itens existentes
Use data_cms_tool do Webflow MCP com ação create_collection_items para criar itens (rascunho ou publicado)
Use data_cms_tool do Webflow MCP com ação update_collection_items para atualizar itens (rascunho ou publicado)
Use data_cms_tool do Webflow MCP com ação publish_collection_items para publicar itens como rascunho
Use webflow_guide_tool do Webflow MCP para obter melhores práticas antes de começar
NÃO use outras ferramentas ou métodos para operações do Webflow
Todas as chamadas de ferramenta devem incluir o parâmetro context obrigatório (15-25 palavras, perspectiva de terceira pessoa)

Instruções

Fase 1: Seleção de Site e Coleção

Obter site: Identifique o site alvo. Se o usuário não fornecer o ID do site, peça-o.
Listar coleções: Use data_cms_tool do Webflow MCP com ação get_collection_list para mostrar as coleções disponíveis
Pedir ao usuário para selecionar a coleção: O usuário especifica com qual coleção deseja trabalhar
Buscar esquema da coleção: Use data_cms_tool do Webflow MCP com ação get_collection_details para recuperar:
- Todas as definições de campo com tipos
- Campos obrigatórios vs opcionais
- Validações de campo (tamanho máximo, padrões, etc.)
- Alvos de campos de referência

Fase 2: Coleta e Análise de Dados

Perguntar tipo de operação: Esclareça o que o usuário deseja fazer:
- Criar apenas novos itens
- Atualizar apenas itens existentes
- Criar e atualizar
Receber dados do usuário: Aceite dados em formatos flexíveis:
- Formato estruturado (semelhante a JSON)
- Descrições em linguagem natural
- Dados no estilo CSV
- Listas com marcadores
Analisar e normalizar: Converta os dados do usuário em formato estruturado
Buscar itens existentes (se houver atualizações): Use data_cms_tool do Webflow MCP com ação list_collection_items para obter dados atuais

IMPORTANTE - Consulta Eficiente de Itens:
- Ao procurar itens específicos pelo nome, SEMPRE use o parâmetro name para filtrar (ex.: name: "Pikachu")
- Ao procurar por slug, use o parâmetro slug para filtrar
- NUNCA busque todos os itens primeiro e depois pesquise nos resultados – isso desperdiça chamadas de API e tokens
- Busque a lista completa apenas quando precisar exibir todos os itens ou não souber quais itens específicos serão alvo

Fase 3: Validação e Análise

Validar todos os dados:
- Nomes de campos: Verifique se todos os nomes de campo existem no esquema
- Campos obrigatórios: Garanta que todos os campos obrigatórios foram fornecidos
- Tipos de campo: Valide se os tipos de dados correspondem ao esquema
- Restrições: Verifique tamanhos máximos, padrões, valores permitidos
- Slugs: Garanta que os slugs são únicos e válidos
- Campos de referência: Verifique se os itens referenciados existem
Detectar conflitos:
- Slugs duplicados (dentro do lote ou com itens existentes)
- Campos obrigatórios ausentes
- Tipos de dados inválidos
- Violações de restrições
Analisar impacto:
- Contar criações vs atualizações
- Identificar quais campos serão alterados
- Calcular tamanho do lote e tempo de processamento

Fase 4: Visualização e Aprovação Granular

Gerar visualização detalhada:
- Mostrar cada item com status de validação
- Exibir avisos para problemas
- Para atualizações, mostrar diferenças (antigo → novo)
- Para criações, mostrar todos os valores dos campos
- Numerar cada item para aprovação seletiva
Apresentar opções de aprovação granular:
- Permitir que o usuário selecione itens específicos para processar
- Opções: "all", "none", números específicos, intervalos numéricos
- Mostrar tempo estimado de processamento
Oferecer opções de publicação:
- Publicar imediatamente (usar endpoints *_live)
- Criar como rascunho (usar endpoints regulares + publicação manual)

Fase 5: Execução e Relatório

Armazenar dados de reversão: Antes de qualquer alteração, salve:
- Valores originais de todos os itens atualizados
- Carimbo de data/hora
- Detalhes da operação
Processar em lotes:
- Máximo de 50 itens por lote
- Mostrar indicador de progresso
- Lidar com limites de taxa graciosamente
Executar operações: Use as ferramentas MCP apropriadas do Webflow com base na escolha do usuário
Lidar com erros graciosamente:
- Continuar processando em caso de falha de item único
- Rastrear sucessos e falhas separadamente
- Fornecer mensagens de erro detalhadas
Gerar relatório abrangente:
- Resumo (contagem de sucessos/falhas)
- Resultados detalhados por item
- IDs de itens criados/atualizados
- Detalhes de erros para itens com falha
Oferecer opção de reversão: Permitir que o usuário desfaça as alterações se necessário

Exemplos

Prompt do usuário:

Adicione 2 posts de blog sobre Webflow MCP e atualize o primeiro blog para dizer "Top" em vez de "Best"

Passo 1: Seleção de Site e Coleção

📋 Configuração de Atualização em Massa do CMS

Sites Disponíveis:
1. MCP Demo#1
2. MCP Demo#2
3. MCP Demo#3

Selecione um site (1-3):

Usuário seleciona: 1

Coleções Disponíveis em MCP Demo#1:
└── Blog Posts (9 itens)
    Campos: name, slug, post-body, post-summary, main-image, thumbnail-image, featured, color

Continuar com a coleção Blog Posts? (sim/não)

Usuário confirma: sim

Passo 2: Coleta de Dados

🔍 Esquema da Coleção: Blog Posts

Campos Obrigatórios:
- name (PlainText, máx. 256 caracteres)
- slug (PlainText, máx. 256 caracteres, apenas alfanumérico)

Campos Opcionais:
- post-body (RichText)
- post-summary (PlainText)
- main-image (Image)
- thumbnail-image (Image)
- featured (Switch, verdadeiro/falso)
- color (Color, formato hex)

Vou analisar sua solicitação:
- Criar 2 novos posts sobre Webflow MCP
- Atualizar o primeiro post: "Best" → "Top"

Gerando itens...

Passo 3: Validação e Visualização

📋 Visualização: Atualização em Massa do CMS

Coleção: Blog Posts
Operações: Criar 2 itens + Atualizar 1 item

---

### 🆕 Itens a Criar (2)

[1] ✓ NOVO POST
    name: "Webflow MCP: The Future of Web Development"
    slug: "webflow-mcp-future-web-development"
    post-summary: "Discover how Webflow MCP is revolutionizing..."
    post-body: "<h1>The Future is Here</h1><p>..."
    featured: true
    color: "#9B59B6"
    ✅ Todas as validações passaram

[2] ✓ NOVO POST
    name: "Why Webflow MCP Will Transform Your Workflow in 2026"
    slug: "webflow-mcp-transform-workflow-2026"
    post-summary: "Learn how Webflow MCP's integration..."
    post-body: "<h1>Transform Your Workflow</h1><p>..."
    featured: true
    color: "#3498DB"
    ✅ Todas as validações passaram

---

### ✏️ Itens a Atualizar (1)

[3] ✓ ATUALIZAR EXISTENTE
    ID do Item: 69615f84fc6ce1aa444d24d5
    Slug: why-webflow-is-best-2026-ai

    Alterações:
      name: "Why Webflow is the Best Choice for 2026" → "Why Webflow is the Top Choice for 2026"

    ✅ Todas as validações passaram

---

**Resumo:**
- ✅ 2 itens serão criados
- ✅ 1 item será atualizado
- ⚠️ 0 avisos
- ❌ 0 erros

**Opções de Publicação:**
1. Publicar imediatamente (recomendado)
2. Salvar como rascunho

Quais itens deseja processar?
- Digite "all" para processar todos os 3 itens
- Digite números para pular (ex.: "2" para pular o item 2)
- Digite "none" para cancelar

Selecione opção de publicação (1/2): _
Selecione itens: _

Usuário seleciona: 1, all

⚠️ Você está prestes a:
- Criar 2 novos posts de blog (publicados ao vivo)
- Atualizar 1 post de blog existente (alterações publicadas ao vivo)

Digite "confirm" para prosseguir.

Usuário confirma: confirm

Passo 4: Execução e Resultados

🔄 Processando atualização em massa...

Criando itens: ██████████ 100% (2/2)
Atualizando itens: ██████████ 100% (1/1)

✅ Atualização em Massa do CMS Concluída!

---

### 🆕 Itens Criados (2)

✓ [1] "Webflow MCP: The Future of Web Development"
      ID: 6961640c66de07bed9aacf3e
      Slug: webflow-mcp-future-web-development
      Publicado: 9 de janeiro de 2026, 20:24

✓ [2] "Why Webflow MCP Will Transform Your Workflow in 2026"
      ID: 6961640c66de07bed9aacf41
      Slug: webflow-mcp-transform-workflow-2026
      Publicado: 9 de janeiro de 2026, 20:24

---

### ✏️ Itens Atualizados (1)

✓ [3] "Why Webflow is the Top Choice for 2026"
      ID: 69615f84fc6ce1aa444d24d5
      Alterado: título atualizado
      Publicado: 9 de janeiro de 2026, 20:24

---

**Resumo:**
- ✅ 2 itens criados com sucesso
- ✅ 1 item atualizado com sucesso
- ❌ 0 falhas
- ⏱️ Concluído em 3,2 segundos

**Total de Itens:** 11 (era 9)

📋 Reversão Disponível:
Última atualização: 3 itens modificados agora
Digite "undo" em 5 minutos para reverter todas as alterações

Alternativa: Com Avisos de Validação

📋 Visualização: Atualização em Massa do CMS

[1] ⚠️ NOVO POST
    name: "Test Post"
    slug: "test"
    post-summary: "Hi"
    ⚠️ Aviso: post-summary muito curto (< 20 caracteres) – pode afetar o SEO
    ⚠️ Aviso: slug muito genérico – considere um slug mais descritivo
    ⚠️ Aviso: post-body ausente – o conteúdo ficará vazio
    ✅ Campos obrigatórios presentes (pode prosseguir)

[2] ❌ NOVO POST
    name: "Another Post!!!"
    slug: "another post"
    ❌ Erro: slug contém espaços (deve ser alfanumérico apenas com hífens)
    ❌ Erro: name contém caracteres especiais não permitidos
    🔴 Não pode prosseguir – corrija os erros primeiro

---

**Resumo:**
- ✅ 1 item pode ser criado (com avisos)
- ❌ 1 item tem erros (não pode ser criado)

Corrigir item 2 ou pular? (corrigir/pular)

Diretrizes

Fase 1: Requisitos Críticos

Seleção de Site e Coleção:

Sempre busque a lista real de sites usando data_sites_tool com ação list_sites
Nunca assuma IDs de sites
Mostre nomes de coleções e contagens de itens
Exiba o esquema de campos antes de aceitar dados
Confirme a seleção da coleção com o usuário

Fase 2: Análise de Dados

Formatos de Entrada Flexíveis: Aceite dados em vários formatos:

Estruturado (semelhante a JSON):

CRIAR:
- name: "Título do Post"
  slug: "slug-do-post"
  featured: true

Linguagem Natural:

"Adicione um post de blog chamado 'Getting Started' com slug 'getting-started'"

Estilo CSV:

name,slug,featured
"Post 1","post-1",true
"Post 2","post-2",false

Listas com Marcadores:

- Post 1: "Título" (slug: slug-do-titulo)
- Post 2: "Outro" (slug: outro-slug)

Regras de Análise:

Seja tolerante com variações de formato
Infira campos opcionais ausentes
Peça esclarecimentos se ambíguo
Nunca assuma valores de campos obrigatórios

Consulta Eficiente de Itens: Ao buscar itens existentes para atualizações, use parâmetros de filtro para minimizar chamadas de API:

# Bom - Filtrar por nome quando você sabe o nome do item
data_cms_tool(action: "list_collection_items", collection_id, name: "Pikachu")

# Bom - Filtrar por slug quando você sabe o slug
data_cms_tool(action: "list_collection_items", collection_id, slug: "pikachu")

# Ruim - Buscar todos os itens e depois pesquisar nos resultados
data_cms_tool(action: "list_collection_items", collection_id)  # Retorna 100 itens
# Depois pesquisar manualmente por "Pikachu" nos resultados...

SEMPRE use os parâmetros name ou slug ao pesquisar itens específicos
Isso reduz chamadas de API, tamanho da resposta e uso de tokens
Busque listas sem filtro apenas ao exibir todos os itens ou quando o alvo for desconhecido

Fase 3: Regras de Validação

Validação de Nome de Campo:

Verifique se todos os nomes de campo existem no esquema
Correspondência diferencia maiúsculas de minúsculas
Sugira correções para erros de digitação
Exemplo: "autor" → Você quis dizer "author"?

Campos Obrigatórios:

name e slug são SEMPRE obrigatórios para o CMS do Webflow
Verifique campos obrigatórios específicos da coleção a partir do esquema
Liste claramente todos os campos obrigatórios ausentes
Não é possível prosseguir se campos obrigatórios estiverem ausentes

Validação de Tipo de Campo:

PlainText:

Verifique restrições de tamanho máximo
Valide padrões se especificados
HTML não permitido

RichText:

Deve ser HTML válido
Verifique tags não fechadas
Permita elementos HTML comuns

Image/File:

Aceite IDs de arquivo ou URLs
Valide se o arquivo existe (se possível)
Texto alternativo opcional

Switch (Booleano):

Aceite: true/false, sim/não, 1/0
Normalize para booleano

Color:

Deve estar no formato hex (#RRGGBB)
Valide caracteres hexadecimais
Exemplo: #FF5733 ✓, red ✗

Campos de Referência:

Devem referenciar IDs de itens existentes
Valide se os itens referenciados existem
Mostre nomes dos itens referenciados para clareza

Validação de Slug:

CRÍTICO: Deve ser alfanumérico apenas com hífens
Sem espaços, sublinhados ou caracteres especiais
Máximo de 256 caracteres
Deve ser único (verifique existentes + lote)
Sugira slugs automaticamente a partir de títulos se ausentes
Exemplo:
- ❌ "Meu Post!" → ⚠️ Contém caracteres especiais
- ✅ "meu-post" → Válido

Validação de Restrições:

Tamanho máximo: Avise se próximo do limite, erro se exceder
Padrões: Teste expressões regulares do esquema
Valores permitidos: Verifique opções enumeradas

Fase 4: Visualização e Aprovação

Formato da Visualização:

Para Operações de Criação:

[1] ✓ NOVO POST
    field1: "valor1"
    field2: "valor2"
    field3: "valor3"
    ✅ Todas as validações passaram

Para Operações de Atualização:

[2] ✓ ATUALIZAR EXISTENTE
    ID do Item: xxx
    Slug: slug-existente

    Alterações:
      campo1: "valor antigo" → "valor novo"
      campo2: (sem alteração)
      campo3: "antigo" → "novo"

    ✅ Todas as validações passaram

Para Itens com Avisos:

[3] ⚠️ NOVO POST
    name: "Título"
    ⚠️ Aviso: Campo opcional 'post-body' ausente
    ⚠️ Aviso: Slug pode ser muito genérico
    ✅ Pode prosseguir (apenas avisos)

Para Itens com Erros:

[4] ❌ NOVO POST
    name: "Título!!!"
    slug: "slug ruim"
    ❌ Erro: slug contém espaços
    ❌ Erro: name tem caracteres especiais
    🔴 Não pode prosseguir – corrija os erros

Aprovação Granular:

Numere cada item: [1], [2], [3]...
Permita processamento seletivo
Aceite formatos:
- "all" - processar tudo
- "none" - cancelar operação
- "1,3,5" - processar itens 1, 3 e 5
- "1-5" - processar itens 1 a 5
- "2" - pular apenas o item 2, processar o restante

Opções de Publicação:

Publicação imediata: Use endpoints *_live (recomendado)
Modo rascunho: Use endpoints regulares + publicação manual

Fase 5: Execução e Relatório

Processamento em Lotes:

Lotes de no máximo 50 itens
Mostre barra de progresso
Lide com limites de taxa com espera e repetição

Tratamento de Erros:

Continue processando se um item falhar
Registre falhas separadamente
Forneça mensagens de erro detalhadas

Relatório Abrangente:

Resumo com contagens
Resultados detalhados por item
IDs de itens criados/atualizados
Detalhes de erros

Opção de Reversão:

Salve dados de reversão antes de qualquer alteração
Ofereça "undo" após a conclusão
Defina um limite de tempo para reversão (ex.: 5 minutos)

webflow/webflow-skills

O que é webflow-skills?

Perguntar na sua IA favorita

Documentação

Atualização em Massa do CMS

Aviso Importante

Instruções

Fase 1: Seleção de Site e Coleção

Fase 2: Coleta e Análise de Dados

Fase 3: Validação e Análise

Fase 4: Visualização e Aprovação Granular

Fase 5: Execução e Relatório

Exemplos

Diretrizes

Fase 1: Requisitos Críticos

Fase 2: Análise de Dados

Fase 3: Regras de Validação

Fase 4: Visualização e Aprovação

Fase 5: Execução e Relatório

Individual skills in this repo