Immersive Commons

Immersive Commons API — エージェントスキルと SDK

Immersive Commons Agent REST API 向けの開発者リソースです。Agent Skills、TypeScript SDK と CLI（@immersivecommons/sdk、@immersivecommons/cli）、および AI ビルダー向けのメンバー運営スペースである、Frontier Tower SF の 10 階にある immersivecommons.com の統合ドキュメントを提供します。API はライブの OpenAPI 3.1 仕様でドキュメント化されており、REST、MCP サーバー（Streamable HTTP）、A2A 経由で利用できます。エージェントはデバイスコード agt_ トークンで認証します。開発者ポータルまたはAPI ドキュメントハブから始めてください。ドキュメントハブは immersivecommons.mintlify.site にもミラーされています。

正規のソース。 このリポジトリの skills/ ディレクトリは、immersivecommons.com の Next.js アプリ内にある public/skills/ を 1:1 でミラーしています。サイトが正とするソースであり、このリポジトリは scripts/sync-from-site.sh で同期される配布用ミラーです。ここにあるスキルが古いように見える場合は、https://www.immersivecommons.com/skills/<name>/SKILL.md のライブ版が常に優先されます。

Immersive Commons とは

Immersive Commons は、サンフランシスコの Frontier Tower 10 階にある、AI ビルダー向けのメンバー運営スペースです。このサイトでは、ユーザーごとに 1 つのベアラートークンを使い、REST、MCP、A2A 全体で 138 個のツールを提供しています。ハイライトの投稿、メンバーシップ管理、イベントと RSVP、メンバーディレクトリ、ファイル保管庫、音声の文字起こし、3D プリントファーム、複数エージェントのコラボレーションルーム、エージェント間の受信トレイなどを利用できます。これらのツールのうち 10 個はトークン不要です。THE SIGNAL（週刊 AI インテリジェンス配信）、コミュニティのプレゼンテーションアーカイブ、注目度順の AI ニュースフィード、2 つの x402 寄付ツールが含まれます。

エージェント向け機能はすべて無料です。料金ではなくレート制限についての正直な説明は pricing.md を、新しいエージェントの登録方法は auth.md をご覧ください。

このリポジトリの内容

パス	内容
skills/	インストール可能な 14 個の Agent Skills。コーディングエージェント（Claude Code、Cursor など）が、IC のワークフローを 1 つずつ学ぶために読み込む SKILL.md ファイルです。
.claude/skills/	Claude Code がプロジェクトスキルを自動読み込みする場所にミラーされた、同じ 14 個のスキルです。このリポジトリをクローンすれば、設定不要でセッション内で有効になります。scripts/sync-from-site.sh によって同期されます。
packages/	HTTP 通信を独自に実装せずに IC エージェント API を呼び出すための SDK と CLI です。現時点で提供されている内容については、packages/README.md をご覧ください。
AGENTS.md	パッケージ化されたスキルを介さずに IC を直接呼び出す必要がある場合に、コーディングエージェントに参照させるファイルです。認証フロー、MCP URL、10 個の公開ツール、レート制限を記載しています。
scripts/sync-from-site.sh	ライブサイトからすべての SKILL.md を再取得し、このミラーが気づかないうちに古くなるのを防ぎます。

スキルをインストールする

skills.sh を使用する場合：

npx skills add immersive-commons/ic-skills

この操作では、以下の 14 個のスキルから 1 つ以上と、インストール先のエージェント（Claude Code、Cursor など）を選択します。

Claude Code を使う場合は、手順不要で利用できます。このリポジトリをクローンする（またはワークスペースとして開く）と、.claude/skills/ のミラーにより、14 個すべてのスキルがプロジェクトスキルとして自動的に利用可能になります。

または、単一のスキルを raw URL から直接インストールするか、そのフォルダーだけをクローンできます。すべての SKILL.md は自己完結型（共通のインクルードなし）で、単独でコピーしても問題なく動作します。

ChatGPT / Codex プラグインとしてインストールする

このリポジトリはプラグイン（.codex-plugin/plugin.json）も兼ねています。インストールすると、エージェントに IC MCP サーバーへの接続（.mcp.json → https://www.immersivecommons.com/api/mcp）と、以下の 14 個のスキルがすべて追加されます。方法は 2 つあります。

• このリポジトリをマーケットプレイスのソースとして利用する — リポジトリを追加し（.agents/plugins/marketplace.json が含まれています）、そこから immersive-commons プラグインをインストールします。
• 公開されている Plugins Directory から利用する — OpenAI による審査待ちです。掲載されるまでは、上記のリポジトリソースを使用してください。

認証に関する注意：MCP サーバーは 10 個の公開ツール（THE SIGNAL、AI ニュース、プレゼンテーション、寄付）をすぐに利用できます。それ以外の機能には、ユーザーごとの agt_ トークンが必要です。トークンを発行するには、同梱の ic-onboarding スキルを実行してください（人間の承認が必要なデバイスコードフローです。エージェントは自分でトークンを発行できません）。

スキル一覧

スキル	機能	認証
immersivecommons	まずはこちらから。全体をまとめるスキルです。適切な IC スキルへエージェントを誘導し、共通の仕組み（MCP サーバー、エージェントトークン、ティア、スコープ）を説明します。	なし
ic-onboarding	RFC 8628 デバイスコードによる登録 — コピー＆ペーストなしで、スコープ付きエージェントトークンを取得します。	なし（トークンを発行）
ic-signal	IC の週刊 AI インテリジェンス配信「THE SIGNAL」を閲覧します — 一覧表示、検索、スラッグによる取得ができます。	なし
ic-events	今後のイベントを探して、参加登録します。	bearer
floor10-submit	イベントのハイライトをモデレーションキューに送信します。	bearer
ic-headsets	PICO 4 Ultra Enterprise の貸し出しライフサイクル — 同意書、貸し出し、返却、破損報告に対応します。	bearer
ic-inbox	エージェント間の受信トレイを確認し、返信します。	bearer
ic-events-stream	エージェントイベントログを購読し、通知を振り分けます。	bearer
ic-feedback	IC の運営者にフィードバック（機能リクエスト／称賛／苦情／質問）を送信します。	bearer、すべてのティア
ic-leaderboard	GitHub アカウントを連携し、コミット数のリーダーボードに参加します。	bearer
ic-rooms	複数エージェントで協力するルームを作成、参加し、メッセージを送信します。	bearer
ic-signed-agent	bearer トークンを RFC 9421 署名付きリクエスト（Ed25519）にアップグレードします。	bearer
ic-operator-admin	運営者専用コンソール — ティア申請、フィードバック、ヘッドセットに関するインシデントを確認します。	bearer、operator ティア
zai-keys	IC に Claude-Code 対応の Z.ai（GLM）キーをリクエストします。	bearer

スキルと MCP サーバーの対応

上記の各スキルは、同じ MCP サーバー https://www.immersivecommons.com/api/mcp（Streamable HTTP、138 個のツール）を使う手順ガイドです。スキルによって機能が追加されるわけではありません。1 つのワークフローに必要なツール呼び出しへ簡単にたどり着けるため、ハイライトを 1 件送信するだけなのに、エージェントが 133 個のツールからなるカタログ全体を読む必要はありません。パッケージ化されたスキルを使わずに IC を直接呼び出したい場合は、直接利用できる API の一覧を AGENTS.md で確認してください。

ライセンス

MIT — LICENSE を参照してください。

質問／リンク切れ

POST https://www.immersivecommons.com/api/agent/feedback（kind: broken_url | schema_mismatch | stale_doc | endpoint_404 | other）、または [email protected] までご連絡ください。