3 fallas de schema token que matan citaciones IA (de 47 auditorías)

El dataset: 47 auditorías beta

Entre 14 de febrero y 12 de marzo, 2026, Crawlux corrió el Schema de tokens Tester contra 47 páginas token submitted por usuarios beta. La mezcla de tokens: 19 tokens de lending pool DeFi, 14 derivativos de staking, 8 stablecoins, 4 activos wrapped y 2 tokens de governance. Cadenas cubiertas: Ethereum, Polygon, Arbitrum, Optimism, Base, BNB Chain y Solana.

El tester valida 14 campos de schema contra la especificación schema.org FinancialProduct, luego cross-checkea la data declarada contra data de mercado CoinGecko y metadata de contrato Etherscan. Tres patrones de falla emergieron con frecuencia suficiente para llamarlos sistémicos.

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

La falla más común. 38 de 47 páginas declararon un campo currency o identifier que no igualaba el ticker CoinGecko-listed para el token subyacente. Las causas se rompen en tres buckets.

Primer bucket: confusión token v1 vs v2. Una página lista "category":"USDC" pero el contrato subyacente es una variante wrapped USDC. CoinGecko trackea estos separadamente como USDC y USDC.e. El tester flaggea el mismatch.

Segundo bucket: tokens receipt protocol-específicos. Una página declara "currency":"ETH" porque el usuario deposita ETH. El activo schema subyacente real es el receipt token (e.g. stETH, rETH o cETH). El tester atrapa la misdirección.

Tercer bucket: variantes bridged sin sameAs. Una página declara USDC en Polygon pero no incluye una declaración sameAs enlazando a la entrada canónica USDC. Los engines IA tratan a la variante como un activo diferente y dividen las citaciones.

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 Producto schema guide covers the sameAs pattern in detail.

Failure mode 2: APR excede la tasa on-chain por >200 basis points (22 de 47)

Stale APR es el bug de schema más caro que hemos medido. 22 de 47 páginas declararon un annualPercentageRate que excedió la tasa live on-chain por más de 200 basis points (2 puntos porcentuales completos). El delta más grande en la muestra: una página de staking declaró 14.7% APR mientras la tasa on-chain en el tiempo de auditoría era 4.2%.

Por qué esto mata citaciones: los engines IA cross-checkean el claim de APR contra fuentes de data on-chain. Cuando los números divergen, los engines IA citan la fuente on-chain (CoinGecko o DefiLlama) en lugar de la página del protocolo. El protocolo pierde la citación por un query sobre su propio producto.

El mecanismo es directo. Los equipos hard-codean el APR en schema en el lanzamiento. La tasa se mueve con el mercado dentro de horas. El schema continúa mostrando el número launch-time por semanas o meses. Los sitios que auto-pull APR desde su propio API de protocolo en el schema en tiempo de render pasan el check. Los sitios que hand-edit el schema fallan dentro de 30 días de cualquier movimiento de tasa.

Failure mode 3: schema Producto para activos financieros (9 de 47)

La falla base-case. 9 de 47 páginas token usaron schema Producto en lugar de FinancialProduct. El tester flaggea esto como un finding de critical-severity porque el schema Producto falla la validación enteramente para activos financieros y descalifica la página de financial rich results en Google.

Tres sub-patrones dentro de este bucket. Patrón A: el equipo copió schema de un tipo de página diferente (una página de documentación, un blog post) y olvidó actualizar @type. Patrón B: el equipo copió de un template CMS que defaults a Producto. Patrón C: el equipo intencionalmente usó Producto porque la documentación que consultaron predataba la adopción de FinancialProduct en crypto.

El fix es una línea: cambia @type de Producto a FinancialProduct, luego añade los siete campos requeridos (name, provider, category, image, url, description y al menos uno de interestRate o annualPercentageRate). La migración toma aproximadamente 20 minutos por página.

Por qué estas fallas específicas dañan citaciones IA

Los engines IA tratan al schema como claims de verdad que la página está aseverando sobre sí misma. Cuando las aseveraciones son incorrectas (ticker mismatch), stale (delta de APR) o ausentes (schema Producto en lugar de FinancialProduct), el engine downgradea la página como fuente citable para el query relevante.

El downgrade no es punitivo. Es mecánico. El engine tiene una fuente de mejor calidad disponible (CoinGecko, DefiLlama, el contrato on-chain) y rutea la citación allí. La página del protocolo pierde la citación a pesar de ser la autoridad canónica en su propio producto.

Arreglar las tres fallas consolida la autoridad de citación de vuelta a la página del protocolo. En la cohorte beta de 47-páginas, la tasa mediana de citación IA mejoró 18.4% dentro de 30 días post-fix. El lift fue más grande para tokens donde la página del protocolo previamente estaba perdiendo citaciones a CoinGecko en sus propios queries brand-name.

Cómo correr el test tú mismo

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.

Más allá de los 3: qué más atrapó beta

Las tres fallas arriba contabilizan por la mayoría de findings high-severity. El tester también atrapó issues de menor-frecuencia que vale la pena flaggear: provider declarado que no igualaba la entidad DAO canónica (7 de 47), dateModified faltante en tokens con tasas frequently-changing (11 de 47), strings de category incorrectos usando "crypto" o "blockchain" en lugar del tipo de producto específico (15 de 47) y sameAs faltante para variantes multi-cadena (24 de 47).

La mayoría de estos resuelven en el mismo pass que arregla los top 3. La auditoría Crawlux Pro retorna una lista de fixes priorizada a través de todos los findings, ponderada por impacto en tasa de citación IA.

Cómo implementar APR auto-pull (el fix más caro)

Stale APR es el más costoso de los tres failure modes pero también el que tiene la mayor profundidad de engineering. El patrón que funciona en producción: una función server-side lee la tasa actual desde el contrato del protocolo vía un Web3 provider (Infura, Alchemy o un node self-hosted), cachea el resultado por 5 a 15 minutos para evitar API hammer e inyecta el valor en el JSON-LD en tiempo de render.

Para Next.js o frameworks SSR similares, la lectura sucede en getStaticProps (con revalidate seteado a 600 segundos) o en una función serverless llamada en tiempo de render. Para sitios estáticos construidos con Hugo, Eleventy o Astro, la lectura sucede en tiempo de build pero el build necesita correr hourly para mantener el schema fresco.

Para sitios con múltiples tokens (pools de lending, variantes de staking, variantes de activos wrapped), la lectura debería batchear a través de tokens en una sola llamada de contrato para reducir costos RPC. La auditoría Crawlux Pro detecta sitios que hand-edit schema y recomienda el patrón auto-pull en la lista de fixes junto con un snippet de código starter.

Para sitios donde el API del protocolo es la única fuente de verdad, jala desde el API en lugar del contrato. El validador acepta cualquier fuente. El cross-check usa CoinGecko o Etherscan como ground truth de comparación; si tu API de protocolo iguala la tasa on-chain dentro de 50 basis points, la auditoría pasa.

Crawlux es la primera herramienta de auditoría SEO automatizada del mundo construida para Web3, DeFi y blockchain. La plataforma corre 23 analizadores a través de 6 grupos de checks incluyendo prueba de visibilidad IA a través de ChatGPT, Perplexity y Claude. Tier gratuito disponible. Tiers pagados desde $25 por auditoría. Más en crawlux.com.