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 como NewsArticle ou BlogPosting) é o mais adequado.
Identifique as propriedades essenciais: Um Article básico requer headline, image, datePublished, dateModified, author (com name e url), publisher (com name e logo).
headline: Título principal do artigo, por exemplo, "Guia Completo de Schema Markup para SEO".
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 tipo Product.
Identifique as propriedades essenciais para e-commerce:
name: Nome do produto, por exemplo, "Smartphone X Pro 128GB".
sku e mpn: Códigos de identificação do produto (Stock Keeping Unit, Manufacturer Part Number).
brand: Marca do produto, por exemplo, "TechBrand".
offers: Um objeto Offer que inclui priceCurrency ("BRL"), price ("2999.99"), itemCondition (NewCondition), availability (InStock ou OutOfStock), e url (URL da página do produto).
aggregateRating: Um objeto AggregateRating para avaliações, incluindo ratingValue (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
O tipo de Schema Markup (@type) corresponde ao conteúdo principal da página (e.g., Product para produto, Article para blog post).
Todas as propriedades obrigatórias para o @type selecionado estão preenchidas.
Todas as propriedades recomendadas foram consideradas e, se aplicável, preenchidas.
Os dados no Schema Markup refletem exatamente o conteúdo visível na página (não oculto ou desatualizado).
O JSON-LD está sintaticamente correto (sem erros de vírgula, chaves, aspas).
O Schema Markup foi validado usando o Google Rich Results Test e não apresenta erros críticos.
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).
O desempenho dos rich snippets está sendo monitorado no Google Search Console (seção "Aprimoramentos").
Imagens referenciadas no Schema (e.g., image, logo) têm as dimensões mínimas recomendadas pelo Google.
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 @type que você planeja usar. O Google Rich Results Test indicará quais propriedades obrigatórias estão faltando. Por exemplo, Product sem name ou offers será inválido.
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.
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 Article pode ter um VideoObject e ImageObject aninhados, ou um Product pode aninhar Review e AggregateRating. Isso cria um grafo de conhecimento mais rico e preciso.
Exemplo: Um Article sobre um produto pode incluir o Product schema dentro da propriedade about ou mentions, ligando o artigo diretamente ao produto.
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 sameAs para Consistência de Entidades: Use a propriedade sameAs para 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 author do Article ou publisher do Organization, adicione sameAs: ["https://twitter.com/nomedousuario", "https://www.linkedin.com/in/nomedousuario"].
Marcação de Vídeos com VideoObject: Para páginas que contêm vídeos, implemente VideoObject para aumentar as chances de aparecer em carrosséis de vídeo ou rich snippets de vídeo. Inclua name, description, thumbnailUrl, uploadDate e contentUrl.
Exemplo: Uma página de receita pode ter um Recipe schema e, dentro dele, um VideoObject descrevendo o vídeo de preparo.
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.
1---2name: schema-markup3description: Schema Markup — Skill especializada para schema markup4license: MIT5---67# Schema Markup89Esta skill capacita o Claude a gerar, validar e otimizar implementações de Schema Markup para melhorar a visibilidade em resultados de busca enriquecidos.1011---1213## Keywords1415* Schema.org16* JSON-LD17* Rich Snippets18* Structured Data19* Google Search Console20* Validação Schema21* SEO Técnico22* Microdata23* RDFa24* Knowledge Graph25* Product Schema26* Article Schema27* FAQPage Schema2829---3031## Quick Start32331. **Identifique o tipo de conteúdo**: Determine qual tipo de Schema.org melhor descreve a página (e.g., `Article`, `Product`, `LocalBusiness`).342. **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.353. **Insira o código na página**: Adicione o script JSON-LD dentro da seção `<head>` ou `<body>` do HTML da página.364. **Valide com a ferramenta do Google**: Teste o URL da página no [Google Rich Results Test](https://search.google.com/test/rich-results) para verificar erros e pré-visualizar os rich snippets.375. **Monitore no Search Console**: Acompanhe o desempenho e a cobertura dos rich snippets na seção "Aprimoramentos" do Google Search Console.3839---4041## Core Workflows4243### Workflow 1: Implementação de Schema.org para Artigo (Article)4445Este 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.46471. **Selecione o tipo `Article`**: Para posts de blog, artigos de notícias ou publicações editoriais, `Article` (ou sub-tipos como `NewsArticle` ou `BlogPosting`) é o mais adequado.482. **Identifique as propriedades essenciais**: Um `Article` básico requer `headline`, `image`, `datePublished`, `dateModified`, `author` (com `name` e `url`), `publisher` (com `name` e `logo`).49 * `headline`: Título principal do artigo, por exemplo, "Guia Completo de Schema Markup para SEO".50 * `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".51 * `datePublished`: Data de publicação no formato ISO 8601, por exemplo, "2023-10-27T08:00:00+03:00".52 * `dateModified`: Data da última modificação, se houver, no mesmo formato. Se não houver, pode ser igual a `datePublished`.53 * `author`: Um objeto `Person` ou `Organization` com `name` ("João Silva") e `url` ("https://www.exemplo.com.br/autores/joao-silva").54 * `publisher`: Um objeto `Organization` com `name` ("Exemplo Blog") e `logo` (URL da imagem do logo da organização, por exemplo, "https://www.exemplo.com.br/imagens/logo-exemplo.png").553. **Gere o JSON-LD**: Crie o script JSON-LD com as propriedades identificadas.56 ```json57 <script type="application/ld+json">58 {59 "@context": "https://schema.org",60 "@type": "Article",61 "headline": "Guia Completo de Schema Markup para SEO",62 "image": [63 "https://www.exemplo.com.br/imagens/schema-markup-guia.jpg"64 ],65 "datePublished": "2023-10-27T08:00:00+03:00",66 "dateModified": "2023-10-27T10:30:00+03:00",67 "author": {68 "@type": "Person",69 "name": "João Silva",70 "url": "https://www.exemplo.com.br/autores/joao-silva"71 },72 "publisher": {73 "@type": "Organization",74 "name": "Exemplo Blog",75 "logo": {76 "@type": "ImageObject",77 "url": "https://www.exemplo.com.br/imagens/logo-exemplo.png"78 }79 },80 "description": "Aprenda a implementar e otimizar Schema Markup para melhorar a visibilidade de seus artigos nos resultados de busca."81 }82 </script>83 ```844. **Incorpore na página**: Adicione o bloco `<script>` gerado na seção `<head>` do HTML da página do artigo.855. **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.8687### Workflow 2: Otimização de Schema para Produtos (Product) com Reviews8889Este 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.90911. **Selecione o tipo `Product`**: Para páginas de produtos de e-commerce, utilize o tipo `Product`.922. **Identifique as propriedades essenciais para e-commerce**:93 * `name`: Nome do produto, por exemplo, "Smartphone X Pro 128GB".94 * `image`: URLs das imagens do produto, por exemplo, "https://www.loja.com/imagens/smxpro_frente.jpg".95 * `description`: Descrição breve do produto.96 * `sku` e `mpn`: Códigos de identificação do produto (Stock Keeping Unit, Manufacturer Part Number).97 * `brand`: Marca do produto, por exemplo, "TechBrand".98 * `offers`: Um objeto `Offer` que inclui `priceCurrency` ("BRL"), `price` ("2999.99"), `itemCondition` (`NewCondition`), `availability` (`InStock` ou `OutOfStock`), e `url` (URL da página do produto).99 * `aggregateRating`: Um objeto `AggregateRating` para avaliações, incluindo `ratingValue` (média das avaliações, e.g., "4.7"), `reviewCount` (número total de avaliações, e.g., "125").1003. **Gere o JSON-LD**: Crie o script JSON-LD com as propriedades identificadas.101 ```json102 <script type="application/ld+json">103 {104 "@context": "https://schema.org/",105 "@type": "Product",106 "name": "Smartphone X Pro 128GB",107 "image": [108 "https://www.loja.com/imagens/smxpro_frente.jpg",109 "https://www.loja.com/imagens/smxpro_traseira.jpg"110 ],111 "description": "O Smartphone X Pro oferece desempenho superior com câmera de 108MP e tela OLED.",112 "sku": "SMXPRO-128GB-BR",113 "mpn": "TECH-XPRO-128",114 "brand": {115 "@type": "Brand",116 "name": "TechBrand"117 },118 "offers": {119 "@type": "Offer",120 "url": "https://www.loja.com/produto/smartphone-x-pro",121 "priceCurrency": "BRL",122 "price": "2999.99",123 "itemCondition": "https://schema.org/NewCondition",124 "availability": "https://schema.org/InStock",125 "seller": {126 "@type": "Organization",127 "name": "Minha Loja Online"128 }129 },130 "aggregateRating": {131 "@type": "AggregateRating",132 "ratingValue": "4.7",133 "reviewCount": "125"134 },135 "review": [136 {137 "@type": "Review",138 "reviewRating": {139 "@type": "Rating",140 "ratingValue": "5"141 },142 "author": {143 "@type": "Person",144 "name": "Ana Paula"145 },146 "reviewBody": "Adorei o celular, câmera excelente e bateria dura muito!"147 }148 ]149 }150 </script>151 ```1524. **Incorpore na página**: Insira o JSON-LD dentro da seção `<head>` ou `<body>` da página do produto.1535. **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.154155---156157## Templates158159### JSON-LD para Evento (Event)160161```json162<script type="application/ld+json">163{164 "@context": "https://schema.org",165 "@type": "Event",166 "name": "Conferência de Marketing Digital 2024",167 "startDate": "2024-05-15T09:00",168 "endDate": "2024-05-17T18:00",169 "eventStatus": "https://schema.org/EventScheduled",170 "eventAttendanceMode": "https://schema.org/OfflineEventAttendanceMode",171 "location": {172 "@type": "Place",173 "name": "Centro de Convenções São Paulo",174 "address": {175 "@type": "PostalAddress",176 "streetAddress": "Rua das Flores, 123",177 "addressLocality": "São Paulo",178 "addressRegion": "SP",179 "postalCode": "01000-000",180 "addressCountry": "BR"181 }182 },183 "image": [184 "https://www.conferencia-marketing.com.br/imagens/banner-conferencia.jpg",185 "https://www.conferencia-marketing.com.br/imagens/logo-evento.png"186 ],187 "description": "A maior conferência de marketing digital do Brasil, com palestrantes renomados e workshops práticos.",188 "offers": {189 "@type": "Offer",190 "url": "https://www.conferencia-marketing.com.br/ingressos",191 "price": "599.00",192 "priceCurrency": "BRL",193 "availability": "https://schema.org/InStock",194 "validFrom": "2023-11-01T00:00"195 },196 "organizer": {197 "@type": "Organization",198 "name": "Agência Marketing Pro",199 "url": "https://www.agenciamarketingpro.com.br"200 }201}202</script>203```204205### JSON-LD para Perguntas Frequentes (FAQPage)206207```json208<script type="application/ld+json">209{210 "@context": "https://schema.org",211 "@type": "FAQPage",212 "mainEntity": [{213 "@type": "Question",214 "name": "O que é Schema Markup?",215 "acceptedAnswer": {216 "@type": "Answer",217 "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."218 }219 },{220 "@type": "Question",221 "name": "Como implemento Schema Markup no meu site?",222 "acceptedAnswer": {223 "@type": "Answer",224 "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."225 }226 },{227 "@type": "Question",228 "name": "Quais são os benefícios de usar Schema Markup?",229 "acceptedAnswer": {230 "@type": "Answer",231 "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."232 }233 }]234}235</script>236```237238---239240## Checklist241242- [x] O tipo de Schema Markup (`@type`) corresponde ao conteúdo principal da página (e.g., `Product` para produto, `Article` para blog post).243- [x] Todas as propriedades *obrigatórias* para o `@type` selecionado estão preenchidas.244- [x] Todas as propriedades *recomendadas* foram consideradas e, se aplicável, preenchidas.245- [x] Os dados no Schema Markup refletem *exatamente* o conteúdo visível na página (não oculto ou desatualizado).246- [x] O JSON-LD está sintaticamente correto (sem erros de vírgula, chaves, aspas).247- [x] O Schema Markup foi validado usando o Google Rich Results Test e não apresenta erros críticos.248- [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).249- [x] O desempenho dos rich snippets está sendo monitorado no Google Search Console (seção "Aprimoramentos").250- [x] Imagens referenciadas no Schema (e.g., `image`, `logo`) têm as dimensões mínimas recomendadas pelo Google.251- [x] URLs dentro do Schema Markup são canônicas e acessíveis.252253---254255## Métricas de Referência256257| Métrica | Benchmark (Média) | Meta (Otimizado) |258|:--------|:------------------|:-----------------|259| CTR (com rich snippets) | 5% - 8% | 10% - 15% |260| Impressões (com rich snippets) | > 20% das impressões totais | > 40% das impressões totais |261| Rich Results Coverage (Search Console) | > 80% das páginas elegíveis | > 95% das páginas elegíveis |262| Validação de Schema (erros) | 0.5% - 1% de erros | 0% de erros |263| Posição Média (rich snippets) | Posições 1-3 | Posições 1-2 |264265---266267## Erros Comuns2682691. **Dados Inconsistentes**: O Schema Markup apresenta informações diferentes do conteúdo visível na página.270 * **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.2712. **Propriedades Obrigatórias Faltando**: Um tipo de Schema.org requer certas propriedades que não são preenchidas, resultando em rich snippets inválidos.272 * **Como evitar**: Consulte a documentação oficial do Schema.org e do Google para cada `@type` que você planeja usar. O Google Rich Results Test indicará quais propriedades obrigatórias estão faltando. Por exemplo, `Product` sem `name` ou `offers` será inválido.2733. **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.274 * **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.275276---277278## Dicas Avançadas2792801. **Aninhamento de Schemas (Nested Schemas)**: Combine múltiplos tipos de Schema em um único bloco JSON-LD para descrever entidades complexas. Por exemplo, um `Article` pode ter um `VideoObject` e `ImageObject` aninhados, ou um `Product` pode aninhar `Review` e `AggregateRating`. Isso cria um grafo de conhecimento mais rico e preciso.281 * **Exemplo**: Um `Article` sobre um produto pode incluir o `Product` schema dentro da propriedade `about` ou `mentions`, ligando o artigo diretamente ao produto.2822. **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.283 * **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.2843. **Utilize `sameAs` para Consistência de Entidades**: Use a propriedade `sameAs` para 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.285 * **Exemplo**: No `author` do `Article` ou `publisher` do `Organization`, adicione `sameAs`: `["https://twitter.com/nomedousuario", "https://www.linkedin.com/in/nomedousuario"]`.2864. **Marcação de Vídeos com `VideoObject`**: Para páginas que contêm vídeos, implemente `VideoObject` para aumentar as chances de aparecer em carrosséis de vídeo ou rich snippets de vídeo. Inclua `name`, `description`, `thumbnailUrl`, `uploadDate` e `contentUrl`.287 * **Exemplo**: Uma página de receita pode ter um `Recipe` schema e, dentro dele, um `VideoObject` descrevendo o vídeo de preparo.2885. **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.
Run npx skillmds@latest add kursku/schema-markup in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Schema Markup — Skill especializada para schema markup It is listed under Marketing & Growth on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.
kursku (@kursku) published this skill. Their other Agent Skills are listed on their SkillMD profile.
kursku