Takuhon

Takuhon とは

Takuhon を使うと、プロフィール — bio・ソーシャルリンク・職歴・プロジェクト・ スキル — を 1 つのポータブルな JSON ドキュメントとして所有し、モバイルファースト のプロフィールページに加えて公開 API として、さらに AI エージェントや検索エンジン 向けの JSON-LD として公開できます。

canonical なデータは、あなた自身のサーバー上にある 1 つの takuhon.json ファイルに 存在します。ストレージバックエンド — Cloudflare KV、静的ファイル、その他 — はアダプター 経由で差し替え可能なので、プロフィールが単一のプラットフォームに固定されることは ありません。

なぜ “Takuhon (拓本)” なのか?

Takuhon (拓本) という名は、2000 年の歴史を持つ技法に由来します。石碑に紙を 押し当て、原本のポータブルな拓(rubbing)を写し取る技法です。石はその場に留まり、 紙はその写しをどこへでも運びます。

• 原本は不変 — ある時点でのあなたの経歴と物語。石碑の刻印のように。
• 写しはポータブル — takuhon.json は拓そのもの。API・JSON-LD・プロフィールページへと運ばれます。
• 写しはプラットフォームより長く生き残る — プラットフォームが終了しても、あなたの takuhon.json は残ります。

パッケージ

• @takuhon/core — JSON Schema、バリデーション、ロケール解決、JSON-LD 生成、ストレージインターフェース
• @takuhon/api — Hono ベースの HTTP ハンドラと RFC 7807 エラーエンベロープ
• @takuhon/ui — React 製のモバイルファーストなプロフィール UI
• @takuhon/cli — create-takuhon スキャフォールディングとプロフィールコマンド

プラットフォームアダプター(Cloudflare、Vercel、WordPress、Static)はこれらの上に 構築されます。

インストール

npm install -g takuhon

その後プロフィールをスキャフォールドし、完全な手順は はじめる を参照してください。

---

Takuhon は Apache-2.0 のオープンソースです。ソースは GitHub に、パッケージは npm に公開されています。現在活発に開発中 (Phase 1)で、API やデータ構造はまだ変わる可能性があります。