Automação Prismic

Gerencie seu CMS headless Prismic diretamente do Claude Code. Consulte documentos por tipo, pesquise conteúdo por texto completo, inspecione tipos personalizados e trabalhe com referências de repositório para versionamento de conteúdo.

Documentação do Toolkit: composio.dev/toolkits/prismic

Configuração

1. Adicione o servidor Composio MCP à sua configuração:

   https://rube.app/mcp
   

2. Conecte sua conta Prismic quando solicitado. O agente fornecerá um link de autenticação.
3. A maioria das consultas de conteúdo requer um token ref. Sempre comece chamando PRISMIC_REPOSITORY_API_GET_REFS ou PRISMIC_REPOSITORY_API_GET_INFO para obter a referência principal (master ref).

Fluxos de Trabalho Principais

1. Obter Informações e Referências do Repositório

Recupere metadados abrangentes do repositório, incluindo referências disponíveis (versões de conteúdo), tipos personalizados, idiomas, tags e marcadores. Esta é tipicamente sua primeira chamada de API.

Ferramentas: PRISMIC_REPOSITORY_API_GET_INFO, PRISMIC_REPOSITORY_API_GET_REFS

Nenhum parâmetro é necessário -- esses endpoints retornam a configuração completa do repositório. O campo refs é crucial, pois as referências são necessárias para todas as consultas de conteúdo.

Exemplo de prompt: "Obtenha as informações do meu repositório Prismic e a referência principal (master ref) atual"

2. Consultar Documentos com Predicados

Busque documentos usando a sintaxe de consulta de predicados do Prismic com suporte completo de paginação e filtragem.

Ferramenta: PRISMIC_CONTENT_API_QUERY_DOCUMENTS

Parâmetros principais:

• ref (obrigatório) -- ID da referência de lançamento de conteúdo (geralmente a referência principal)
• q -- consulta de predicado, por exemplo, [[at(document.type, "page")]]
• page (mínimo 1) e pageSize (1-100) -- paginação
• lang -- código do idioma, por exemplo, en-us (padrão * para todos)
• orderings -- ordem de classificação, por exemplo, [my.article.date desc]
• fetch -- campos separados por vírgula a serem buscados, reduzindo o tamanho da resposta
• fetchLinks -- resolve campos de documentos vinculados inline

Exemplo de prompt: "Consulte todos os posts de blog publicados no Prismic, ordenados por data decrescente, em inglês"

3. Buscar Documentos por Tipo

Recupere todos os documentos de um tipo personalizado específico com resolução automática da referência principal (master ref).

Ferramenta: PRISMIC_GET_DOCUMENTS_BY_TYPE

Parâmetros principais:

• type (obrigatório) -- ID da API do tipo personalizado, por exemplo, blog_post, article, page
• page (padrão 1) e pageSize (1-100, padrão 20)
• lang -- filtro de código de idioma
• orderings -- ordem de classificação, por exemplo, [my.article.date desc]
• after -- paginação baseada em cursor para paginação profunda além da página 50

Exemplo de prompt: "Obtenha todos os documentos do tipo blog_post no Prismic, 20 por página"

4. Pesquisa de Texto Completo

Pesquise em todos os campos de texto nos documentos por termos especificados. Não diferencia maiúsculas de minúsculas, corresponde a palavras raiz.

Ferramenta: PRISMIC_CONTENT_API_GET_DOCUMENTS_WITH_FULLTEXT_SEARCH

Parâmetros principais:

• q (obrigatório) -- predicado de texto completo, por exemplo, [[fulltext(document, "machine learning")]]
• page, pageSize, lang, orderings -- mesma paginação/filtragem de outras consultas

Exemplo de prompt: "Pesquise todos os documentos do Prismic por 'machine learning'"

5. Obter um Único Documento por ID

Recupere um documento específico por seu identificador exclusivo.

Ferramenta: PRISMIC_GET_DOCUMENT_BY_ID

Parâmetros principais:

• document_id (obrigatório) -- identificador exclusivo do documento
• ref (obrigatório) -- referência de conteúdo do repositório
• lang -- filtro de idioma opcional

Exemplo de prompt: "Busque o documento Prismic Xx2KLhEAAJljVWaA"

6. Listar Tipos Personalizados

Descubra todos os tipos personalizados (modelos de conteúdo) definidos no repositório, incluindo suas definições de estrutura.

Ferramenta: PRISMIC_TYPES_API_GET_TYPES

Parâmetros principais:

• limit -- número máximo de tipos a serem retornados por página
• page -- número da página (baseado em 1)
• sort -- ordem de classificação, por exemplo, name

Exemplo de prompt: "Liste todos os tipos personalizados no meu repositório Prismic"

Armadilhas Conhecidas

• Referência é necessária para todas as consultas de conteúdo: Você deve obter uma ref válida (geralmente a referência principal) de PRISMIC_REPOSITORY_API_GET_REFS ou PRISMIC_REPOSITORY_API_GET_INFO antes de consultar qualquer documento. Consultas sem uma referência falharão.
• Sintaxe de predicado requer colchetes duplos: Consultas Prismic usam colchetes quadrados duplos: [[at(document.type, "page")]]. Para múltiplos predicados, combine-os: [[at(document.type, "blog")][at(document.tags, ["featured"])]].
• Limite de paginação profunda: A paginação padrão baseada em página pode falhar além da página 50. Para paginação profunda, use o parâmetro after com o ID do último documento do seu conjunto de resultados anterior.

…