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 スキャフォールディングと validate・dev・build・sync・admin・migrate コマンド
• @takuhon/activity — 開発者アクティビティのスナップショット(GitHub の言語・コントリビューション、WakaTime の時間)とアクティビティバッジ
• @takuhon/mcp — AI エージェントがプロフィールを読めるリードオンリーの Model Context Protocol サーバー

@takuhon/cloudflare アダプターはこれらの上に Workers + KV 向けに構築されます。ビルド済みの 静的出力(takuhon build)・read-only の @takuhon/vercel アダプター・WordPress プラグイン (Phase 1)が現在利用可能です。

インストール

npm install -g takuhon

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

---

Takuhon は Apache-2.0 のオープンソースです。ソースは GitHub に、パッケージは npm に公開されています。takuhon.json スキーマは 1.0.0 で安定契約として凍結されています(スキーマの安定性 を参照)。マイナーリリースでは、この契約を壊さずに機能が追加されていきます。