La Guía de schema de tokens para sitios crypto.
La selección de schema es el fix SEO y AEO de mayor apalancamiento porque es binario, rápido y raramente se hace correctamente en sitios crypto. Esta guía cubre cada tipo JSON-LD relevante para crypto con ejemplos copy-paste, el árbol de decisión para elegir el tipo correcto por página y el patrón de manejo canónico multi-cadena.
Tabla de contenidos
- Por qué la corrección de schema importa para crypto
- El árbol de decisión de schema por tipo de página
- FinancialProduct en profundidad
- CryptoExchange en profundidad
- SoftwareApplication para wallets y SDKs
- Organization y Person para E-E-A-T
- Manejo de canónico multi-cadena
- Herramientas y pruebas de validación
- Errores comunes de schema
Por qué la corrección de schema importa para crypto
Schema.org es el vocabulario de structured data que los motores de búsqueda y extractores IA usan para entender qué describe una página. El schema incorrecto significa que el motor clasifica mal la página; la página o rankea más bajo o es ignorada del todo para las consultas que debería servir.
Para crypto específicamente, la corrección de schema se compone a través de tres caminos de citas.
Lo que el schema correcto habilita
Tres victorias que se componen
- Rich results de Google para categorías cripto (donde se admiten)
- AI extraction databases (ChatGPT, Perplexity, Claude)
- Entidades del knowledge graph para el reconocimiento del proyecto
- Resolución de Person de Schema.org para E-E-A-T
- Categorización como FinancialProduct o CryptoExchange
Lo que el schema incorrecto cuesta
Tres pérdidas que se componen
- El schema Product genérico se categoriza como mercancía
- Los extractores de IA omiten la página o la clasifican mal
- Las señales de confianza YMYL se rechazan sin Person + sameAs
- El schema duplicado entre cadenas reduce los niveles de confianza
- La falta de propiedades recomendadas degrada los resultados enriquecidos
El fix individual de mayor apalancamiento
Audit token pages for FinancialProduct (not generic Producto), exchange pages for CryptoExchange (not generic Organization), wallet pages for SoftwareApplication (not generic Producto). Tres correcciones de plantilla suelen mejorar la corrección del schema en todo el sitio.
El árbol de decisión de schema por tipo de página
Elegir el tipo de schema correcto es directo una vez que conoces las reglas. Cada página en un sitio crypto cae en una de siete categorías. Cada categoría tiene un tipo de schema primario correcto.
Páginas de información de token → FinancialProduct
Páginas describiendo un token específico: tokenomics, supply, market cap, dirección del contrato. La página describe un instrumento financiero, no un producto.
Páginas de plataforma de exchange → CryptoExchange
Iniciopage y páginas de precios de plataformas CEX o DEX. La página describe una plataforma de trading con activos soportados y tarifas de trading.
Apps de wallet → SoftwareApplication
Páginas describiendo apps de wallet: features, cadenas soportadas, enlaces de descarga. El applicationCategory debería ser FinanceApplication para wallets.
SDKs y APIs → SoftwareApplication
Herramientas de desarrollador, librerías, documentación de API. El applicationCategory debería ser DeveloperApplication. Incluye propiedades operatingSystem y codeRepository.
Páginas Sobre nosotros de la empresa → Organization
Página Sobre nosotros, página de equipo (padre), historial de la empresa. Incluye foundingDate, array founders, address, enlaces sameAs a perfiles sociales.
Páginas de equipo y fundador → Person
Páginas individuales de miembros del equipo o secciones dentro de la página de equipo. Siempre incluye sameAs enlazando a LinkedIn, GitHub, Twitter para verificación E-E-A-T.
Artículos y guías → Article o TechArticle
Blog posts, documentación, guías como esta. TechArticle para contenido técnico; Article para posts generales. Incluye author, datePublished, dateModified.
Las páginas compuestas combinan múltiples tipos de schema usando @graph. Una página de información de token a menudo incluye FinancialProduct (el token), Organization (el proyecto) y FAQPage (la sección FAQ). El wrapper @graph maneja esto limpiamente.
FinancialProduct en profundidad
FinancialProduct es el tipo correcto para páginas de información de token. Las propiedades requeridas son name y description. Las adiciones recomendadas abajo mejoran significativamente la calidad de extracción 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" } ] }
Tres patrones hacen que este ejemplo funcione. Primero, el array identifier usa PropertyValue para exponer la dirección del contrato y la cadena como hechos estructurados. Segundo, provider enlaza el token a su entidad Organization usando referencia @id. Tercero, interestRate expone APY como un QuantitativeValue (no texto libre), que los extractores IA parsean limpiamente.
Recomendaciones de propiedades
Obligatorias: name, description. Muy recomendadas: category, provider, identifier (dirección del contrato). Opcionales pero de alto valor: feesAndCommissionsSpecification, interestRate, alternateName (ticker).
CryptoExchange en profundidad
CryptoExchange describe la plataforma de trading misma. Úsalo en la homepage, páginas de precios y páginas de descripción de plataforma. Para páginas individuales de landing de token en el exchange, usa FinancialProduct en su lugar.
{ "@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" ] }
El patrón hasOfferCatalog te permite exponer activos soportados directamente en el schema. Cada Offer envuelve un FinancialProduct. Los extractores IA usan esto para responder prompts "¿soporta EXCHANGE a TOKEN?" directamente sin necesidad de crawlear páginas individuales.
Divulgación regulatoria en schema
Menciona el estado regulatorio en la descripción (MSB, MiCAR, BitLicense, registro FCA). Esto indica a los extractores de IA que la plataforma está regulada y a los modelos de confianza YMYL que la entidad es legítima.
SoftwareApplication para wallets y SDKs
SoftwareApplication es el tipo correcto para cualquier software instalable u hosteado. Para crypto específicamente, cubre wallets, SDKs, clientes de protocolo, extensiones de navegador y APIs. La propiedad applicationCategory diferencia los 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, cambia applicationCategory a DeveloperApplication y añade codeRepository apuntando al repo de GitHub. El enlace al repositorio dobla como señal de frescura porque los motores IA ponderan la actividad activa de GitHub fuertemente para señales de confianza 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). Evita el error común de listar solo "Web" o "Browser". Los nombres específicos de navegadores funcionan mejor para la extracción por IA.
Organization y Person para E-E-A-T
El schema Organization describe la entidad del proyecto mismo. El schema Person describe miembros individuales del equipo. Ambos importan para E-E-A-T (Experience, Expertise, Authoritativeness, Trustworthiness), que Google pondera fuertemente en 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" ] }
El schema Person va en páginas de equipo con una entidad Person por miembro del equipo. El array sameAs es la propiedad más importante: los enlaces a LinkedIn, GitHub, Twitter verifican que la persona es real y está activa en la comunidad 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 qué 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. Si un fundador está doxxeado y es verificable, el schema debe reflejarlo.
Manejo de canónico multi-cadena
La documentación multi-cadena es donde la mayoría de sitios crypto pierden la corrección de schema. El patrón que funciona: mantén el schema canónico a la versión primaria agnóstica de cadena. Los subdominios por-cadena usan el mismo schema con la misma URL canónica.
El patrón incorrecto
Schema duplicado por cadena
- docs.protocol.com has SoftwareApplication schema
- docs-bnb.protocol.com tiene schema duplicado con otra cadena
- docs-arbitrum.protocol.com has third copy
- Los extractores de IA ven 3 datos contradictorios sobre el mismo producto
- Nivel de confianza reducido para los 3
El patrón correcto
Un canónico, vistas de cadena parametrizadas
- docs.protocol.com es el canónico con schema completo
- docs-bnb.protocol.com apunta su canonical a docs.protocol.com
- Las páginas por cadena reutilizan la misma referencia @id
- Los datos específicos de cada cadena van en el array identifier, no en un schema separado
- Los extractores de IA ven un solo producto con despliegues específicos por cadena
{ "@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" } ] }
Cuando las implementaciones realmente difieren
Si el SDK realmente difiere entre cadenas (métodos distintos, comportamiento de gas distinto, modelo de seguridad distinto), es aceptable usar canonicals separados con un atributo de cadena tipo hreflang. En la mayoría de los productos multicadena, la implementación es la misma y gana un solo canonical.
Herramientas y pruebas de validación
La validación de schema es un proceso de tres pasos. Cada herramienta captura diferentes clases de problemas. Las tres deberían pasar antes de desplegar cambios de schema a producción.
Google Rich Resultados Test
Captura problemas específicos de Google: propiedades requeridas faltantes para elegibilidad de rich results, uso de propiedades obsoletas, advertencias de structured data. Gratis en search.google.com/test/rich-results. Úsalo para URLs en vivo y snippets de código.
Validador de schema.org
Detecta la corrección genérica del schema: uso de tipos inválidos, propiedades obligatorias faltantes, referencias @id mal formadas y errores de parseo de JSON-LD. Gratis en validator.schema.org. Úsalo como verificación cruzada después de pasar la de Google.
Crawlux Schema de tokens Tester
Catches crypto-specific issues: wrong type for token pages (Producto instead of FinancialProduct), missing recommended properties for FinancialProduct and CryptoExchange, inconsistent schema across templates. Free at the página del verificador.
El workflow de validación
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. Si los tres pasan, el schema funciona.
Errores comunes de schema
Cinco errores de schema aparecen en casi cada auditoría de sitio crypto. Cada uno tiene un fix específico; colectivamente cuentan por la mayoría de las fallas de citas relacionadas con schema.
Error 01 · Producto genérico en páginas de token
El error de SEO crypto más común
- Páginas de info de token con schema Product
- Los extractores de IA lo clasifican como mercancía, no como instrumento financiero
- Se pierde la elegibilidad para rich results en categorías cripto
Solución
FinancialProduct con categoría Cryptocurrency
- Cambia @type a FinancialProduct
- Agrega category con el valor Cryptocurrency
- Incluye el array identifier con la dirección del contrato y la cadena
Error 02 · sameAs faltante en Person
Páginas de equipo con apariencia anónima
- Person schema without LinkedIn, GitHub, Twitter
- Las señales de confianza YMYL no logran verificar la identidad
- Las señales de autor E-E-A-T se rechazan
Solución
Añade array sameAs en cada Person
- URL de LinkedIn (la de mayor peso para Google)
- URL de GitHub (señal de confianza cripto)
- Twitter or Mastodon URL
Error 03 · Schema solo en render JS
JSON-LD insertado por JavaScript
- Schema generado en el cliente con React o Vue
- El 69% de los crawlers de IA no puede ejecutar JS
- Schema invisible para la mayoría de los extractores de IA
Solución
Server-renderiza el schema en HTML inicial
- Next.js getStaticProps or getServerSideProps
- Vue: ssrContext o Nuxt estático
- Publica el JSON-LD en la respuesta HTML inicial
Error 04 · Schema duplicado a través de plantillas
Uso inconsistente de tipo
- La página de token A usa FinancialProduct
- La página de token B usa Product (plantilla antigua)
- Los extractores de IA ven inconsistencia y bajan la confianza
Solución
Centraliza la generación de schema
- Una utilidad getSchema por tipo de página
- Usada en todas las plantillas de ese tipo
- Audita las plantillas existentes en busca de inconsistencias
Error 05 · Referencias @id faltantes
Entidades desconectadas
- FinancialProduct mentions provider Organization
- Sin referencia @id que enlace a la entidad Organization real
- Los extractores de IA no pueden resolver las relaciones entre entidades
Solución
Usa @id consistentemente a través de entidades
- Cada Organization recibe un @id estable
- Cada Person recibe un @id estable
- Referencia el @id desde las entidades relacionadas
The companion Crypto SEO Guide cubre el schema en el contexto más amplio de la auditoría. La Guía de visibilidad en IA explica cómo los extractores de IA usan específicamente el schema para decidir qué citar.
Preguntas comunes
Ocho preguntas de selección y validación de schema que surgen más a menudo.
¿Qué tipo de schema debo usar en una página de información de token?
FinancialProduct es el tipo de schema correcto para páginas de información de token. Le dice a los motores de búsqueda y extractores IA que esta página describe un instrumento financiero, no un producto genérico. Propiedades requeridas: name, description, category. Adiciones recomendadas: tickerSymbol, marketCapitalization (numérico), priceCurrency, feesAndCommissionsSpecification, provider (Organization). Evita el schema Product genérico en páginas de token; es el error SEO crypto más común.
¿Cuándo debo usar CryptoExchange y cuándo FinancialProduct?
CryptoExchange describe la plataforma misma; FinancialProduct describe activos individuales. Homepage del exchange y páginas de precios: CryptoExchange. Páginas específicas de landing de token en el exchange: FinancialProduct. Páginas de par de trading: ItemList conteniendo entradas FinancialProduct. Los dos schemas pueden coexistir en un sitio, aplicados a diferentes plantillas de página.
¿Cuál es el schema correcto para la página de una app de wallet?
SoftwareApplication con applicationCategory FinanceApplication es el tipo correcto para páginas de wallet. Incluye operatingSystem (iOS, Android, Chrome Extension), offers (Free con priceCurrency USD), aggregateRating si tienes reviews de tienda, downloadUrl apuntando a la App Store y Play Store. El mismo tipo SoftwareApplication con applicationCategory DeveloperApplication funciona para páginas de documentación de SDK y API.
¿Necesito schema Organization y Person a la vez?
Sí para señales E-E-A-T. El schema Organization va en la homepage y página About describiendo la entidad del proyecto mismo. El schema Person va en páginas de equipo con sameAs enlazando a LinkedIn, GitHub, Twitter para cada miembro del equipo nombrado. Las señales YMYL crypto ponderan la identidad del fundador fuertemente; los proyectos con fundadores anónimos luchan para puntuar E-E-A-T sin importar el SEO técnico. El schema Person con enlaces sameAs verificados es la implementación técnica de las señales E-E-A-T de autor.
¿Cómo gestiono la documentación multicadena en el schema?
Mantén el schema canónico a la versión primaria agnóstica de cadena. Los subdominios por-cadena (docs-bnb, docs-arbitrum) deberían usar el mismo schema SoftwareApplication con el mismo name y la misma URL canónica apuntando a la versión primaria. Evita duplicar el schema a través de URLs específicas de cadena; eso crea hechos conflictivos que los extractores IA ponderarán como baja confianza. Mismo canónico, mismo schema, vistas de cadena parametrizadas.
¿Qué validadores de schema debo 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 el tipo incorrecto en páginas de tokens, propiedades recomendadas faltantes en FinancialProduct y schema inconsistente entre plantillas. Los tres deben pasar antes de desplegar cambios de schema.
Does schema work for AI search if Google does not index the page?
Sí. La indexación de Google y las citas de búsqueda IA son caminos independientes. ChatGPT, Perplexity y Claude crawlean independientemente de Google. El schema parseado en tiempo de crawl se añade a las bases de datos de extracción IA sin importar el estado de indexación de Google. Una página bloqueada de Google pero crawleable por bots IA todavía se beneficia del schema correcto. Permite tanto a Google como a los bots IA en robots.txt para cobertura completa.
¿Puedo usar varios tipos de schema en una página?
Sí, patrón común. Una página de información de token podría usar FinancialProduct (el token mismo) más Organization (el proyecto) más FAQPage (la sección FAQ) más BreadcrumbList. Usa @graph para envolver múltiples entidades en un solo bloque JSON-LD. Cada entidad recibe su propio @type y @id. Los extractores IA manejan múltiples entidades limpiamente cuando están envueltas en @graph; se confunden cuando las entidades están duplicadas a través de bloques JSON-LD separados.
HAZ TU PRIMERA AUDITORÍA GRATIS
Mira Crawlux en tu propio sitio crypto.
Sin registro, sin tarjeta de crédito. Reporte completo de auditoría afinada para Web3 en 60 segundos.
Primera auditoría gratis · Sin registro · 60 segundos · Informe PDF completo