BotKelp

BotKelp のコンポーネント

BotKelp が実際に使用している個々のコンポーネントの公開ソースです。

これらのファイルは、閲覧、コピー、再利用できます。それがこのリポジトリの目的です。

提供するもの

components/ 配下の各フォルダーが、1つのコンポーネントです。

• manifest.json — ID、変更不可の semver、requires / provides、compatibility の範囲、npm パッケージ、ジェネレーターのアクション
• templates/ — ジェネレーターが適用するファイル（EJS テンプレート。ほとんどはテンプレート構文を含まない通常のソースです）
• versions/<semver>/（任意）— 追加の変更不可リリース。最上位の manifest.json は常に最新です。古いリリースは versions/ 配下に保存されるため、2.0.2 を公開しても 1.4.2 が上書きされることはありません。

compatibility はレジストリの厳格なルールであり、エージェントが推測するものではありません。例：

"compatibility": { "nextjs": ">=16 <17", "react": ">=19 <20" }

BotKelp MCP は (component, version, stack) を照会し、次のように動作します。

1. バージョンが一致し、互換性がある → その成果物を返します
2. バージョンが一致し、互換性がない → COMPONENT_VERSION_INCOMPATIBLE と代替候補を返します — ファイルは返しません
3. バージョンが指定されていない → 互換性のある最適なリリースを自動選択します
4. allow_incompatible: true → 警告付きで指定バージョンを返します。ただし、compatible: false のままです

同じリストは CATALOG.md と catalog.json にもあります。

このリポジトリは、BotKelp のコンポーネントカタログの信頼できる唯一の情報源です。MCP ジェネレーターとウェブサイトは、非公開のコピーではなく、このファイル群を読み込みます。これはデモでも、整理された抜粋でもありません。

提供しないもの

• 完全なアプリケーションではありません。 このリポジトリをクローンしても、動作するサイトは得られません。
• 組み立て済み／生成済みのプロジェクトビルドではありません。 BotKelp MCP ツール purchase_scaffold が構築するスキャフォールド（複数のコンポーネントがあらかじめ連携された完全なアプリ）は、ここでは公開されていません。
• BotKelp のサービスではありません。 MCP サーバー、課金、アカウント、生成エンジンは別の場所にあり、このリポジトリには含まれていません。

生成済みのプロジェクトが必要な場合は、エージェントを https://www.botkelp.com/mcp の BotKelp MCP サーバーに接続し（リモート HTTP。npm パッケージや stdio サーバーはありません）、get_help と search_components を呼び出してコンポーネント ID を選び、その後 purchase_scaffold を呼び出してください。ビルドにはアカウントのクレジットを使用します（MCP OAuth でサインインするか、https://www.botkelp.com/dashboard の bk_live_ キーを Authorization: Bearer ヘッダーとして送信してください。ツールの引数としては決して送信しないでください）。課金はビルドが成功した場合にのみ発生します。各クライアントのセットアップ方法：https://www.botkelp.com/llms.txt

ナビゲーションバー、Supabase クライアント、Tailwind 設定をコピーしたい場合は、このリポジトリを使用してください。

コンポーネントをコピーする方法

1. components/<id>/ を開きます。
2. manifest.json で npm パッケージと環境変数を確認します。
3. templates/ 配下のファイルを、マニフェストに記載された destination パスに従ってアプリにコピーします。
4. 記載されている dependencies / devDependencies をインストールします。
5. コンポーネントがラップしている上流ライブラリ（Next.js、Tailwind、shadcn/ui、Supabase など）のライセンスを遵守してください。それぞれのライセンスは引き続き個別に適用されます。

nextjs-base は、ほかのコンポーネントが基盤として使用するベースコンポーネントです。これも1つのコンポーネントであり、完全なビルドとして提供する製品アプリではありません。

ライセンス

BotKelp が作成したファイルには、BotKelp Limited Use Licence が適用されます。

INTLEACHT RESEARCH LIMITED trading as BotKelp は、すべてのファイルに記載されています。個々のコンポーネントのソースは、ご自身のプロジェクトにコピーできます。このカタログやジェネレーターを自社製品として提示することはできません。また、ここで公開されているファイルから運営者の帰属表示を削除することもできません。

コンポーネント内で名前が挙げられているサードパーティーのプロジェクトには、それぞれ独自のライセンスが適用されます。コンポーネントをコピーしても、Next.js、Tailwind、Prisma などのライセンスが変更されることはありません。

サイト

BotKelp のウェブサイトにあるレジストリには、同じコンポーネントがコピー可能なファイル内容とともに掲載されています。 repo: https://github.com/botkelp/components