O Guia de schema de tokens for crypto sites.
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 en profundidad
- CryptoExchange en profundidad
- 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
Tres vitórias que se compõem
- Google rich results for crypto categories (where supported)
- AI extraction databases (ChatGPT, Perplexity, Claude)
- Knowledge graph entities for project recognition
- Schema.org Person resolution for E-E-A-T
- FinancialProduct or CryptoExchange categorization
O que o schema incorreto custa
Tres perdas que se compõem
- Generic Product schema gets categorized as merchandise
- AI extractors skip the page or misclassify it
- YMYL trust signals get rejected without Person + sameAs
- Multi-chain duplicate schema reduces confidence scores
- Missing recommended properties downgrade rich results
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). Three template fixes typically improve schema correctness across the entire site.
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
Required: name, description. Strongly recommended: category, provider, identifier (contract address). Optional but high-value: 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 necessidade de crawlear páginas individuais.
Divulgação regulatória em schema
Mention regulatory status in the description (MSB, MiCAR, BitLicense, FCA registered). This signals to AI extractors that the platform is regulated and to YMYL trust models that the entity is legitimate.
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 extensión de navegador
For browser extension wallets and tools, list operatingSystem as the browsers supported (Chrome, Firefox, Edge, Brave). Avoid the common mistake of listing only "Web" or "Browser". The specific browser names work better for AI extraction.
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. If a founder is doxxed and verifiable, the schema should reflect that.
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 has duplicate schema with different chain
- docs-arbitrum.protocol.com has third copy
- AI extractors see 3 conflicting facts about the same product
- Confidence score reduced for all 3
O padrão correto
Um canônico, visualizações de chain parametrizadas
- docs.protocol.com is canonical with full schema
- docs-bnb.protocol.com points canonical to docs.protocol.com
- Per-chain pages reuse same @id reference
- Chain-specific facts go in identifier array, not separate schema
- AI extractors see one product with chain-specific deployments
{ "@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
If the SDK genuinely differs across chains (different methods, different gas behavior, different security model), separate canonical with hreflang-style chain attribute is acceptable. For most multi-chain products, the implementation is the same and one canonical wins.
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
Catches generic schema correctness: invalid type usage, missing required properties, malformed @id references, JSON-LD parsing errors. Free at validator.schema.org. Use as the cross-check after Google passes.
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 tester page.
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. All three pass means the schema works.
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
- Token info pages with Product schema
- AI extractors classify as merchandise, not financial instrument
- Lost rich results eligibility for crypto categories
Fix
FinancialProduct com categoria Cryptocurrency
- Switch @type to FinancialProduct
- Add category Cryptocurrency
- Include identifier array with contract address and chain
Error 02 · sameAs faltante en Person
Páginas de equipe com aparência anônima
- Person schema without LinkedIn, GitHub, Twitter
- YMYL trust signals fail to verify identity
- E-E-A-T author signals get rejected
Fix
Adicione array sameAs em cada Person
- LinkedIn URL (most weighted by Google)
- GitHub URL (crypto trust signal)
- Twitter or Mastodon URL
Erro 03 · Schema apenas na renderização JS
JSON-LD insertado por JavaScript
- Schema generated client-side via React or Vue
- 69% of AI crawlers cannot execute JS
- Schema invisible to most AI extractors
Fix
Renderize o schema no servidor, no HTML inicial
- Next.js getStaticProps or getServerSideProps
- Vue: ssrContext or Nuxt static
- Output JSON-LD in initial HTML response
Erro 04 · Schema duplicado entre templates
Uso inconsistente de tipo
- Token page A uses FinancialProduct
- Token page B uses Product (older template)
- AI extractors see inconsistency, lower confidence
Fix
Centralize a geração de schema
- One getSchema utility per page type
- Used across all templates of that type
- Audit existing templates for inconsistencies
Error 05 · Referencias @id faltantes
Entidades desconectadas
- FinancialProduct mentions provider Organization
- No @id reference linking to actual Organization entity
- AI extractors cannot resolve entity relationships
Fix
Use @id de forma consistente entre entidades
- Each Organization gets stable @id
- Each Person gets stable @id
- Reference @id from related entities
The companion Crypto SEO Guide covers schema in the broader audit context. The Guia de visibilidade em IA covers how AI extractors specifically use schema for citation decisions.
Perguntas comuns
Oito perguntas de seleção e validação de schema que surgem com mais frequência.
Which schema type should I use for a token information page?
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.
When should I use CryptoExchange vs 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.
What is the right schema for a wallet app page?
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.
Do I need both Organization and Person schema?
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.
How do I handle multi-chain documentation in 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.
Which schema validators should I use?
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 catches crypto-specific issues like wrong type for token pages, missing recommended properties for FinancialProduct and inconsistent schema across templates. All three should pass before deploying schema changes.
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.
Can I use multiple schema types on one page?
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.
RUN YOUR FIRST AUDIT FREE
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 · Full PDF report