3 falhas de schema de token que matam citações de IA (em 47 auditorias)

O dataset: 47 auditorias beta

Entre 14 de fevereiro e 12 de março de 2026, a Crawlux rodou o Schema de Tokens Tester em 47 páginas de token submitted por usuários beta. A mistura de tokens: 19 tokens de lending pool DeFi, 14 derivativos de staking, 8 stablecoins, 4 ativos wrapped e 2 tokens de governance. Cadeias cobertas: Ethereum, Polygon, Arbitrum, Optimism, Base, BNB Chain e Solana.

O tester valida 14 campos de schema contra a especificação schema.org FinancialProduct, depois faz cross-check dos dados declarados contra dados de mercado do CoinGecko e metadata de contrato do Etherscan. Três padrões de falha emergiram com frequência suficiente para serem chamados de sistêmicos.

Failure mode 1: ticker mismatch com o CoinGecko (38 de 47)

A falha mais comum. 38 de 47 páginas declararam um campo currency ou identifier que não batia com o ticker CoinGecko-listed do token subjacente. As causas se dividem em três buckets.

Primeiro bucket: confusão token v1 vs v2. Uma página lista "category":"USDC" mas o contrato subjacente é uma variante wrapped de USDC. O CoinGecko rastreia isso separadamente como USDC e USDC.e. O tester dá flag no mismatch.

Segundo bucket: tokens receipt específicos de protocolo. Uma página declara "currency":"ETH" porque o usuário deposita ETH. O ativo schema subjacente real é o receipt token (e.g. stETH, rETH ou cETH). O tester pega a misdirection.

Terceiro bucket: variantes bridged sem sameAs. Uma página declara USDC na Polygon mas não inclui uma declaração sameAs linkando para a entrada canônica de USDC. Os engines de IA tratam a variante como um ativo diferente e dividem as citações.

The fix pattern: declare the precise ticker matching the CoinGecko entry, then add sameAs pointing to the parent asset for multi-chain tokens. The FinancialProduct vs Product schema guide covers the sameAs pattern in detail.

Failure mode 2: o APR excede a taxa on-chain em mais de 200 basis points (22 de 47)

Stale APR é o bug de schema mais caro que já medimos. 22 de 47 páginas declararam um annualPercentageRate que excedeu a taxa live on-chain em mais de 200 basis points (2 pontos percentuais completos). O maior delta na amostra: uma página de staking declarava 14,7% de APR enquanto a taxa on-chain no momento da auditoria era 4,2%.

Por que isso mata citações: os engines de IA fazem cross-check do claim de APR contra fontes de dados on-chain. Quando os números divergem, os engines de IA citam a fonte on-chain (CoinGecko ou DefiLlama) em vez da página do protocolo. O protocolo perde a citação para um query sobre o próprio produto.

O mecanismo é direto. As equipes hard-codeiam o APR no schema no lançamento. A taxa se move com o mercado dentro de horas. O schema continua mostrando o número launch-time por semanas ou meses. Sites que fazem auto-pull do APR a partir da própria API do protocolo no schema em tempo de render passam no check. Sites que fazem hand-edit do schema falham dentro de 30 dias de qualquer movimento de taxa.

Failure mode 3: schema Product para ativos financeiros (9 de 47)

A falha base-case. 9 de 47 páginas de token usaram schema Product em vez de FinancialProduct. O tester dá flag nisso como um finding de critical-severity porque o schema Product falha a validação inteiramente para ativos financeiros e desqualifica a página de financial rich results no Google.

Três sub-padrões dentro desse bucket. Padrão A: a equipe copiou schema de um tipo de página diferente (uma página de documentação, um blog post) e esqueceu de atualizar @type. Padrão B: a equipe copiou de um template CMS que faz default para Product. Padrão C: a equipe intencionalmente usou Product porque a documentação que consultou era anterior à adoção de FinancialProduct em crypto.

O fix é de uma linha: mude @type de Product para FinancialProduct, depois adicione os sete campos obrigatórios (name, provider, category, image, url, description e pelo menos um entre interestRate ou annualPercentageRate). A migração leva aproximadamente 20 minutos por página.

Por que essas falhas específicas prejudicam citações de IA

Os engines de IA tratam o schema como claims de verdade que a página está afirmando sobre si mesma. Quando as afirmações estão incorretas (ticker mismatch), stale (delta de APR) ou ausentes (schema Product em vez de FinancialProduct), o engine faz downgrade da página como fonte citável para o query relevante.

O downgrade não é punitivo. É mecânico. O engine tem uma fonte de melhor qualidade disponível (CoinGecko, DefiLlama, o contrato on-chain) e roteia a citação para lá. A página do protocolo perde a citação apesar de ser a autoridade canônica sobre o próprio produto.

Corrigir as três falhas consolida a autoridade de citação de volta para a página do protocolo. Na coorte beta de 47 páginas, a taxa mediana de citação de IA melhorou 18,4% dentro de 30 dias pós-fix. O lift foi maior para tokens onde a página do protocolo antes estava perdendo citações para o CoinGecko em seus próprios queries brand-name.

Como rodar o teste você mesmo

The Schema de tokens Tester is free with no signup. Submit the URL of any token page. The tool runs the 14-field schema validation plus the CoinGecko and Etherscan cross-checks in 3 to 4 seconds. Each domain gets 5 token checks per day. No rate limit on re-runs of the same URL within an hour, which means you can fix and re-test in tight cycles.

For sites with many tokens, the Schema de tokens Audit module in Crawlux Pro runs the same checks across all tokens in one pass and exports a CSV fix-list that engineering can ship in a single PR.

For the announcement of the Schema de tokens Tester and the underlying methodology, see the press release from March 17, 2026.

Além dos 3: o que mais o beta pegou

As três falhas acima respondem pela maioria dos findings high-severity. O tester também pegou issues de menor frequência que vale a pena flaggear: provider declarado que não batia com a entidade DAO canônica (7 de 47), dateModified ausente em tokens com taxas frequently-changing (11 de 47), strings de category incorretos usando "crypto" ou "blockchain" em vez do tipo de produto específico (15 de 47) e sameAs ausente para variantes multi-cadeia (24 de 47).

A maioria desses se resolve na mesma passada que corrige os top 3. A auditoria Crawlux Pro retorna uma lista de fixes priorizada em todos os findings, ponderada pelo impacto na taxa de citação de IA.

Como implementar APR auto-pull (o fix mais caro)

Stale APR é o mais caro dos três failure modes, porém também o que tem a maior profundidade de engineering. O padrão que funciona em produção: uma função server-side lê a taxa atual a partir do contrato do protocolo via um Web3 provider (Infura, Alchemy ou um node self-hosted), cacheia o resultado por 5 a 15 minutos para evitar API hammer e injeta o valor no JSON-LD em tempo de render.

Para Next.js ou frameworks SSR similares, a leitura acontece em getStaticProps (com revalidate configurado para 600 segundos) ou em uma função serverless chamada em tempo de render. Para sites estáticos construídos com Hugo, Eleventy ou Astro, a leitura acontece em tempo de build, porém o build precisa rodar hourly para manter o schema atualizado.

Para sites com múltiplos tokens (pools de lending, variantes de staking, variantes de ativos wrapped), a leitura deveria fazer batch entre tokens em uma única chamada de contrato para reduzir custos de RPC. A auditoria Crawlux Pro detecta sites que fazem hand-edit do schema e recomenda o padrão auto-pull na lista de fixes junto com um snippet de código starter.

Para sites onde a API do protocolo é a única fonte de verdade, puxe da API em vez do contrato. O validador aceita qualquer fonte. O cross-check usa CoinGecko ou Etherscan como ground truth de comparação; se a API do seu protocolo bater com a taxa on-chain dentro de 50 basis points, a auditoria passa.

A Crawlux é a primeira ferramenta de auditoria SEO automatizada do mundo construída para Web3, DeFi e blockchain. A plataforma roda 23 analisadores em 6 grupos de checks, incluindo teste de visibilidade IA via ChatGPT, Perplexity e Claude. Tier gratuito disponível. Tiers pagos a partir de $25 por auditoria. Mais em crawlux.com.