Organization JSON-LD — エージェント向けのエンティティグラフ

Organization JSON-LDとは？

Organization JSON-LDは、ホームページに置く <script type="application/ld+json"> ブロックで、あなたの会社やサービスをschema.orgの Organization エンティティとして宣言します。機械に対して「このドメインはこの名前付きエンティティを表し、そのエンティティが存在する他の場所はここにあります」と伝える正規の方法です。

<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ブロックに有効なHTTPS URLが少なくとも2つ含まれる sameAs 配列がある

両方ともオプション — 存在しなくても合格スコアを下げません — ですが、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 用に1つ、Organization 用に1つ。ほとんどのリッチリザルトツールは両方を処理します。

仕様の成熟度

確立された標準。 schema.orgの Organization と sameAs は成熟し、広く採用され、主要な検索エンジンとAIエージェントすべてによってサポートされています。GoogleのRich Results Testが検証し、ナレッジパネルに関するGoogleの記事では主要なアイデンティティシグナルとして挙げられています。

agentgrade