## ¿Qué es Organization JSON-LD?

Organization JSON-LD es un bloque `<script type="application/ld+json">` en tu homepage que declara tu empresa o servicio como una entidad `Organization` de schema.org. Es la forma canónica de decirle a las máquinas: "este dominio representa esta entidad con nombre, y aquí están los otros lugares donde esa entidad existe en la web."

```html
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Acme Robotics",
  "url": "https://acme.example",
  "logo": "https://acme.example/logo.png",
  "description": "Industrial robots for warehouse automation.",
  "sameAs": [
    "https://github.com/acme-robotics",
    "https://www.npmjs.com/package/acme-sdk",
    "https://twitter.com/acmerobotics",
    "https://www.linkedin.com/company/acme-robotics"
  ]
}
</script>
```

## ¿Qué es sameAs?

`sameAs` es la declaración de datos enlazados que dice "la entidad descrita aquí es la misma entidad que la de estas otras URLs." Es como las máquinas consolidan superficies dispersas (tu GitHub, tu paquete de npm, tu LinkedIn, tus listados en registros) en una sola entidad en su grafo de conocimiento.

Sin `sameAs`, cada superficie le parece a un rastreador un huérfano sin relación con las demás. Con él, tus señales de autoridad e identidad se consolidan.

## Por qué importa para los agentes de IA

Los asistentes basados en LLM (ChatGPT navegando, Claude, Perplexity, Gemini vía el índice de Google) dependen fuertemente de la resolución de entidades antes de responder. Cuando un usuario pregunta "¿qué es acme.example?", el modelo:

1. Busca el dominio en su índice de entidades
2. Trae todas las superficies marcadas `sameAs` — tu código, tus redes, tus paquetes, tus listados en registros
3. Construye una imagen unificada: "esta es la empresa, esto es lo que ofrecen, esto es quién la dirige"

JSON-LD es el formato de datos estructurados más accesible para agentes — sobrevive a la conversión de HTML a texto que descarta los atributos microdata, y es JSON directamente parseable. Schema.org es el vocabulario en el que todo modelo importante ha sido entrenado.

## Qué verifica agentgrade

- **Organization JSON-LD** (opcional) — Un bloque JSON-LD en la homepage declara `@type: Organization`
- **sameAs entity links** (opcional) — El bloque Organization incluye un arreglo `sameAs` con al menos dos URLs HTTPS válidas

Ambas verificaciones son opcionales — no penalizan una puntuación aprobatoria si están ausentes — pero son altamente recomendadas para cualquier sitio que quiera que los asistentes de IA hablen sobre él con precisión.

## Qué enlazar en sameAs

El propósito de `sameAs` es listar **perfiles autoritativos para la misma entidad**. Buenos candidatos:

- **Código**: tu organización de GitHub, tu GitLab, tus repositorios públicos
- **Paquetes**: npm, PyPI, crates.io, Maven Central, RubyGems
- **Identidad**: X/Twitter, página de empresa de LinkedIn, Mastodon, Bluesky
- **Registros**: Crunchbase, Wikidata, entrada de Wikipedia
- **Superficies de agentes**: tu listado en el Model Context Protocol Registry, Smithery, el Bazaar de [x402](/kb/es/x402)

Elige superficies que sean públicas, canónicas y estables. No enlaces a paneles, páginas de login o superficies que restrinjan el contenido.

## Dónde colocarlo

En el `<head>` de tu homepage. Puedes tener múltiples bloques JSON-LD — uno para `WebApplication` o `WebSite`, uno para `Organization`. La mayoría de herramientas de resultados enriquecidos manejan ambos.

## Madurez de la especificación

**Estándar establecido.** `Organization` y `sameAs` de schema.org son maduros, ampliamente adoptados y soportados por todos los motores de búsqueda y agentes de IA importantes. El Rich Results Test de Google los valida, y el [artículo de Google sobre paneles de conocimiento](https://developers.google.com/search/docs/appearance/structured-data/article) los enumera como señales primarias de identidad.

## Más información

- [schema.org/Organization](https://schema.org/Organization)
- [schema.org/sameAs](https://schema.org/sameAs)
- [Google: Datos estructurados de Logo](https://developers.google.com/search/docs/appearance/structured-data/logo)

## Relacionado

- [SKILL.md](/kb/es/skills)
- [llms.txt](/kb/es/llms-txt)
- [OpenAPI](/kb/es/openapi)
