はじめる

Takuhon は、あなたのプロフィールをポータブルな takuhon.json ドキュメントに変換し、モバイルファーストのページ・JSON API・JSON-LD として配信します。このページでは、ゼロからデプロイ済みプロフィールまでを案内します。仕組みの前にまずモデルを理解したい場合は、先にポータブルなプロフィールを読んでください。

1. プロフィールをスキャフォールドする

npx --package=@takuhon/cli create-takuhon my-profile

これは my-profile/ に最小限の Cloudflare Workers プロジェクトをセットアップします: スターターの takuhon.json、wrangler.toml、Worker のエントリーポイント、そしてプロフィールデータに適用するコンテンツライセンスを選ぶためのプロンプトです。前提条件とグローバルインストールの代替手段についてはインストールを参照してください。

2. プロフィールを編集する

あなたのプロフィールは 1 つの canonical なファイル takuhon.json に存在します — bio・リンク・職歴・スキルを追加してください。完全な構造と多言語フィールドの形式については takuhon.json ファイルを参照してください。

3. エッジにデプロイする

生成されたプロジェクトは Wrangler で Cloudflare Workers にデプロイします: KV ネームスペースを作成し、admin トークンを設定し、wrangler deploy を実行します。完全なデプロイフロー・ルート・admin API は @takuhon/cloudflare アダプターの README に記載されています。

デプロイ後、プロフィールは /(および各言語の /<locale>/)でサーバーレンダリングされたページとして — 検索エンジンや AI エージェント向けに Schema.org JSON-LD を埋め込んだ状態で — /api/profile で JSON として、/api/jsonld で単体の JSON-LD として配信されます。

次のステップ

ポータブルなプロフィール — Takuhon の背後にある考え方
AI と検索のための JSON-LD
アダプター — プロフィールが動く場所
takuhon.json ファイル