JSON-LD for AI and search

Takuhon publishes your profile as JSON-LD structured data, so AI agents, search engines, and other machines can read it unambiguously — not just render it.

Schema.org output

The GET /api/jsonld endpoint emits a Schema.org ProfilePage that wraps a Person as its mainEntity:

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

Mapping your data

Fields in takuhon.json map to Schema.org properties. A few examples:

takuhon.json field	Schema.org property
profile.displayName	name
profile.bio	description
profile.avatar.url	image
current careers[].role	jobTitle
current careers[].organization	worksFor
identity-bearing links[] (e.g. github, website)	sameAs (excludes email, rss, custom)
education[]	alumniOf

Locale resolution

GET /api/jsonld?lang=ja returns values already resolved to the requested locale as single strings; hreflang is emitted on the HTML side. This keeps the structured data clean for consumers that expect one language per document.