ComposioHQ/Prismic-Automation

Automação Prismic

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

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

---

Configuração

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

   https://rube.app/mcp
   

2. Conecte sua conta do 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 ref principal.

---

Fluxos de Trabalho Principais

1. Obter Informações do Repositório e Refs

Recupere metadados abrangentes do repositório, incluindo refs disponíveis (versões de conteúdo), tipos personalizados, idiomas, tags e favoritos. 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 é crítico, pois refs são obrigatórias para todas as consultas de conteúdo.

Exemplo de prompt: "Obtenha as informações do meu repositório Prismic e a ref principal atual"

---

2. Consultar Documentos com Predicados

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

Ferramenta: PRISMIC_CONTENT_API_QUERY_DOCUMENTS

Parâmetros principais:

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

Exemplo de prompt: "Consulte todas as postagens de blog publicadas no Prismic, ordenadas 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 ref principal.

Ferramenta: PRISMIC_GET_DOCUMENTS_BY_TYPE

Parâmetros principais:

• type (obrigatório) — ID da API do tipo personalizado, ex.: 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, ex.: [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 blog_post no Prismic, 20 por página"

---

4. Busca em Texto Completo

Pesquise em todos os campos de texto dos documentos por termos especificados. Sem distinção entre maiúsculas e 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, ex.: [[fulltext(document, "machine learning")]]
• page, pageSize, lang, orderings — mesma paginação/filtragem de outras consultas

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

---

5. Obter um Único Documento por ID

Recupere um documento específico pelo seu identificador único.

Ferramenta: PRISMIC_GET_DOCUMENT_BY_ID

Parâmetros principais:

• document_id (obrigatório) — identificador único do documento
• ref (obrigatório) — ref 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 retornar por página
• page — número da página (baseado em 1)
• sort — ordem de classificação, ex.: name

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

---

Armadilhas Conhecidas

• Ref é obrigatória para todas as consultas de conteúdo: Você deve obter uma ref válida (normalmente a ref principal) de PRISMIC_REPOSITORY_API_GET_REFS ou PRISMIC_REPOSITORY_API_GET_INFO antes de consultar qualquer documento. Consultas sem ref falharão.
• Sintaxe de predicado requer colchetes duplos: Consultas do Prismic usam colchetes 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 baseada em página padrão 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.
• Limite de pageSize é 100: Solicitar mais de 100 documentos por página será rejeitado. Use paginação para iterar por conjuntos de resultados maiores.
• Filtragem de idioma: O filtro de idioma padrão é * (todos os idiomas). Se precisar de documentos em uma localidade específica, sempre passe lang explicitamente (ex.: en-us, fr-fr).
• Campos de integração exigem ref separada: Ao usar PRISMIC_CONTENT_API_GET_DOCUMENTS_WITH_INTEGRATION_FIELDS, você precisa de um integrationFieldsRef além da ref de conteúdo padrão.

---

Referência Rápida

Slug da Ferramenta	Descrição
PRISMIC_REPOSITORY_API_GET_INFO	Obter metadados do repositório, refs, tipos, idiomas
PRISMIC_REPOSITORY_API_GET_REFS	Listar todas as refs (principal + versões)
PRISMIC_TYPES_API_GET_TYPES	Listar todos os tipos personalizados / modelos de conteúdo
PRISMIC_CONTENT_API_QUERY_DOCUMENTS	Consultar documentos com predicados e paginação
PRISMIC_GET_DOCUMENTS_BY_TYPE	Buscar documentos filtrados por tipo personalizado
PRISMIC_GET_DOCUMENT_BY_ID	Recuperar um único documento por ID
PRISMIC_CONTENT_API_GET_DOCUMENTS_WITH_FULLTEXT_SEARCH	Busca em texto completo em todos os documentos
PRISMIC_CONTENT_API_GET_DOCUMENTS_WITH_PREDICATES	Filtrar documentos com múltiplas condições de predicado
PRISMIC_CONTENT_API_GET_DOCUMENTS_WITH_INTEGRATION_FIELDS	Buscar documentos com dados de campos de integração
PRISMIC_GET_DOCUMENTS_ORDERED	Buscar documentos ordenados por campos especificados

---

Fornecido por Composio