## 什么是 Organization JSON-LD？ Organization JSON-LD 是放在你主页上的 ` ``` ## 什么是 sameAs？ `sameAs` 是一种关联数据声明,意思是"这里描述的实体与这些其他 URL 所指向的是同一个实体"。它是机器把散落各处的曲面(你的 GitHub、你的 npm 包、你的 LinkedIn、你的注册中心列表)合并为知识图谱中单一实体所采用的方式。没有 `sameAs`,每个曲面在爬虫看来都像一个孤立的孤儿。有了它,你的权威性和身份信号就被整合在一起。 ## 为什么这对 AI 代理很重要 LLM 驱动的助手(ChatGPT 浏览、Claude、Perplexity、通过 Google 索引访问的 Gemini)在回答之前非常依赖实体消歧。当用户问"acme.example 是什么?"时,模型会： 1. 在它的实体索引中查找该域名 2. 拉取所有被 `sameAs` 标记的曲面 —— 你的代码、社交、包、注册中心列表 3. 构建一个统一的画面:"这是该公司,这是他们出品的东西,这是经营它的人" 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](/kb/zh/bazaar) 上的列表挑选那些公开、规范、稳定的曲面。不要链接到仪表盘、登录页面或对内容设门槛的曲面。 ## 放在哪里放在主页的 `` 里。你可以有多个 JSON-LD 块 —— 一个用于 `WebApplication` 或 `WebSite`,一个用于 `Organization`。大多数富结果工具都能处理两者。 ## 规范成熟度 **已确立的标准。** schema.org 的 `Organization` 和 `sameAs` 已经成熟,被广泛采用,所有主流搜索引擎和 AI 代理都支持。Google 的 Rich Results Test 会校验它们,而 Google 的 [知识面板文章](https://developers.google.com/search/docs/appearance/structured-data/article) 把它们列为主要的身份信号。 ## 了解更多 - [schema.org/Organization](https://schema.org/Organization) - [schema.org/sameAs](https://schema.org/sameAs) - [Google:Logo 结构化数据](https://developers.google.com/search/docs/appearance/structured-data/logo) ## 相关 - [SKILL.md](/kb/zh/skills) - [llms.txt](/kb/zh/llms-txt) - [OpenAPI](/kb/zh/openapi)