O Guia de schema de tokens para sites cripto.
A seleção de schema é o ajuste de SEO e AEO de maior alavancagem porque é binário, rápido e raramente é feito corretamente em sites crypto. Esse guia cobre cada tipo JSON-LD relevante para crypto com exemplos copy-paste, a árvore de decisão para escolher o tipo correto por página e o padrão de gerenciamento canônico multichain.
Índice
- Por que a correção de schema importa para crypto
- A árvore de decisão de schema por tipo de página
- FinancialProduct em profundidade
- CryptoExchange em profundidade
- SoftwareApplication para wallets e SDKs
- Organization e Person para E-E-A-T
- Manejo de canónico multi-cadeia
- Ferramentas e testes de validação
- Erros comuns de schema
Por que a correção de schema importa para crypto
Schema.org é o vocabulário de structured data que os motores de busca e extratores de IA usam para entender o que uma página descreve. O schema incorreto significa que o motor classifica mal a página; a página ou fica com ranking mais baixo ou é ignorada por completo para as consultas que deveria atender.
Para crypto especificamente, a correção de schema se soma através de três caminhos de citações.
O que o schema correto habilita
Três vitórias que se compõem
- Rich results do Google para categorias cripto (onde houver suporte)
- AI extraction databases (ChatGPT, Perplexity, Claude)
- Entidades do knowledge graph para o reconhecimento do projeto
- Resolução de Person do Schema.org para E-E-A-T
- Categorização como FinancialProduct ou CryptoExchange
O que o schema incorreto custa
Três perdas que se compõem
- Schema Product genérico é categorizado como mercadoria
- Os extratores de IA ignoram a página ou a classificam errado
- Sinais de confiança YMYL são rejeitados sem Person + sameAs
- Schema duplicado entre chains reduz os níveis de confiança
- A falta de propriedades recomendadas rebaixa os resultados avançados
O ajuste individual de maior alavancagem
Audit token pages for FinancialProduct (not generic Product), exchange pages for CryptoExchange (not generic Organization), wallet pages for SoftwareApplication (not generic Product). Três correções de template costumam melhorar a precisão do schema no site inteiro.
A árvore de decisão de schema por tipo de página
Escolher o tipo de schema correto é direto assim que você conhece as regras. Cada página em um site crypto se enquadra em uma de sete categorias. Cada categoria tem um tipo de schema primário correto.
Páginas de informação de token → FinancialProduct
Páginas descrevendo um token específico: tokenomics, supply, market cap, endereço do contrato. A página descreve um instrumento financeiro, não um produto.
Páginas de plataforma de exchange → CryptoExchange
Página inicial e páginas de preços de plataformas CEX ou DEX. A página descreve uma plataforma de trading com ativos suportados e taxas de trading.
Apps de wallet → SoftwareApplication
Páginas descrevendo apps de wallet: features, chains suportadas, links de download. O applicationCategory deveria ser FinanceApplication para wallets.
SDKs e APIs → SoftwareApplication
Ferramentas de desenvolvedor, bibliotecas, documentação de API. O applicationCategory deveria ser DeveloperApplication. Inclui as propriedades operatingSystem e codeRepository.
Páginas Sobre nós da empresa → Organization
Página Sobre nós, página de equipe (pai), histórico da empresa. Inclui foundingDate, array founders, address, links sameAs para perfis sociais.
Páginas de equipe e fundador → Person
Páginas individuais de membros da equipe ou seções dentro da página de equipe. Sempre inclui sameAs vinculando a LinkedIn, GitHub, Twitter para verificação E-E-A-T.
Artigos e guias → Article ou TechArticle
Blog posts, documentação, guias como esse. TechArticle para conteúdo técnico; Article para posts gerais. Inclui author, datePublished, dateModified.
As páginas compostas combinam múltiplos tipos de schema usando @graph. Uma página de informação de token frequentemente inclui FinancialProduct (o token), Organization (o projeto) e FAQPage (a seção FAQ). O wrapper @graph lida com isso de forma limpa.
FinancialProduct em profundidade
FinancialProduct é o tipo correto para páginas de informação de token. As propriedades obrigatórias são name e description. As adições recomendadas abaixo melhoram significativamente a qualidade de extração por IA.
{ "@context": "https://schema.org", "@type": "FinancialProduct", "@id": "https://protocol.com/token#prtc", "name": "PROTOCOL Token", "alternateName": "PRTC", "description": "Native governance token of the PROTOCOL DeFi protocol. Used for voting on protocol upgrades, fee distribution and staking rewards.", "category": "Cryptocurrency", "feesAndCommissionsSpecification": "https://protocol.com/fees", "interestRate": { "@type": "QuantitativeValue", "value": "4.2", "unitText": "PERCENT" }, "provider": { "@type": "Organization", "@id": "https://protocol.com/#org", "name": "PROTOCOL Foundation", "url": "https://protocol.com" }, "identifier": [ { "@type": "PropertyValue", "propertyID": "contractAddress", "value": "0x1234...5678" }, { "@type": "PropertyValue", "propertyID": "chain", "value": "Ethereum" } ] }
Três padrões fazem esse exemplo funcionar. Primeiro, o array identifier usa PropertyValue para expor o endereço do contrato e a chain como fatos estruturados. Segundo, provider vincula o token à sua entidade Organization usando referência @id. Terceiro, interestRate expõe o APY como um QuantitativeValue (não texto livre), que os extratores de IA fazem parse de forma limpa.
Recomendações de propriedades
Obrigatórias: name, description. Altamente recomendadas: category, provider, identifier (endereço do contrato). Opcionais, mas de alto valor: feesAndCommissionsSpecification, interestRate, alternateName (ticker).
CryptoExchange em profundidade
CryptoExchange descreve a própria plataforma de trading. Use esse tipo na homepage, páginas de preços e páginas de descrição da plataforma. Para páginas individuais de landing de token na exchange, use FinancialProduct em vez disso.
{ "@context": "https://schema.org", "@type": "CryptoExchange", "@id": "https://exchange.com/#org", "name": "EXCHANGE", "url": "https://exchange.com", "description": "Centralized crypto exchange supporting 380+ trading pairs across BTC, ETH and major altcoins. Operating since 2019, regulated as MSB in the United States.", "foundingDate": "2019-03-15", "address": { "@type": "PostalAddress", "addressCountry": "US", "addressRegion": "NY" }, "hasOfferCatalog": { "@type": "OfferCatalog", "name": "Supported trading pairs", "itemListElement": [ { "@type": "Offer", "itemOffered": { "@type": "FinancialProduct", "name": "BTC/USD" } }, { "@type": "Offer", "itemOffered": { "@type": "FinancialProduct", "name": "ETH/USD" } } ] }, "sameAs": [ "https://twitter.com/exchange", "https://www.linkedin.com/company/exchange" ] }
O padrão hasOfferCatalog permite expor ativos suportados diretamente no schema. Cada Offer envolve um FinancialProduct. Os extratores de IA usam isso para responder prompts "EXCHANGE suporta TOKEN?" diretamente sem precisar rastrear páginas individuais.
Divulgação regulatória em schema
Mencione o status regulatório na descrição (MSB, MiCAR, BitLicense, registro na FCA). Isso sinaliza aos extratores de IA que a plataforma é regulamentada e aos modelos de confiança YMYL que a entidade é legítima.
SoftwareApplication para wallets e SDKs
SoftwareApplication é o tipo correto para qualquer software instalável ou hospedado. Para crypto especificamente, cobre wallets, SDKs, clientes de protocolo, extensões de navegador e APIs. A propriedade applicationCategory diferencia os casos de uso.
{ "@context": "https://schema.org", "@type": "SoftwareApplication", "@id": "https://wallet.com/#app", "name": "WALLET", "applicationCategory": "FinanceApplication", "operatingSystem": "iOS, Android, Chrome, Firefox, Edge", "description": "Self-custody crypto wallet supporting 50+ chains. Audited by Trail of Bits in October 2024.", "offers": { "@type": "Offer", "price": "0", "priceCurrency": "USD" }, "aggregateRating": { "@type": "AggregateRating", "ratingValue": "4.7", "reviewCount": "12500" }, "downloadUrl": [ "https://apps.apple.com/app/wallet", "https://play.google.com/store/apps/details?id=com.wallet" ] }
Para SDKs, mude applicationCategory para DeveloperApplication e adicione codeRepository apontando para o repositório no GitHub. O link do repositório funciona também como sinal de atualização, porque os motores de IA ponderam fortemente a atividade ativa no GitHub para sinais de confiança crypto.
{ "@context": "https://schema.org", "@type": "SoftwareApplication", "name": "PROTOCOL SDK", "applicationCategory": "DeveloperApplication", "operatingSystem": "Node.js, Python, Rust", "codeRepository": "https://github.com/protocol/sdk", "programmingLanguage": ["TypeScript", "Python", "Rust"], "softwareVersion": "3.2.0", "datePublished": "2026-04-01" }
Especificidades de extensões de navegador
For browser extension wallets and tools, list operatingSystem as the browsers supported (Chrome, Firefox, Edge, Brave). Evite o erro comum de listar só "Web" ou "Browser". Os nomes específicos dos navegadores funcionam melhor para a extração por IA.
Organization e Person para E-E-A-T
O schema Organization descreve a própria entidade do projeto. O schema Person descreve membros individuais da equipe. Os dois importam para E-E-A-T (Experience, Expertise, Authoritativeness, Trustworthiness), que o Google pondera fortemente em páginas YMYL.
{ "@context": "https://schema.org", "@type": "Organization", "@id": "https://protocol.com/#org", "name": "PROTOCOL Foundation", "url": "https://protocol.com", "foundingDate": "2022-08-15", "founders": [ { "@type": "Person", "name": "Jane Doe", "sameAs": [ "https://twitter.com/janedoe", "https://github.com/janedoe", "https://www.linkedin.com/in/janedoe" ] } ], "sameAs": [ "https://twitter.com/protocol", "https://github.com/protocol", "https://www.linkedin.com/company/protocol" ] }
O schema Person vai em páginas de equipe com uma entidade Person por membro da equipe. O array sameAs é a propriedade mais importante: os links para LinkedIn, GitHub, Twitter verificam que a pessoa é real e está ativa na comunidade crypto.
{ "@context": "https://schema.org", "@type": "Person", "name": "Jane Doe", "jobTitle": "Co-Founder, CTO", "worksFor": { "@type": "Organization", "@id": "https://protocol.com/#org" }, "alumniOf": [ { "@type": "Organization", "name": "MIT" }, { "@type": "Organization", "name": "ConsenSys" } ], "sameAs": [ "https://twitter.com/janedoe", "https://github.com/janedoe", "https://www.linkedin.com/in/janedoe" ] }
Por que sameAs importa para crypto
Anonymous-founder projects struggle to score E-E-A-T regardless of technical SEO. Person schema with sameAs links to LinkedIn, GitHub and Twitter is the technical implementation of E-E-A-T author signals. Se um fundador tem identidade pública e verificável, o schema deve refletir isso.
Manejo de canónico multi-cadeia
A documentação multichain é onde a maioria dos sites crypto perde a correção de schema. O padrão que funciona: mantenha o schema canônico na versão primária agnóstica de chain. Os subdomínios por chain usam o mesmo schema com a mesma URL canônica.
O padrão incorreto
Schema duplicado por cadeia
- docs.protocol.com has SoftwareApplication schema
- docs-bnb.protocol.com tem schema duplicado com outra chain
- docs-arbitrum.protocol.com has third copy
- Os extratores de IA veem 3 informações conflitantes sobre o mesmo produto
- Nível de confiança reduzido para os 3
O padrão correto
Um canônico, visualizações de chain parametrizadas
- docs.protocol.com é o canônico com schema completo
- docs-bnb.protocol.com aponta o canonical para docs.protocol.com
- As páginas por chain reutilizam a mesma referência @id
- Os dados específicos de cada chain vão no array identifier, não em um schema separado
- Os extratores de IA veem um único produto com deploys específicos por chain
{ "@context": "https://schema.org", "@type": "SoftwareApplication", "@id": "https://protocol.com/#sdk", "name": "PROTOCOL SDK", "applicationCategory": "DeveloperApplication", "identifier": [ { "@type": "PropertyValue", "propertyID": "deployment-ethereum", "value": "0xETH...ADDR" }, { "@type": "PropertyValue", "propertyID": "deployment-bsc", "value": "0xBSC...ADDR" }, { "@type": "PropertyValue", "propertyID": "deployment-arbitrum", "value": "0xARB...ADDR" } ] }
Quando as implementações realmente diferem
Se o SDK realmente difere entre chains (métodos diferentes, comportamento de gas diferente, modelo de segurança diferente), é aceitável usar canonicals separados com um atributo de chain no estilo hreflang. Na maioria dos produtos multichain, a implementação é a mesma e um único canonical vence.
Ferramentas e testes de validação
A validação de schema é um processo de três etapas. Cada ferramenta captura diferentes classes de problemas. As três deveriam passar antes de fazer deploy de mudanças de schema em produção.
Google Rich Resultados Test
Captura problemas específicos do Google: propriedades obrigatórias ausentes para elegibilidade de rich results, uso de propriedades obsoletas, avisos de structured data. Grátis em search.google.com/test/rich-results. Use essa ferramenta para URLs ao vivo e snippets de código.
Validador de schema.org
Detecta a precisão genérica do schema: uso de tipos inválidos, propriedades obrigatórias ausentes, referências @id malformadas e erros de parsing de JSON-LD. Grátis em validator.schema.org. Use como verificação cruzada depois de passar no teste do Google.
Crawlux Schema de tokens Tester
Catches crypto-specific issues: wrong type for token pages (Product instead of FinancialProduct), missing recommended properties for FinancialProduct and CryptoExchange, inconsistent schema across templates. Free at the página do verificador.
O workflow de validação
Generate schema in code, paste into Google Rich Resultados Test, fix any errors. Cross-check in Validador de schema.org, fix any warnings. Test the live URL through Crawlux Schema de tokens Tester for crypto-specific checks. Se os três passarem, o schema funciona.
Erros comuns de schema
Cinco erros de schema aparecem em quase toda auditoria de site crypto. Cada um tem um ajuste específico; coletivamente respondem pela maioria das falhas de citações relacionadas a schema.
Error 01 · Product genérico en páginas de token
O erro de SEO crypto mais comum
- Páginas de informações de token com schema Product
- Os extratores de IA classificam como mercadoria, não como instrumento financeiro
- Perda de elegibilidade para rich results em categorias cripto
Correção
FinancialProduct com categoria Cryptocurrency
- Mude o @type para FinancialProduct
- Adicione category Cryptocurrency
- Inclua o array identifier com o endereço do contrato e a chain
Error 02 · sameAs faltante en Person
Páginas de equipe com aparência anônima
- Person schema without LinkedIn, GitHub, Twitter
- Os sinais de confiança YMYL não conseguem verificar a identidade
- Os sinais de autor de E-E-A-T são rejeitados
Correção
Adicione array sameAs em cada Person
- URL do LinkedIn (a de maior peso para o Google)
- URL do GitHub (sinal de confiança cripto)
- Twitter or Mastodon URL
Erro 03 · Schema apenas na renderização JS
JSON-LD insertado por JavaScript
- Schema gerado no cliente com React ou Vue
- 69% dos crawlers de IA não conseguem executar JS
- Schema invisível para a maioria dos extratores de IA
Correção
Renderize o schema no servidor, no HTML inicial
- Next.js getStaticProps or getServerSideProps
- Vue: ssrContext ou Nuxt estático
- Entregue o JSON-LD na resposta HTML inicial
Erro 04 · Schema duplicado entre templates
Uso inconsistente de tipo
- A página de token A usa FinancialProduct
- A página de token B usa Product (template mais antigo)
- Os extratores de IA veem inconsistência e reduzem a confiança
Correção
Centralize a geração de schema
- Um utilitário getSchema por tipo de página
- Usado em todos os templates desse tipo
- Audite os templates existentes em busca de inconsistências
Error 05 · Referencias @id faltantes
Entidades desconectadas
- FinancialProduct mentions provider Organization
- Sem referência @id ligando à entidade Organization real
- Os extratores de IA não conseguem resolver as relações entre entidades
Correção
Use @id de forma consistente entre entidades
- Cada Organization recebe um @id estável
- Cada Person recebe um @id estável
- Referencie o @id a partir das entidades relacionadas
The companion Crypto SEO Guide cobre o schema no contexto mais amplo da auditoria. O Guia de visibilidade em IA explica como os extratores de IA usam especificamente o schema para decidir o que citar.
Perguntas comuns
Oito perguntas de seleção e validação de schema que surgem com mais frequência.
Que tipo de schema devo usar em uma página de informações de token?
FinancialProduct é o tipo de schema correto para páginas de informação de token. Diz aos motores de busca e extratores de IA que essa página descreve um instrumento financeiro, não um produto genérico. Propriedades obrigatórias: name, description, category. Adições recomendadas: tickerSymbol, marketCapitalization (numérico), priceCurrency, feesAndCommissionsSpecification, provider (Organization). Evite o schema Product genérico em páginas de token; é o erro de SEO crypto mais comum.
Quando devo usar CryptoExchange e quando FinancialProduct?
CryptoExchange descreve a própria plataforma; FinancialProduct descreve ativos individuais. Homepage da exchange e páginas de preços: CryptoExchange. Páginas específicas de landing de token na exchange: FinancialProduct. Páginas de par de trading: ItemList contendo entradas FinancialProduct. Os dois schemas podem coexistir em um site, aplicados a diferentes templates de página.
Qual é o schema correto para a página de um app de carteira?
SoftwareApplication com applicationCategory FinanceApplication é o tipo correto para páginas de wallet. Inclui operatingSystem (iOS, Android, Chrome Extension), offers (Free com priceCurrency USD), aggregateRating se você tiver reviews de loja, downloadUrl apontando para a App Store e a Play Store. O mesmo tipo SoftwareApplication com applicationCategory DeveloperApplication funciona para páginas de documentação de SDK e API.
Preciso de schema Organization e Person ao mesmo tempo?
Sim, para sinais E-E-A-T. O schema Organization vai na homepage e na página About descrevendo a própria entidade do projeto. O schema Person vai em páginas de equipe com sameAs vinculando a LinkedIn, GitHub, Twitter para cada membro nomeado da equipe. Os sinais YMYL crypto ponderam fortemente a identidade do fundador; projetos com fundadores anônimos têm dificuldade para pontuar em E-E-A-T independentemente do SEO técnico. O schema Person com links sameAs verificados é a implementação técnica dos sinais E-E-A-T de autoria.
Como lidar com documentação multichain no schema?
Mantenha o schema canônico na versão primária agnóstica de chain. Os subdomínios por chain (docs-bnb, docs-arbitrum) deveriam usar o mesmo schema SoftwareApplication com o mesmo name e a mesma URL canônica apontando para a versão primária. Evite duplicar o schema em URLs específicas de chain; isso cria fatos conflitantes que os extratores de IA vão ponderar como baixa confiança. Mesmo canônico, mesmo schema, visualizações de chain parametrizadas.
Quais validadores de schema devo usar?
Use three validators sequentially. Google Rich Resultados Test catches Google-specific issues. Validador de schema.org catches generic schema correctness. The Crawlux Schema de tokens Tester detecta problemas específicos de cripto, como tipo errado em páginas de tokens, propriedades recomendadas ausentes em FinancialProduct e schema inconsistente entre templates. Os três devem passar antes de publicar mudanças de schema.
Does schema work for AI search if Google does not index the page?
Sim. A indexação do Google e as citações de busca por IA são caminhos independentes. ChatGPT, Perplexity e Claude fazem crawl independentemente do Google. O schema parseado em tempo de crawl é adicionado às bases de dados de extração de IA independentemente do status de indexação do Google. Uma página bloqueada para o Google, porém rastreável por bots de IA, ainda se beneficia do schema correto. Permita tanto o Google quanto os bots de IA no robots.txt para cobertura completa.
Posso usar vários tipos de schema em uma página?
Sim, padrão comum. Uma página de informação de token pode usar FinancialProduct (o próprio token) mais Organization (o projeto) mais FAQPage (a seção FAQ) mais BreadcrumbList. Use @graph para envolver múltiplas entidades em um único bloco JSON-LD. Cada entidade recebe seu próprio @type e @id. Os extratores de IA lidam com múltiplas entidades de forma limpa quando estão envolvidas em @graph; ficam confusos quando as entidades estão duplicadas em blocos JSON-LD separados.
FAÇA SUA PRIMEIRA AUDITORIA GRÁTIS
Veja o Crawlux no seu próprio site crypto.
Sem cadastro, sem cartão de crédito. Relatório completo de auditoria ajustada para Web3 em 60 segundos.
Primeira auditoria grátis · Sem cadastro · 60 segundos · Relatório PDF completo