schema-markup
Schema Markup — Skill especializada para schema markup
- License 许可
- MIT
- 最近更新
- 2026-08-01
- Stars
- ★ 2
- Forks
- 0
01 前言 Front Matter
- name
- schema-markup
- risk
- safe
- license
- MIT
- metadata
- { "author": "Cafe Code AI", "updated": 1772323200000, "version": "1.0.0", "category": "05-seo-busca" }
- description
- Schema Markup — Skill especializada para schema markup
03 SKILL.md 正文
Schema Markup
Esta skill capacita o Claude a gerar, validar e otimizar implementações de Schema Markup para melhorar a visibilidade em resultados de busca enriquecidos.
Keywords
- Schema.org
- JSON-LD
- Rich Snippets
- Structured Data
- Google Search Console
- Validação Schema
- SEO Técnico
- Microdata
- RDFa
- Knowledge Graph
- Product Schema
- Article Schema
- FAQPage Schema
Quick Start
- Identifique o tipo de conteúdo: Determine qual tipo de Schema.org melhor descreve a página (e.g.,
Article,Product,LocalBusiness). - Gere JSON-LD inicial: Utilize um gerador como o Merkle Schema Markup Generator para criar o código JSON-LD básico para o tipo de conteúdo escolhido.
- Insira o código na página: Adicione o script JSON-LD dentro da seção
<head>ou<body>do HTML da página. - Valide com a ferramenta do Google: Teste o URL da página no Google Rich Results Test para verificar erros e pré-visualizar os rich snippets.
- Monitore no Search Console: Acompanhe o desempenho e a cobertura dos rich snippets na seção "Aprimoramentos" do Google Search Console.
Core Workflows
Workflow 1: Implementação de Schema.org para Artigo (Article)
Este workflow descreve a criação e inserção de Schema Markup Article para um post de blog, otimizando-o para exibir rich snippets de notícias ou artigos.
- Selecione o tipo
Article: Para posts de blog, artigos de notícias ou publicações editoriais,Article(ou sub-tipos comoNewsArticleouBlogPosting) é o mais adequado. - Identifique as propriedades essenciais: Um
Articlebásico requerheadline,image,datePublished,dateModified,author(comnameeurl),publisher(comnameelogo).headline: Título principal do artigo, por exemplo, "Guia Completo de Schema Markup para SEO".image: URL de uma imagem representativa do artigo (mínimo 696px de largura), por exemplo, "https://www.exemplo.com.br/imagens/schema-markup-guia.jpg".datePublished: Data de publicação no formato ISO 8601, por exemplo, "2023-10-27T08:00:00+03:00".dateModified: Data da última modificação, se houver, no mesmo formato. Se não houver, pode ser igual adatePublished.author: Um objetoPersonouOrganizationcomname("João Silva") eurl("https://www.exemplo.com.br/autores/joao-silva").publisher: Um objetoOrganizationcomname("Exemplo Blog") elogo(URL da imagem do logo da organização, por exemplo, "https://www.exemplo.com.br/imagens/logo-exemplo.png").
- Gere o JSON-LD: Crie o script JSON-LD com as propriedades identificadas.
<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Article", "headline": "Guia Completo de Schema Markup para SEO", "image": [ "https://www.exemplo.com.br/imagens/schema-markup-guia.jpg" ], "datePublished": "2023-10-27T08:00:00+03:00", "dateModified": "2023-10-27T10:30:00+03:00", "author": { "@type": "Person", "name": "João Silva", "url": "https://www.exemplo.com.br/autores/joao-silva" }, "publisher": { "@type": "Organization", "name": "Exemplo Blog", "logo": { "@type": "ImageObject", "url": "https://www.exemplo.com.br/imagens/logo-exemplo.png" } }, "description": "Aprenda a implementar e otimizar Schema Markup para melhorar a visibilidade de seus artigos nos resultados de busca." } </script> - Incorpore na página: Adicione o bloco
<script>gerado na seção<head>do HTML da página do artigo. - Valide e monitore: Utilize o Google Rich Results Test para verificar a validade e o Google Search Console para monitorar a performance e identificar possíveis erros de rastreamento ou interpretação.
Workflow 2: Otimização de Schema para Produtos (Product) com Reviews
Este workflow detalha a implementação de Schema Markup Product para uma página de produto de e-commerce, incluindo informações de preço, disponibilidade e avaliações agregadas.
- Selecione o tipo
Product: Para páginas de produtos de e-commerce, utilize o tipoProduct. - Identifique as propriedades essenciais para e-commerce:
name: Nome do produto, por exemplo, "Smartphone X Pro 128GB".image: URLs das imagens do produto, por exemplo, "https://www.loja.com/imagens/smxpro_frente.jpg".description: Descrição breve do produto.skuempn: Códigos de identificação do produto (Stock Keeping Unit, Manufacturer Part Number).brand: Marca do produto, por exemplo, "TechBrand".offers: Um objetoOfferque incluipriceCurrency("BRL"),price("2999.99"),itemCondition(NewCondition),availability(InStockouOutOfStock), eurl(URL da página do produto).aggregateRating: Um objetoAggregateRatingpara avaliações, incluindoratingValue(média das avaliações, e.g., "4.7"),reviewCount(número total de avaliações, e.g., "125").
- Gere o JSON-LD: Crie o script JSON-LD com as propriedades identificadas.
<script type="application/ld+json"> { "@context": "https://schema.org/", "@type": "Product", "name": "Smartphone X Pro 128GB", "image": [ "https://www.loja.com/imagens/smxpro_frente.jpg", "https://www.loja.com/imagens/smxpro_traseira.jpg" ], "description": "O Smartphone X Pro oferece desempenho superior com câmera de 108MP e tela OLED.", "sku": "SMXPRO-128GB-BR", "mpn": "TECH-XPRO-128", "brand": { "@type": "Brand", "name": "TechBrand" }, "offers": { "@type": "Offer", "url": "https://www.loja.com/produto/smartphone-x-pro", "priceCurrency": "BRL", "price": "2999.99", "itemCondition": "https://schema.org/NewCondition", "availability": "https://schema.org/InStock", "seller": { "@type": "Organization", "name": "Minha Loja Online" } }, "aggregateRating": { "@type": "AggregateRating", "ratingValue": "4.7", "reviewCount": "125" }, "review": [ { "@type": "Review", "reviewRating": { "@type": "Rating", "ratingValue": "5" }, "author": { "@type": "Person", "name": "Ana Paula" }, "reviewBody": "Adorei o celular, câmera excelente e bateria dura muito!" } ] } </script> - Incorpore na página: Insira o JSON-LD dentro da seção
<head>ou<body>da página do produto. - Valide e monitore: Use o Google Rich Results Test para garantir que os rich snippets de produto e avaliação sejam detectados corretamente. Acompanhe os relatórios de "Produto" e "Snippets de Avaliação" no Google Search Console.
Templates
JSON-LD para Evento (Event)
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Event",
"name": "Conferência de Marketing Digital 2024",
"startDate": "2024-05-15T09:00",
"endDate": "2024-05-17T18:00",
"eventStatus": "https://schema.org/EventScheduled",
"eventAttendanceMode": "https://schema.org/OfflineEventAttendanceMode",
"location": {
"@type": "Place",
"name": "Centro de Convenções São Paulo",
"address": {
"@type": "PostalAddress",
"streetAddress": "Rua das Flores, 123",
"addressLocality": "São Paulo",
"addressRegion": "SP",
"postalCode": "01000-000",
"addressCountry": "BR"
}
},
"image": [
"https://www.conferencia-marketing.com.br/imagens/banner-conferencia.jpg",
"https://www.conferencia-marketing.com.br/imagens/logo-evento.png"
],
"description": "A maior conferência de marketing digital do Brasil, com palestrantes renomados e workshops práticos.",
"offers": {
"@type": "Offer",
"url": "https://www.conferencia-marketing.com.br/ingressos",
"price": "599.00",
"priceCurrency": "BRL",
"availability": "https://schema.org/InStock",
"validFrom": "2023-11-01T00:00"
},
"organizer": {
"@type": "Organization",
"name": "Agência Marketing Pro",
"url": "https://www.agenciamarketingpro.com.br"
}
}
</script>
JSON-LD para Perguntas Frequentes (FAQPage)
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [{
"@type": "Question",
"name": "O que é Schema Markup?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Schema Markup é um vocabulário de microdados que você pode adicionar ao seu HTML para ajudar os motores de busca a entender melhor o conteúdo das suas páginas. Isso pode levar a rich snippets nos resultados de busca."
}
},{
"@type": "Question",
"name": "Como implemento Schema Markup no meu site?",
"acceptedAnswer": {
"@type": "Answer",
"text": "A forma mais recomendada é utilizando JSON-LD (JavaScript Object Notation for Linked Data). Você insere um bloco de código JavaScript com a estrutura de dados na seção <head> ou <body> da sua página."
}
},{
"@type": "Question",
"name": "Quais são os benefícios de usar Schema Markup?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Os principais benefícios incluem maior visibilidade nos resultados de busca através de rich snippets (estrelas de avaliação, preços, horários de evento), aumento da taxa de cliques (CTR) e uma melhor compreensão do seu conteúdo pelos motores de busca."
}
}]
}
</script>
Checklist
- [x] O tipo de Schema Markup (
@type) corresponde ao conteúdo principal da página (e.g.,Productpara produto,Articlepara blog post). - [x] Todas as propriedades obrigatórias para o
@typeselecionado estão preenchidas. - [x] Todas as propriedades recomendadas foram consideradas e, se aplicável, preenchidas.
- [x] Os dados no Schema Markup refletem exatamente o conteúdo visível na página (não oculto ou desatualizado).
- [x] O JSON-LD está sintaticamente correto (sem erros de vírgula, chaves, aspas).
- [x] O Schema Markup foi validado usando o Google Rich Results Test e não apresenta erros críticos.
- [x] O site está implementando Schema Markup para tipos de conteúdo que geram rich snippets valiosos para o negócio (e.g., Product, Review, Event, FAQPage).
- [x] O desempenho dos rich snippets está sendo monitorado no Google Search Console (seção "Aprimoramentos").
- [x] Imagens referenciadas no Schema (e.g.,
image,logo) têm as dimensões mínimas recomendadas pelo Google. - [x] URLs dentro do Schema Markup são canônicas e acessíveis.
Métricas de Referência
| Métrica | Benchmark (Média) | Meta (Otimizado) |
|---|---|---|
| CTR (com rich snippets) | 5% - 8% | 10% - 15% |
| Impressões (com rich snippets) | > 20% das impressões totais | > 40% das impressões totais |
| Rich Results Coverage (Search Console) | > 80% das páginas elegíveis | > 95% das páginas elegíveis |
| Validação de Schema (erros) | 0.5% - 1% de erros | 0% de erros |
| Posição Média (rich snippets) | Posições 1-3 | Posições 1-2 |
Erros Comuns
- Dados Inconsistentes: O Schema Markup apresenta informações diferentes do conteúdo visível na página.
- Como evitar: Sempre garanta que os dados no JSON-LD (preço, nome do produto, avaliação, etc.) correspondam exatamente ao que o usuário vê na página. Por exemplo, se o preço no Schema é R$100, mas na página é R$90, isso é um erro. Use dados dinâmicos do CMS/e-commerce para preencher o Schema.
- Propriedades Obrigatórias Faltando: Um tipo de Schema.org requer certas propriedades que não são preenchidas, resultando em rich snippets inválidos.
- Como evitar: Consulte a documentação oficial do Schema.org e do Google para cada
@typeque você planeja usar. O Google Rich Results Test indicará quais propriedades obrigatórias estão faltando. Por exemplo,Productsemnameouoffersserá inválido.
- Como evitar: Consulte a documentação oficial do Schema.org e do Google para cada
- Sintaxe JSON-LD Incorreta: Erros de vírgulas, aspas, chaves ou colchetes mal posicionados, tornando o JSON-LD ilegível para os motores de busca.
- Como evitar: Utilize um validador de JSON (como jsonlint.com) antes de inserir o código na página. Preste atenção especial ao final de cada objeto e lista, onde as vírgulas são necessárias, exceto no último item. Exemplo:
{"prop1": "valor1", "prop2": "valor2"}é correto,{"prop1": "valor1", "prop2": "valor2",}é incorreto.
- Como evitar: Utilize um validador de JSON (como jsonlint.com) antes de inserir o código na página. Preste atenção especial ao final de cada objeto e lista, onde as vírgulas são necessárias, exceto no último item. Exemplo:
Dicas Avançadas
- Aninhamento de Schemas (Nested Schemas): Combine múltiplos tipos de Schema em um único bloco JSON-LD para descrever entidades complexas. Por exemplo, um
Articlepode ter umVideoObjecteImageObjectaninhados, ou umProductpode aninharRevieweAggregateRating. Isso cria um grafo de conhecimento mais rico e preciso.- Exemplo: Um
Articlesobre um produto pode incluir oProductschema dentro da propriedadeaboutoumentions, ligando o artigo diretamente ao produto.
- Exemplo: Um
- Schema Dinâmico com Geradores no Lado do Servidor: Para sites grandes ou com conteúdo em constante mudança (e-commerce, notícias), gere o JSON-LD programaticamente usando dados do banco de dados ou API. Isso garante que o Schema Markup esteja sempre atualizado e consistente.
- Exemplo: Em um sistema PHP, Python ou Node.js, crie funções que puxam o título, data, autor e imagens do CMS e as interpolam em um template JSON-LD antes de renderizar a página.
- Utilize
sameAspara Consistência de Entidades: Use a propriedadesameAspara vincular entidades (Pessoas, Organizações) a suas representações em outras plataformas (Wikipedia, LinkedIn, redes sociais). Isso ajuda os motores de busca a consolidar o conhecimento sobre a entidade.- Exemplo: No
authordoArticleoupublisherdoOrganization, adicionesameAs:["https://twitter.com/nomedousuario", "https://www.linkedin.com/in/nomedousuario"].
- Exemplo: No
- Marcação de Vídeos com
VideoObject: Para páginas que contêm vídeos, implementeVideoObjectpara aumentar as chances de aparecer em carrosséis de vídeo ou rich snippets de vídeo. Incluaname,description,thumbnailUrl,uploadDateecontentUrl.- Exemplo: Uma página de receita pode ter um
Recipeschema e, dentro dele, umVideoObjectdescrevendo o vídeo de preparo.
- Exemplo: Uma página de receita pode ter um
- Teste Rigoroso em Ambiente de Desenvolvimento: Antes de lançar o Schema Markup para produção, teste-o exaustivamente em um ambiente de staging. Use o Google Rich Results Test e o Schema Markup Validator para garantir que não haja erros e que os rich snippets esperados sejam detectados. Isso evita problemas de indexação e penalidades por marcação incorreta.
04 同仓库更多 Skills
clarity-gate
Pre-ingestion verification for epistemic quality in RAG systems. Ensures documents are properly qualified before entering knowledge bases. Produces CGD (Clarity-Gated Documents) and validates SOT (Source of Truth) files.
skill-check
Validate Claude Code skills against the agentskills specification. Catches structural, semantic, and naming issues before users do.
peon-ping-use
Set which voice pack (character voice) plays for the current chat session. Automatically enables session_override rotation mode if not already set. Use when user wants a specific character voice like GLaDOS, Peon, or Kerrigan for this conversation.
mcp-builder
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate exte...
webapp-testing
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browse...
test-driven-development
TDD: enforce RED-GREEN-REFACTOR, tests before code.