NUEVOYa está disponible la primera herramienta de auditoría de visibilidad en IA para Web3 del mundo.Haz una auditoría gratis →
CompararSobre nosotrosClientesSociosPrensaEstadoDocsRegístrate
Módulo de auditoría · 04 · Referencia + Herramienta

Auditoría de schema de tokens. La referencia completa del JSON-LD cripto.

Los sitios crypto necesitan markup schema.org que los motores de búsqueda y modelos IA realmente entiendan: FinancialProduct, CryptoExchange, SoftwareApplication y data Organization crypto-aware. Esto es tanto el módulo de auditoría como la referencia abierta. Copia lo que necesites, corre la auditoría cuando quieras validarlo end-to-end.

Explora la biblioteca de schemas
5 schema types7 protocol templatesValidated against schema.org & Google Rich Resultados
63%de los sitios cripto que auditamos no incluye ningún schema específico de cripto. La mayoría solo tiene marcado genérico WebSite o BreadcrumbList.Cifra ilustrativa basada en patrones de auditorías de clientes de TG3
~12sto ship a complete FinancialProduct JSON-LD block from this library to a Next.js page using the App Router metadata API.Time-to-paste, not time-to-validate
+18ptsaverage AEO score lift after shipping FinancialProduct + Organization sameAs schema on a Web3 site.Ilustrativo; varía considerablemente según el sitio
// The library

JSON-LD copy-paste para los siete patrones crypto más comunes

Cada ejemplo está anotado con lo que hace cada campo, por qué importa y el error más común que marcamos en auditorías. Escoge el patrón que coincide con tu sitio, pégalo, rellena tus valores reales.

Pattern · DeFi lending pool

FinancialProduct para un mercado de lending

Usa esto en la página que representa un solo mercado de lending o pool (ej. /markets/usdc o /pools/aave-eth). El patrón estilo Aave: un FinancialProduct por mercado, cada uno apuntando de vuelta al Organization del protocolo como provider.

Errores comunes que marcamos

  • Putting all markets in one FinancialProduct entity instead of one per market
  • interestRate codificado como número en lugar de un QuantitativeValue con unidad
  • Falta feesAndCommissionsSpecification (se pierde la elegibilidad para rich results)
  • provider como string simple en lugar de una referencia a Organization
defi-lending-market.jsonld
{
  "@context": "https://schema.org",
  "@type": "FinancialProduct",
  "@id": "https://example.com/markets/usdc#product",
  "name": "USDC Lending Market",
  "description": "Supply USDC to earn variable yield. Borrow USDC against ETH or BTC collateral.",
  "category": "Decentralized lending",
  "interestRate": {
    "@type": "QuantitativeValue",
    "value": 4.82,
    "unitText": "PERCENT_PER_YEAR",
    "valueReference": "Variable APY, updated per block"
  },
  "feesAndCommissionsSpecification": "Reserve factor: 10%. No deposit or withdrawal fees. Borrowers pay variable interest set by utilization curve.",
  "provider": {
    "@type": "Organization",
    "@id": "https://example.com/#organization",
    "name": "Example Protocol",
    "url": "https://example.com/"
  },
  "audience": {
    "@type": "Audience",
    "audienceType": "DeFi users with self-custody wallets"
  },
  "areaServed": "Worldwide, subject to jurisdictional restrictions"
}
Patrón · Exchange descentralizado

CryptoExchange para un DEX

Para una interface de swap (patrón Uniswap, Curve, PancakeSwap). Usa CryptoExchange en la página principal del protocolo y páginas por pool. El array supportedAssets es lo que desambigua "AAVE el token" de "Aave el protocolo" para los modelos IA.

Errores comunes que marcamos

  • Usar FinancialProduct en lugar de CryptoExchange para interfaces de swap
  • Array supportedAssets vacío (el campo más valioso para cripto)
  • fee codificado como string en lugar de feesAndCommissionsSpecification
  • Falta currenciesAccepted, que los modelos de IA usan mucho
dex-swap.jsonld
{
  "@context": "https://schema.org",
  "@type": "CryptoExchange",
  "@id": "https://example.com/#exchange",
  "name": "Example DEX",
  "description": "Decentralized AMM exchange supporting ETH, ERC-20 and bridged assets across L2s.",
  "url": "https://example.com/",
  "currenciesAccepted": ["ETH", "USDC", "USDT", "DAI", "WBTC"],
  "supportedAssets": [
    { "@type": "Thing", "name": "Ethereum (ETH)", "sameAs": "https://www.coingecko.com/en/coins/ethereum" },
    { "@type": "Thing", "name": "USD Coin (USDC)", "sameAs": "https://www.coingecko.com/en/coins/usd-coin" }
  ],
  "feesAndCommissionsSpecification": "Swap fee: 0.30% per trade, paid to liquidity providers. No protocol fee. Gas paid by user.",
  "areaServed": "Worldwide, excluding sanctioned jurisdictions",
  "provider": { "@id": "https://example.com/#organization" }
}
Patrón · Derivado de liquid staking

FinancialProduct para liquid staking (patrón Lido / Rocket Pool)

Para productos de staking que acuñan un derivativo (stETH, rETH). Usa FinancialProduct con el yield de staking como interestRate. Haz el token derivativo explícito en la descripción porque los modelos IA de otro modo lo confunden con el underlying.

Errores comunes que marcamos

  • Listing the underlying asset (ETH) instead of the derivative (stETH) as the product
  • Falta la descripción del mecanismo de rebase o de recompensas
  • No se informa el tiempo de salida / unstaking (una gran preocupación de los usuarios que los modelos de IA destacan)
  • sameAs de provider sin la página del conjunto de validadores
liquid-staking.jsonld
{
  "@context": "https://schema.org",
  "@type": "FinancialProduct",
  "name": "Liquid Staked ETH (stETH)",
  "description": "Stake ETH and receive stETH, a liquid derivative that accrues staking rewards via daily rebases. Tradable on DEXs and usable as DeFi collateral.",
  "category": "Liquid staking derivative",
  "interestRate": {
    "@type": "QuantitativeValue",
    "value": 3.4,
    "unitText": "PERCENT_PER_YEAR",
    "valueReference": "Variable APR based on Ethereum validator rewards"
  },
  "feesAndCommissionsSpecification": "Protocol fee: 10% of staking rewards. No staking minimum. No lock-up; unstake via withdrawal queue (typically 1-5 days) or swap stETH on a DEX instantly.",
  "provider": { "@id": "https://example.com/#organization" },
  "audience": {
    "@type": "Audience",
    "audienceType": "ETH holders seeking yield without running a validator"
  }
}
Pattern · NFT marketplace

Híbrido CryptoExchange + Producto para marketplace NFT

Los marketplaces NFT se sientan incómodamente en schema.org. Recomendamos CryptoExchange para el marketplace en sí más schema Producto en páginas individuales de colección o item. supportedAssets se vuelve las cadenas soportadas.

Errores comunes que marcamos

  • Schema WebSite genérico en lugar de CryptoExchange en la página principal del marketplace
  • Falta el soporte de chains en supportedAssets (Ethereum, Polygon, Solana, etc.)
  • Comisión de regalías ausente en feesAndCommissionsSpecification
  • Páginas de colección sin schema Product
nft-marketplace.jsonld
{
  "@context": "https://schema.org",
  "@type": "CryptoExchange",
  "name": "Example NFT Market",
  "description": "NFT marketplace for digital art, gaming items and collectibles across Ethereum, Polygon and Base.",
  "url": "https://example.com/",
  "currenciesAccepted": ["ETH", "MATIC", "USDC"],
  "supportedAssets": [
    { "@type": "Thing", "name": "Ethereum NFTs (ERC-721, ERC-1155)" },
    { "@type": "Thing", "name": "Polygon NFTs" },
    { "@type": "Thing", "name": "Base NFTs" }
  ],
  "feesAndCommissionsSpecification": "Marketplace fee: 2.5% of sale. Creator royalties enforced on-chain per collection. Gas paid by user."
}
Patrón · Wallet de autocustodia

SoftwareApplication para un wallet Web3

Para wallets self-custody, wallets de hardware y wallets crypto móviles. SoftwareApplication es el tipo correcto porque el wallet es software, no un producto financiero. Añade operatingSystem y offers explícitamente para que los rich results de app store funcionen.

Errores comunes que marcamos

  • Usar Product en lugar de SoftwareApplication (se pierde la elegibilidad para resultados enriquecidos de apps)
  • Falta el campo operatingSystem
  • Sin applicationCategory (FinanceApplication es el valor correcto para wallets)
  • aggregateRating sin un reviewCount que coincida con las reseñas reales
crypto-wallet.jsonld
{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "Example Wallet",
  "description": "Self-custody multi-chain wallet for Ethereum, Solana, Bitcoin and 30+ EVM networks. Built-in dApp browser and hardware wallet support.",
  "applicationCategory": "FinanceApplication",
  "applicationSubCategory": "Cryptocurrency wallet",
  "operatingSystem": "iOS, Android, macOS, Windows, Linux",
  "offers": {
    "@type": "Offer",
    "price": "0",
    "priceCurrency": "USD"
  },
  "featureList": [
    "Self-custody seed phrase storage",
    "Multi-chain support across 30+ EVM networks",
    "WalletConnect v2 dApp integration",
    "Hardware wallet support (Ledger, Trezor)"
  ],
  "publisher": { "@id": "https://example.com/#organization" }
}
Patrón · Exchange centralizado

CryptoExchange + Organization para un CEX

Para exchanges centralizados (patrón Binance, Coinbase, Kraken). Schema CryptoExchange con divulgación regulatoria completa dentro de feesAndCommissionsSpecification y areaServed. Los modelos IA jalan info de jurisdicción de estos campos pesadamente.

Errores comunes que marcamos

  • areaServed vago como "Global" sin listar las jurisdicciones excluidas
  • Faltan las licencias regulatorias en la descripción
  • currenciesAccepted como string de texto libre en lugar de array
  • Sin sameAs de Organization hacia el registro mercantil o el listado del regulador
cex.jsonld
{
  "@context": "https://schema.org",
  "@type": "CryptoExchange",
  "name": "Example Exchange",
  "description": "Regulated centralized cryptocurrency exchange. Spot trading, margin and futures across 200+ assets. Licensed in EU (MiCA) and registered with FinCEN as an MSB.",
  "url": "https://example.com/",
  "currenciesAccepted": ["USD", "EUR", "GBP", "BTC", "ETH", "USDT", "USDC"],
  "feesAndCommissionsSpecification": "Spot trading: 0.10% maker / 0.20% taker. Volume tiers reduce to 0.00% / 0.04%. Withdrawal fees vary by network. Full schedule at /fees.",
  "areaServed": ["European Union", "United Kingdom", "Australia", "Canada"],
  "provider": { "@id": "https://example.com/#organization" }
}
Patrón · Organization del protocolo + Person del fundador

Organization + Person con cadena sameAs completa

Este es el schema que auditamos más duro en términos YMYL. Organization con sameAs a GitHub, Twitter, CoinGecko, DefiLlama y reportes de firmas auditoras. Person founders con su propia cadena sameAs. Ambos anidan bajo el @graph para la homepage.

Errores comunes que marcamos

  • sameAs de Organization sin CoinGecko ni DefiLlama (gran fallo de AEO)
  • Schema Person del fundador ausente en las páginas /team/
  • URLs de sameAs que dan 404 o redirigen (la auditoría revisa cada enlace)
  • Citas de firmas auditoras como enlaces simples en lugar de destinos sameAs
org-and-founder.jsonld
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Organization",
      "@id": "https://example.com/#organization",
      "name": "Example Protocol",
      "url": "https://example.com/",
      "logo": "https://example.com/logo.png",
      "sameAs": [
        "https://twitter.com/exampleprotocol",
        "https://github.com/exampleprotocol",
        "https://discord.gg/exampleprotocol",
        "https://www.coingecko.com/en/coins/example",
        "https://defillama.com/protocol/example",
        "https://github.com/exampleprotocol/audits"
      ],
      "founder": { "@id": "https://example.com/team/jane-doe#person" }
    },
    {
      "@type": "Person",
      "@id": "https://example.com/team/jane-doe#person",
      "name": "Jane Doe",
      "jobTitle": "Co-founder & CTO, Example Protocol",
      "description": "Smart contract engineer. Previously security researcher at OpenZeppelin. Lead author of Example Protocol's lending architecture.",
      "sameAs": [
        "https://twitter.com/janedoe",
        "https://github.com/janedoe",
        "https://www.linkedin.com/in/janedoe"
      ],
      "worksFor": { "@id": "https://example.com/#organization" }
    }
  ]
}
// Cómo se ve un hallazgo de auditoría

Un hallazgo típico de token schema de una auditoría Crawlux

Esto es aproximadamente cómo se ve cada problema de schema en el reporte PDF. Rating de severidad, causa raíz, el fix y el snippet JSON-LD listo para enviar.

● HIGHFinding 04 of 23 · Schema de tokens
example-protocol.com / markets/usdc

Schema FinancialProduct faltante en páginas de mercado de lending

Las 14 páginas de mercado de lending en el dominio les falta JSON-LD FinancialProduct. Solo está presente schema genérico WebPage.

  • Search engines and AI models cannot identify the page as a lending product
  • El activo que se presta y la tasa de interés no son legibles por máquinas
  • Se pierde la elegibilidad para resultados enriquecidos de FinancialProduct
  • La probabilidad de cita AEO cae en consultas como "mejor APY de préstamo en USDC"
SeveridadAlta · impacto en ranking + AEO
Esfuerzo~1 hour · template-able
Páginas afectadas14 lending markets

→ Corrección recomendada

Añade un bloque JSON-LD FinancialProduct a cada página de mercado usando el patrón DeFi Lending de la biblioteca de schema arriba. Jala interestRate dinámicamente de tu oráculo de tasas existente. Referencia el Organization del protocolo vía @id en lugar de inlinear la data de provider.

Hallazgo ilustrativo basado en patrones comunes observados en auditorías de clientes de TG3, no un resultado real de un escaneo de Crawlux.
// Crawlux vs. las alternativas

Crawlux vs Schema.org Validator vs herramientas SEO genéricas

Tres cosas que podrías usar para validación de schema crypto hoy. Aquí está lo que cada uno captura, lado a lado, en las dimensiones que importan para un sitio Web3.

CapacidadSchema.org ValidatorGoogle Rich Resultados TestAhrefs / SemrushCrawlux
Validates JSON-LD syntactically✓ Estricto✓ Estricto~ Solo superficial✓ Estricto
Valida específicamente FinancialProduct + CryptoExchange~ Solo genérico✕ Not crypto-aware✕✓ Ajustado a cripto
Audita todo el dominio a la vez✕ One URL✕ One URL✓✓
Mapa de cobertura de schema por página✕✕~✓
Verifica que las URLs de sameAs devuelvan 200✕✕✕✓
Validates supportedAssets + currenciesAccepted~ Verifica que el campo exista, no su valor✕✕✓
Detecta FinancialProduct usado donde corresponde CryptoExchange✕✕✕✓
Reconocimiento de entidades por token / por pool✕✕✕✓
JSON-LD vs Microdata vs RDFa coexistence audit~~✕✓
SPA / client-side schema render check✕~ Single URL✕✓
Recomienda la corrección exacta con snippet listo para copiar✕✕✕✓
Informe PDF con correcciones priorizadas✕✕~ Exportación genérica✓
PreciosGratisGratisSuscripción de $99-449/mes$0 / $25 / $49 por auditoría
// Cómo se ejecuta la auditoría

Qué pasa cuando corres la auditoría de token schema

Cuatro verificaciones secuenciales. El módulo entero típicamente completa en menos de 12 segundos, corriendo en paralelo con los otros siete módulos de auditoría.

  1. 01

    Fetch y render

    Chrome headless descarga cada URL descubierta por el módulo de rastreo. JavaScript se renderiza por completo. Extraemos todos los bloques script[type="application/ld+json"] además de cualquier microdata o RDFa inline para contrastar.

  2. 02

    Parsear y clasificar

    Cada bloque JSON-LD es parseado contra schema.org. Clasificamos cada entidad por @type y etiquetamos la página por las combinaciones de schema presentes. Las entidades no en schema.org son marcadas pero no penalizadas.

  3. 03

    Validación crypto-específica

    Las entidades FinancialProduct, CryptoExchange y SoftwareApplication corren a través de reglas adicionales afinadas para Web3. supportedAssets faltante, interestRate mal formado y mismatches de provider todos marcados aquí.

  4. 04

    Verificación de vitalidad de sameAs

    Cada URL sameAs en entidades Organization y Person es recuperada. Enlaces muertos (404, 410, cadenas de redirect) marcados. URLs de perfil de CoinGecko, DefiLlama y CoinMarketCap cross-verificadas para match de entidad.

// Token schema Preguntas frecuentes

Preguntas de schema, respondidas

Preguntas comunes de devs y equipos SEO enviando schema en sitios crypto.

¿Qué tipos de schema necesitan los sitios cripto?

La mayoría de los sitios crypto necesitan una combinación de FinancialProduct (para protocolos DeFi, lending, yield, staking), CryptoExchange (para DEXs y CEXs), SoftwareApplication (para wallets y dApps), Organization (para la entidad de empresa con enlaces sameAs), Person (para fundadores y autores) y FAQPage (para documentación y páginas de producto). Cada tipo de schema señala hechos diferentes a los motores de búsqueda y modelos IA.

The biblioteca de arriba cubre los siete patrones más comunes que implementamos para clientes.

¿FinancialProduct es el schema correcto para un protocolo DeFi?

FinancialProduct es el tipo schema.org más cercano para la mayoría de los productos DeFi, incluyendo pools de lending, vaults de yield y productos de staking. Soporta campos interestRate, feesAndCommissionsSpecification y provider que mapean bien a DeFi. Para productos puramente de swap/exchange, usa CryptoExchange en su lugar. Para los tokens de governance del protocolo en sí, la comunidad de schema todavía está estableciendo la mejor práctica; la mayoría de los sitios usan una combinación de FinancialProduct en la página de producto y Organization en la página principal del protocolo.

¿Google ignorará mi schema si uso el tipo equivocado?

Google no penaliza schema incorrecto, pero ignorará markup que no valida o que mal usa los campos requeridos. El riesgo mayor es la elegibilidad para rich results: un FinancialProduct mal formado no ganará el rich result. Los modelos IA como ChatGPT y Perplexity son incluso más estrictos; tienden a ignorar JSON-LD que no parsea limpiamente, lo cual significa que tu data factual no influencia las respuestas. Validar con Schema.org Validator y Rich Resultados Test de Google es esencial.

¿El JSON-LD debe ir en el head o en el body?

Either works for Google, but head is the standard. Place schema in <script type="application/ld+json"> en el head del documento siempre que sea posible. En sitios SPA donde el schema se genera del lado del cliente, asegúrate de que el JSON-LD se renderice antes de que Googlebot agote el tiempo (en ~5 segundos) o usa renderizado del lado del servidor. Crawlux marca las páginas donde el schema se inyecta tarde o solo del lado del cliente.

How do I add schema to a Next.js or React Web3 site?

En Next.js, el enfoque más limpio es schema por página usando next/head or the App Router's metadata API, with the schema object stringified into a script tag. For React SPAs, use react-helmet-async para inyectar schema en el head del documento. Lo crítico es que el schema esté en el HTML renderizado, no solo hidratado del lado del cliente; de lo contrario, los crawlers de IA y muchas herramientas SEO no lo verán.

¿Qué es sameAs y por qué importa en cripto?

sameAs es una propiedad de Organization o Person que enlaza tu entidad a sus perfiles en otros sitios. Para crypto, sameAs debería apuntar a tu Twitter, GitHub, Discord, CoinGecko, CoinMarketCap, DefiLlama y otras fuentes de autoridad reconocidas. Esta es una de las señales de autoridad más fuertes que puedes enviar e influencia directamente la probabilidad de citas IA. La auditoría de Crawlux verifica específicamente que cada URL sameAs retorne 200 y que el perfil enlazado sea consistente con tu marca.

¿Pueden coexistir varios bloques JSON-LD en una página?

Sí. Una sola página puede tener múltiples bloques de script JSON-LD, o un solo bloque con @graph conteniendo múltiples entidades. El enfoque @graph es más limpio y usualmente preferido. Una página típica de producto DeFi podría combinar FinancialProduct (el producto), Organization (el protocolo), BreadcrumbList (la navegación) y FAQPage (la Preguntas frecuentes de producto) en un bloque @graph. Crawlux valida cada entidad independientemente y reporta problemas por entidad.

¿Necesito schema si mi sitio ya posiciona?

El schema es cada vez más importante para búsqueda IA incluso cuando el SEO tradicional está bien. ChatGPT, Perplexity y Claude todos usan structured data pesadamente al decidir qué fuentes citar. Un sitio que rankea #1 en Google todavía puede ser invisible en respuestas IA si su JSON-LD está faltante o incorrecto. Para crypto específicamente, donde la cuota de búsqueda IA está creciendo rápido, el schema faltante cada vez cuesta más tráfico que los rankings de Google solos no capturan.

Cobertura de schema relacionada

// Cobertura reciente

CORRE ESTA AUDITORÍA GRATIS

Corre esta auditoría en tu sitio crypto.

Sin registro, sin tarjeta de crédito. Reporte completo de 8 módulos en 60 segundos.

Primera auditoría gratis · Sin registro · 60 segundos · Informe PDF completo