## Organization JSON-LDとは？

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

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

## 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ブロックに有効な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](/kb/ja/bazaar)の掲載

公開され、正規で、安定しているサーフェスを選びます。ダッシュボード、ログインページ、コンテンツをゲートするサーフェスにはリンクしないでください。

## どこに配置するか

ホームページの `<head>` に配置します。複数のJSON-LDブロックを持つことができます — `WebApplication` や `WebSite` 用に1つ、`Organization` 用に1つ。ほとんどのリッチリザルトツールは両方を処理します。

## 仕様の成熟度

**確立された標準。** 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/ja/skills)
- [llms.txt](/kb/ja/llms-txt)
- [OpenAPI](/kb/ja/openapi)
