AI と検索のための JSON-LD

Takuhon は、あなたのプロフィールを JSON-LD の構造化データとして公開します。これにより AI エージェント・検索エンジン・その他のマシンは、単に描画するだけでなく、曖昧さなく読み取れます。

Schema.org 出力

GET /api/jsonld エンドポイントは、Person を mainEntity として内包する Schema.org の ProfilePage を出力します:

{
  "@context": "https://schema.org",
  "@type": "ProfilePage",
  "inLanguage": "en",
  "mainEntity": {
    "@type": "Person",
    "name": "Sam Lee",
    "url": "https://example.com",
    "sameAs": ["https://github.com/example"]
  }
}

データのマッピング

takuhon.json のフィールドは Schema.org のプロパティにマッピングされます。いくつかの例:

`takuhon.json` フィールド	Schema.org プロパティ
`profile.displayName`	`name`
`profile.bio`	`description`
`profile.avatar.url`	`image`
現在の `careers[].role`	`jobTitle`
現在の `careers[].organization`	`worksFor`
アイデンティティを表す `links[]`(例: github、website)	`sameAs`(`email`・`rss`・`custom` を除く)
`education[]`	`alumniOf`

ロケール解決

GET /api/jsonld?lang=ja は、要求されたロケールに解決済みの値を単一の文字列として返します。hreflang は HTML 側で出力されます。これにより、1 ドキュメントにつき 1 言語を期待するコンシューマーにとって、構造化データはクリーンに保たれます。