The Guía de schema de tokens for crypto sites.
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
- 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
Lo que el schema incorrecto cuesta
Tres pérdidas que se componen
- Generic Producto 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
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). Three template fixes typically improve schema correctness across the entire site.
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
Required: name, description. Strongly recommended: category, provider, identifier (contract address). Optional but high-value: 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
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 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). Avoid the common mistake of listing only "Web" or "Browser". The specific browser names work better for AI extraction.
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. If a founder is doxxed and verifiable, the schema should reflect that.
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 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
El patrón correcto
Un canónico, vistas de cadena 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" } ] }
Cuando las implementaciones realmente difieren
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.
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
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 (Producto instead of FinancialProduct), missing recommended properties for FinancialProduct and CryptoExchange, inconsistent schema across templates. Free at the tester page.
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. All three pass means the schema works.
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
- Token info pages with Producto schema
- AI extractors classify as merchandise, not financial instrument
- Lost rich results eligibility for crypto categories
Fix
FinancialProduct con categoría 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 equipo con apariencia anónima
- Person schema without LinkedIn, GitHub, Twitter
- YMYL trust signals fail to verify identity
- E-E-A-T author signals get rejected
Fix
Añade array sameAs en cada Person
- LinkedIn URL (most weighted by Google)
- GitHub URL (crypto trust signal)
- Twitter or Mastodon URL
Error 03 · Schema solo en render 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
Server-renderiza el schema en HTML inicial
- Next.js getStaticProps or getServerSideProps
- Vue: ssrContext or Nuxt static
- Output JSON-LD in initial HTML response
Error 04 · Schema duplicado a través de plantillas
Uso inconsistente de tipo
- Token page A uses FinancialProduct
- Token page B uses Producto (older template)
- AI extractors see inconsistency, lower confidence
Fix
Centraliza la generación 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
Usa @id consistentemente a través de 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 Guía de visibilidad en IA covers how AI extractors specifically use schema for citation decisions.
Preguntas comunes
Ocho preguntas de selección y validación de schema que surgen más a menudo.
Which schema type should I use for a token information page?
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.
When should I use CryptoExchange vs 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.
What is the right schema for a wallet app page?
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.
Do I need both Organization and Person schema?
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.
How do I handle multi-chain documentation in 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.
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?
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.
Can I use multiple schema types on one page?
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.
RUN YOUR FIRST AUDIT FREE
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 · Full PDF report