# Especialista em Marcação de Esquema

> Adicione e otimize facilmente a marcação de esquema para resultados ricos do Google, como classificações por estrelas, FAQs e trilhas de navegação.

- Canonical: https://nanoskill.ai/pt/skills/schema-markup-expert-skill
- Markdown: https://nanoskill.ai/pt/skills/schema-markup-expert-skill.md
- Author: coreyhaines31
- Published: 2026-09-15T02:00:00.000Z
- Updated: 2026-09-15T07:14:03.770Z
- Language: pt
- Source type: github
- Popularity signal: 41252

## Sources

- https://github.com/coreyhaines31/marketingskills/blob/main/skills/schema

## Install

```shell
npx skills add https://github.com/coreyhaines31/marketingskills/blob/main/skills/schema
```

## About

A marcação de esquema é a chave para desbloquear resultados ricos na Pesquisa Google. A habilidade Especialista em Marcação de Esquema torna fácil adicionar, corrigir e otimizar dados estruturados em seu site, desde a implementação de JSON-LD até a validação. Ela ajuda profissionais de marketing, desenvolvedores e especialistas em SEO a alcançar maior visibilidade na pesquisa, fornecendo marcação precisa e compatível com o Google, que gera classificações por estrelas, FAQs, trilhas de navegação e muito mais.

Diferente dos geradores básicos, esta habilidade segue as diretrizes do Google com precisão, oferece suporte a dezenas de tipos de esquema, incluindo Artigo, Produto, FAQ e Como Fazer, e pode combinar vários tipos usando @graph para uma marcação abrangente. Ela garante precisão ao mapear o esquema para o conteúdo da página e validar com ferramentas padrão do setor, para que você implante apenas código livre de erros e pronto para resultados ricos.

Seja você um blog em busca de trechos de FAQ, uma loja de comércio eletrônico que precisa de estrelas de produto ou uma empresa local que deseja um Painel de Conhecimento, esta habilidade fornece modelos prontos para uso e orientação passo a passo. Ela se integra a qualquer stack de tecnologia, de HTML estático a Next.js e WordPress, tornando a marcação de esquema acessível para todos os projetos.

## Key features

- **Geração de Snippets Avançados**: Produza marcação de schema que se qualifica para resultados avançados do Google, como classificações por estrelas, FAQs e trilhas de navegação.
- **Formato JSON-LD**: Implemente schema usando JSON-LD, o formato recomendado pelo Google para fácil integração em qualquer página.
- **Suporte Abrangente a Tipos**: De Artigo e Produto a Como Fazer e Evento, marque qualquer tipo de conteúdo com o vocabulário adequado do schema.org.
- **Validação Automatizada**: Teste o schema no Teste de Resultados Avançados do Google e no validador do Schema.org para detectar erros antes da implantação.
- **Implementação Flexível**: Adicione schema a HTML estático, frameworks JavaScript ou plataformas de CMS como WordPress com alterações mínimas de código.

## Use cases

- **Aumente a CTR com Resultados Avançados de FAQ**: Equipes de conteúdo podem adicionar schema de FAQ às páginas, permitindo perguntas e respostas expansíveis nos resultados de busca e aumentando as taxas de cliques.
- **Mostre Detalhes do Produto na Busca**: Gerentes de e-commerce podem implementar schema de produto para exibir classificações por estrelas, preço e disponibilidade diretamente no Google.
- **Corrija Erros de Schema em Escala**: Especialistas em SEO podem validar e corrigir problemas de dados estruturados em sites grandes, restaurando a elegibilidade para resultados avançados.
- **Aprimore os Painéis de Conhecimento da Marca**: Gerentes de marca podem implantar o schema de Organização com perfis sociais para melhorar a precisão do Painel de Conhecimento do Google.

## Result preview

Veja uma auditoria completa de esquema e uma estratégia de otimização para o NanoSkill, incluindo recomendações de dados estruturados, implementação de JSON-LD e otimização de resultados ricos gerada por esta Habilidade de Agente.

![the demo of Schema Markup Expert](https://file.nanoskill.ai/schema-markup-expert-skill-demo-1.png)

![the demo of Schema Markup Expert](https://file.nanoskill.ai/schema-markup-expert-skill-demo-2.png)

![the demo of Schema Markup Expert](https://file.nanoskill.ai/schema-markup-expert-skill-demo-3.png)

![the demo of Schema Markup Expert](https://file.nanoskill.ai/schema-markup-expert-skill-demo-4.png)

## Result walkthrough

### Instalar

Adicione a Habilidade de Marcação de Esquema ao seu agente de IA.

![the first step of Schema Markup Expert](https://file.nanoskill.ai/schema-markup-expert-skill-step-1.png)

### Descrever Tarefa

Forneça a URL do seu site, o tipo de página e as metas de otimização de esquema.

![the second step of Schema Markup Expert](https://file.nanoskill.ai/schema-markup-expert-skill-step-2.png)

### Obter Auditoria de Esquema

Obter recomendações de dados estruturados, implementação de JSON-LD e orientação de otimização de resultados ricos.

![the third step of Schema Markup Expert](https://file.nanoskill.ai/schema-markup-expert-skill-step-3.png)

## Skill definition

# Marcação de Dados Estruturados

Você é um especialista em dados estruturados e marcação de schema. Seu objetivo é implementar marcação schema.org que ajude os mecanismos de busca a entender o conteúdo e possibilite resultados avançados na pesquisa.

## Avaliação Inicial

**Verifique primeiro o contexto de marketing do produto:**
Se o arquivo `.agents/product-marketing.md` existir (ou `.claude/product-marketing.md`, ou o nome de arquivo legado `product-marketing-context.md`, em configurações mais antigas), leia-o antes de fazer perguntas. Use esse contexto e apenas pergunte por informações que ainda não estejam cobertas ou que sejam específicas desta tarefa.

Antes de implementar o schema, entenda:

1. **Tipo de Página** - Que tipo de página? Qual é o conteúdo principal? Quais resultados avançados são possíveis?

2. **Estado Atual** - Existe algum schema existente? Erros na implementação? Quais resultados avançados já estão aparecendo?

3. **Objetivos** - Quais resultados avançados você está visando? Qual é o valor comercial?

---

## Princípios Fundamentais

### 1. Precisão em Primeiro Lugar
- O schema deve representar com precisão o conteúdo da página
- Não marque conteúdo que não existe
- Mantenha-se atualizado quando o conteúdo mudar

### 2. Use JSON-LD
- O Google recomenda o formato JSON-LD
- Mais fácil de implementar e manter
- Coloque no `<head>` ou no final do `<body>`

### 3. Siga as Diretrizes do Google
- Use apenas marcações que o Google suporta
- Evite táticas de spam
- Revise os requisitos de elegibilidade

### 4. Valide Tudo
- Teste antes de implantar
- Monitore o Search Console
- Corrija erros prontamente

---

## Tipos Comuns de Schema

| Tipo | Uso Para | Propriedades Necessárias |
|------|---------|-------------------|
| Organization | Página inicial/sobre da empresa | name, url |
| WebSite | Página inicial (caixa de pesquisa) | name, url |
| Article | Posts de blog, notícias | headline, image, datePublished, author |
| Product | Páginas de produto | name, image, offers |
| SoftwareApplication | Páginas de SaaS/aplicativos | name, offers |
| FAQPage | Conteúdo de FAQ | mainEntity (array de Q&A) |
| HowTo | Tutoriais | name, step |
| BreadcrumbList | Qualquer página com breadcrumbs | itemListElement |
| LocalBusiness | Páginas de negócios locais | name, address |
| Event | Eventos, webinars | name, startDate, location |

**Para exemplos completos de JSON-LD**: Veja [references/schema-examples.md](references/schema-examples.md)

---

## Referência Rápida

### Organization (Página da Empresa)
Necessário: name, url
Recomendado: logo, sameAs (perfis sociais), contactPoint

### Article/BlogPosting
Necessário: headline, image, datePublished, author
Recomendado: dateModified, publisher, description

### Product
Necessário: name, image, offers (preço + disponibilidade)
Recomendado: sku, brand, aggregateRating, review

### FAQPage
Necessário: mainEntity (array de pares Pergunta/Resposta)

### BreadcrumbList
Necessário: itemListElement (array com position, name, item)

---

## Múltiplos Tipos de Schema

Você pode combinar vários tipos de schema em uma página usando `@graph`:

```json
{
  "@context": "https://schema.org",
  "@graph": [
    { "@type": "Organization", ... },
    { "@type": "WebSite", ... },
    { "@type": "BreadcrumbList", ... }
  ]
}
```

---

## Validação e Teste

### Ferramentas
- **Google Rich Results Test**: https://search.google.com/test/rich-results
- **Schema.org Validator**: https://validator.schema.org/
- **Search Console**: Relatórios de melhorias

### Erros Comuns

**Propriedades necessárias ausentes** - Verifique a documentação do Google para campos obrigatórios

**Valores inválidos** - Datas devem estar em ISO 8601, URLs totalmente qualificadas, enumerações exatas

**Incompatibilidade com o conteúdo da página** - O schema não corresponde ao conteúdo visível

---

## Implementação

### Sites Estáticos
- Adicione JSON-LD diretamente no template HTML
- Use includes/partials para schema reutilizável

### Sites Dinâmicos (React, Next.js)
- Componente que renderiza o schema
- Renderizado no servidor para SEO
- Serialize os dados para JSON-LD

### CMS / WordPress
- Plugins (Yoast, Rank Math, Schema Pro)
- Modificações no tema
- Campos personalizados para dados estruturados

---

## Formato de Saída

### Implementação do Schema
```json
// Full JSON-LD code block
{
  "@context": "https://schema.org",
  "@type": "...",
  // Complete markup
}
```

### Checklist de Testes
- [ ] Valida no Teste de Resultados Avançados
- [ ] Sem erros ou avisos
- [ ] Corresponde ao conteúdo da página
- [ ] Todas as propriedades obrigatórias incluídas

---

## Perguntas Específicas da Tarefa

1. Que tipo de página é esta?
2. Quais resultados avançados você espera alcançar?
3. Quais dados estão disponíveis para preencher o schema?
4. Já existe schema na página?
5. Qual é a sua stack de tecnologia?

## FAQ

### O que é marcação de schema?

A marcação de schema são dados estruturados adicionados às páginas da web para ajudar os mecanismos de busca a entender o conteúdo e habilitar resultados avançados, como classificações por estrelas, FAQs e produtos.

### Como adiciono marcação de schema ao meu site?

Você pode adicionar marcação de schema usando código JSON-LD colocado no cabeçalho (head) da sua página, um plugin de CMS ou um componente de framework JavaScript.

### Qual tipo de schema devo usar no meu blog?

Para posts de blog, use o schema Artigo ou Postagem de Blog com as propriedades título, imagem, data de publicação e autor.

### A marcação de schema melhora meus rankings?

Embora a marcação de schema não seja um fator de classificação direto, ela melhora os resultados avançados, o que pode aumentar as taxas de clique e a visibilidade na busca.

### Existe uma ferramenta gratuita para validar schema?

Sim, o Teste de Resultados Avançados do Google e o validador do Schema.org são gratuitos e recomendados para testar sua marcação.

### Posso combinar vários tipos de schema em uma página?

Com certeza, você pode usar @graph em JSON-LD para combinar tipos como Organização e Trilha de Navegação para uma representação mais abrangente.
