Disponibilidade de Material de Apoio

Esta cópia do catálogo contém as orientações inline abaixo, mas não inclui os seguintes caminhos de suporte. Eles são pré-requisitos externos, não arquivos empacotados:

• <support-root>/references/schema-types.md

Obtenha o material necessário da fonte upstream declarada, ou de uma instalação fornecida pelo usuário dessa fonte. Resolva cada caminho em relação a essa instalação, inspecione seu conteúdo e verifique quaisquer licenças aplicáveis e pré-requisitos de execução. Não execute um comando nem afirme que um procedimento referenciado foi seguido até que seu arquivo necessário exista. Não fabrique os scripts ausentes nem trate um arquivo não relacionado com o mesmo nome como equivalente. Etapas independentes totalmente documentadas aqui podem prosseguir dentro do escopo autorizado do usuário; relate qualquer etapa dependente como indisponível.

Análise e Geração de Marcação de Schema

Quando Usar

• Use ao detectar, validar ou gerar dados estruturados Schema.org.
• Use quando o usuário perguntar sobre JSON-LD, resultados avançados (rich results) ou oportunidades de marcação.
• Use quando a validação de schema for a tarefa principal, em vez de uma auditoria de SEO mais ampla.

Detecção

1. Escaneie o código-fonte da página em busca de JSON-LD <script type="application/ld+json">
2. Verifique Microdata (itemscope, itemprop)
3. Verifique RDFa (typeof, property)
4. Sempre recomende JSON-LD como formato principal (preferência declarada pelo Google)

Validação

• Verifique as propriedades obrigatórias por tipo de schema
• Valide contra os tipos de resultados avançados suportados pelo Google
• Teste erros comuns:
  • @context ausente
  • @type inválido
  • Tipos de dados incorretos
  • Texto de placeholder
  • URLs relativas (devem ser absolutas)
  • Formatos de data inválidos
• Sinalize tipos depreciados (veja abaixo)

Status do Tipo de Schema (a partir de Fev 2026)

Leia references/schema-types.md para a lista completa. Regras principais:

ATIVO (recomende livremente):

Organization, LocalBusiness, SoftwareApplication, WebApplication, Product (com marcação Certification a partir de Abril 2025), ProductGroup, Offer, Service, Article, BlogPosting, NewsArticle, Review, AggregateRating, BreadcrumbList, WebSite, WebPage, Person, ProfilePage, ContactPage, VideoObject, ImageObject, Event, JobPosting, Course, DiscussionForumPosting

VÍDEO & ESPECIALIZADO (recomende livremente):

BroadcastEvent, Clip, SeekToAction, SoftwareSourceCode

Veja schema/templates.json para modelos JSON-LD prontos para uso para esses tipos.

JSON-LD e renderização JavaScript: De acordo com as orientações de SEO para JS de Dezembro de 2025 do Google, dados estruturados injetados via JavaScript podem enfrentar atrasos no processamento. Para marcações sensíveis ao tempo (especialmente Product, Offer), inclua JSON-LD no HTML renderizado pelo servidor inicialmente.

RESTRITO (apenas para sites específicos):

• FAQ: APENAS para sites de autoridades governamentais e de saúde (restrito em Agosto 2023)

DEPRECIADO (nunca recomende):

• HowTo: Resultados avançados removidos em Setembro de 2023
• SpecialAnnouncement: Depreciado em 31 de Julho de 2025
• CourseInfo, EstimatedSalary, LearningVideo: Descontinuados em Junho de 2025
• ClaimReview: Descontinuado de resultados avançados em Junho de 2025
• VehicleListing: Descontinuado de resultados avançados em Junho de 2025
• Practice Problem: Descontinuado de resultados avançados no final de 2025
• Dataset: Descontinuado de resultados avançados no final de 2025
• Book Actions: Depreciado e depois revertido, ainda funcional em Fev 2026 (nota histórica)

Geração

Ao gerar schema para uma página:

1. Identifique o tipo de página a partir da análise de conteúdo
2. Selecione o(s) tipo(s) de schema apropriado(s)
3. Gere JSON-LD válido com todas as propriedades obrigatórias + recomendadas
4. Inclua apenas dados verdadeiros e verificáveis. Use placeholders claramente marcados para o usuário preencher
5. Valide a saída antes de apresentar

Modelos Comuns de Schema

Organization

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "[Company Name]",
  "url": "[Website URL]",
  "logo": "[Logo URL]",
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "[Phone]",
    "contactType": "customer service"
  },
  "sameAs": [
    "[Facebook URL]",
    "[LinkedIn URL]",
    "[Twitter URL]"
  ]
}

LocalBusiness

{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "[Nome da Empresa]",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "[Rua]",
    "addressLocality": "[Cidade]",
    "addressRegion": "[Estado]",
    "postalCode": "[CEP]",
    "addressCountry": "BR"
  },
  "telephone": "[Telefone]",
  "openingHours": "Seg-Sex 09:00-17:00",
  "geo": {
    "@type": "GeoCoordinates",

…