Organization JSON-LD —— 给代理的实体图谱

什么是 Organization JSON-LD？

Organization JSON-LD 是放在你主页上的 <script type="application/ld+json"> 块，它把你的公司或服务声明为 schema.org 的 Organization 实体。这是向机器宣告"这个域名代表这个命名实体,而这个实体在 Web 上还存在于这些其他地方"的标准方式。

<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>

什么是 sameAs？

sameAs 是一种关联数据声明,意思是"这里描述的实体与这些其他 URL 所指向的是同一个实体"。它是机器把散落各处的曲面(你的 GitHub、你的 npm 包、你的 LinkedIn、你的注册中心列表)合并为知识图谱中单一实体所采用的方式。

没有 sameAs,每个曲面在爬虫看来都像一个孤立的孤儿。有了它,你的权威性和身份信号就被整合在一起。

为什么这对 AI 代理很重要

LLM 驱动的助手(ChatGPT 浏览、Claude、Perplexity、通过 Google 索引访问的 Gemini)在回答之前非常依赖实体消歧。当用户问"acme.example 是什么?"时,模型会：

在它的实体索引中查找该域名
拉取所有被 sameAs 标记的曲面 —— 你的代码、社交、包、注册中心列表
构建一个统一的画面:"这是该公司,这是他们出品的东西,这是经营它的人"

JSON-LD 是对代理最友好的结构化数据格式 —— 它能挺过 HTML 到文本的转换(微数据属性在转换中会被剥掉),而且本身就是可直接解析的 JSON。Schema.org 是所有主流模型在训练时都接触过的词汇表。

agentgrade 检查什么

Organization JSON-LD(可选)—— 主页上的某个 JSON-LD 块声明 @type: Organization
sameAs entity links(可选)—— 该 Organization 块包含一个 sameAs 数组,其中至少有两个有效的 HTTPS URL

两个检查都是可选的 —— 缺失不会拉低合格分数 —— 但对于任何希望 AI 助手准确谈论自己的网站来说,都强烈推荐。

sameAs 里要链接什么

sameAs 的目的是列出同一实体的权威档案。好的候选：

代码:你的 GitHub 组织、GitLab、公开仓库
包:npm、PyPI、crates.io、Maven Central、RubyGems
身份:X/Twitter、LinkedIn 公司页面、Mastodon、Bluesky
注册中心:Crunchbase、Wikidata、Wikipedia 词条
代理曲面:你在 Model Context Protocol Registry、Smithery、x402 Bazaar 上的列表

挑选那些公开、规范、稳定的曲面。不要链接到仪表盘、登录页面或对内容设门槛的曲面。

放在哪里

放在主页的 <head> 里。你可以有多个 JSON-LD 块 —— 一个用于 WebApplication 或 WebSite,一个用于 Organization。大多数富结果工具都能处理两者。

规范成熟度

已确立的标准。 schema.org 的 Organization 和 sameAs 已经成熟,被广泛采用,所有主流搜索引擎和 AI 代理都支持。Google 的 Rich Results Test 会校验它们,而 Google 的知识面板文章把它们列为主要的身份信号。

agentgrade