Clarke GEO registry

Clarke

開発中です。 このプロジェクトは現在開発が進められており、本番環境での使用には対応していません。

軌道インフラのためのデータおよびインテリジェンスレイヤーです。

Clarke は、GEO、LEO、MEO にまたがる公開データを標準化し、宇宙経済に欠けている軌道資産レジストリ、価格インテリジェンス、調整レイヤーを構築します。

---

概要

• 軌道レジストリ — FCC、Space-Track、UCS の公開データを基に、追跡対象となるすべての GEO 位置を検索、絞り込み、エクスポートできるエクスプローラーです。ITU への申請情報はこの製品には含まれていません。現在の ITU の情報源は ITU Space Explorer です。SNS Online は 2025 年 1 月に閉鎖されました。
• GEO Slot Index — /index（別名 /research）：占有状態の開始・終了、紛争の変化、FCC の差分に関する方法論の注記です。価格指数ではありません。
• インテリジェンスレイヤー — 価値評価モデル v0（範囲＋信頼度＋要因の内訳＋30 日間の履歴）、0～100 で標準化された混雑度／調整リスクスコア、情報源ごとのデータ鮮度の追跡機能を提供します。
• ターミナルの利用枠 — 無料版では基本的なレジストリを利用でき、Pro では要因の内訳、比較（最大 4 件）、拡張エクスポート、Terminal API が利用可能になります。
• データ品質 — TLE が公開されている品質基準を満たす場合、占有クラスターの判定には Space-Track の TLE 経度を使用します（UCS カタログの経度も保持し、表示します）。2°を超える不一致にはフラグが付けられます。TLE 経度は FCC または ITU による割り当てではありません。
• エージェントアクセス — バージョン管理された読み取り専用 HTTP API（公開エージェント＋Pro ターミナル）と MCP サーバーを通じて、LLM エージェントやツールにレジストリを公開します。
• ブログ — 軌道インフラ、宇宙コンピューティング、宇宙経済に関する長文記事です。
• 概要 — Clarke とは何か、なぜ今なのか、データソース、レジストリの方法論、データ品質に関する注記を、すべて 1 ページにまとめています。

---

エージェント API と MCP

Clarke は、LLM エージェントやツールが読み取れる形式でレジストリを公開しています。

HTTP API： バージョン管理され、読み取り専用で、レート制限と CORS に対応し、ETag でキャッシュされます。レスポンスは { data, meta } エンベロープでラップされ、meta.data_freshness は各ソースの最終取り込み時刻を示します。エージェント向けの成功レスポンスには、Cache-Control: public, s-maxage=3600, stale-while-revalidate=60 が設定されます。

エンドポイント	戻り値
GET /api/v1/agents/slots	レジストリの全行：operatorIdentity と operatorMix、占有状況、FCC の行、紛争、ソースの経過日数（fccStale、tleStale、45 日）。評価額と混雑状況は、人間向けの Slot Terminal に表示されます。
GET /api/v1/agents/slots/{slug}	1 つのスロット。リスト内のレコードと同じです。clarke_get_terminal は同じ JSON を返します。
GET /api/v1/agents/satellites	GEO 衛星（operator、ownerCountry、limit で絞り込み）
GET /api/v1/agents/deltas	取り込み時の占有状況、FCC、紛争の変化。2 つ目のレジストリスナップショットが作成されるまでは、coverage=bootstrap です。評価額と混雑状況は、人間向けの Slot Terminal に表示されます。
GET /api/v1/openapi	エージェント向けルートと Terminal ルートの OpenAPI 3.1 仕様
GET /api/v1/terminal/slots	Pro — Terminal の概要
GET /api/v1/terminal/slots/{slug}	Pro — Terminal の完全なモデル（占有状況、FCC、評価額。実験的なスタブも含まれますが、ラベルが付いています）
GET /api/v1/terminal/valuations/{slug}	Pro — 現在の評価額 v0
GET /api/v1/terminal/valuations/{slug}/history	Pro — 日次モデルスナップショット
GET /api/v1/terminal/compare?slugs=	Pro — 最大 4 つのスロット

Pro の Terminal ルートでは、セッション Cookie、または Authorization: Bearer ck_live_… / X-Clarke-Key を使用できます。Pro としてサインインした状態で /account からキーを発行してください。公開エージェント API は認証不要のままです（IP あたり毎分 60 リクエスト）。Pro キーでは毎分 300 リクエストが可能です。

MCP サーバー。 Claude Code、Cursor、その他の MCP クライアント向けに、同じレジストリをツールとして提供します。

公開リモートエンドポイント（ステートレスな Streamable HTTP、読み取りはオープン）：https://www.clarkebelt.finance/api/v1/mcp

ローカル stdio：

npm run mcp

ツール：clarke_list_slots、clarke_get_slot、clarke_get_terminal、clarke_list_deltas、clarke_list_satellites。ツールのテキストはコンパクトな JSON です。clarke_get_terminal は clarke_get_slot と同じ JSON を返します。clarke_list_deltas は GET /api/v1/agents/deltas と同じ JSON を返します。clarke_list_satellites の limit のデフォルト値は 100 です。スロットレコードでは単一の代表オペレーターではなく、operatorIdentity と operatorMix を使用します。評価額と混雑状況は、人間向けの Slot Terminal にラベル付きモデルとしてのみ表示されます。フィールド一覧：docs/AGENT_API.md（公開ページ /docs/agent-api）。クライアント設定のサンプルについては、scripts/clarke-mcp.ts のヘッダーを参照してください。

公開エージェント向け HTTP ルートとリモート MCP は、オリジンへのアクセスごとに stdout に clarke.usage の JSON 行を 1 行出力します（Vercel Observability、およびプロジェクトにログドレインがある場合はそこにも出力）。この行には、日次ソルト付き IP ハッシュ、ユーザーエージェント、ルート、ステータス、MCP ツール名、および許可リストに含まれるフィールド slug、limit、view、all、since、offset、after が含まれます。生の IP、Cookie、認証情報、リクエスト本文は含まれません。MCP POST は no-store のため、ツール呼び出しが記録されます。clarke.usage と "transport":"mcp" でログを絞り込んでください。この行の出力はクライアントをブロックせず、通常の毎分 60 件または高負荷向けの毎分 12 件という制限も変更しません。ファイアウォールのボット保護は別の設定です。stdout が MCP トランスポートとして使われるため、ローカル stdio ではこの行は出力されません。

---

MCP

https://www.clarkebelt.finance/api/v1/mcp

各 GEO 経度に位置する衛星と、FCC ライセンス、軌道データの鮮度、紛争状況を確認できます。キー不要、キャッシュ対応、引用可能です。

公式 MCP レジストリ向けのレジストリメタデータは server.json です（io.github.xentoshi/clarke v1.0.0、リモート Streamable HTTP）。

データパイプライン

レジストリは SQLite データベース（data/clarke.db）を使用しています。このデータベースはコミット済みの状態で同梱されているため、アプリはすぐに実行できます。ソースから再構築するには、次を実行します。

npm run ingest            # UCS Satellite Database (GEO subset)
npm run ingest:fcc        # FCC Approved Space Station List (from data/ssal.xlsx; see docs/FCC_REFRESH.md)
npm run vintages          # record UCS / FCC / TLE file vintages without a full re-download
npm run ingest:spacetrack # Space-Track satcat + TLEs (requires credentials)
npm run ingest:all        # all of the above

各実行では、タイムスタンプ、行数、ソースの時点（UCS の最新 GEO 打ち上げ、FCC ワークブックの基準日、TLE のエポック範囲）が ingest_meta に記録され、Slot Terminal、/about、API の meta.data_freshness に表示されます。Ingest の last_run はファイルの時点を示すものではありません。FCC、UCS、Space-Track の Ingest では、占有状況のメンバーシップ、紛争記録、FCC コールサイン、解析済みの data/ssal.xlsx の届出、またはこれらのファイルの時点に変更があった場合、registry_snapshots の行も追加されます。2 つのスナップショットに同じワークブックの行が保存されている場合、GET /api/v1/agents/deltas は新規、削除、変更された届出を報告します。GET /api/v1/agents/deltas はこれらの行を差分比較します。完全な Ingest を行わずに現在の状態をベースラインとして記録するには、npm run snapshot:registry を実行します。Space-Track の Ingest は satcat と TLE を保存し、TLE 優先の占有判定権限を適用します。UCS の longitude_geo は保持され（経度の折り返し正規化のみ実施）、占有状況、混雑度、評価額 v0 のクラスタリングには、経過時間と品質の条件を満たす場合は TLE のサブサテライト経度を、それ以外の場合は UCS を使用します。Δ / positionDisputed は監査証跡として記録されます。TLE がすでに存在する DB に対しては、npm run apply:positions を実行してから npm run seed:valuations を実行します（履歴は売買ではなく、ラベル付きのバックフィルです）。

---

技術スタック

• フロントエンド： Next.js 16、Tailwind CSS 4、Manrope + IBM Plex Mono
• データベース： better-sqlite3 を介した SQLite
• エージェントインターフェース： バージョン管理された REST API + MCP サーバー（@modelcontextprotocol/sdk）
• データ： FCC SSAL、Space-Track、UCS Satellite Database、SEC EDGAR。ITU の届出はこの製品に含まれていません。現在の ITU ソースは ITU Space Explorer です。SNS Online は 2025 年 1 月にサービスを終了しました。

---

ローカルでの実行

npm install
npm run seed:valuations   # persist 30-day v0 history into data/terminal.db
npm run dev

レジストリを表示するには /orbital を、スロットページを表示するには /orbital/101w（または /slot/101w）を、無料セッションを利用するには /login を、アクセスするには /pricing を開きます。

公開されている方法論：/docs。データの信頼性、エージェント API、評価額 v0、FCC SSAL の更新については、リポジトリ内のコピーをご覧ください：docs/DATA_TRUST.md、docs/AGENT_API.md、docs/VALUATION.md、docs/FCC_REFRESH.md。

npm test                  # valuation v0 + TLE occupancy authority tests

---

環境変数

変数	必須	説明
NEXT_PUBLIC_URL	はい（本番環境）	正規 URL
AUTH_SECRET	はい（本番環境）	セッション Cookie と API キー用の HMAC シークレット
STRIPE_SECRET_KEY	いいえ	Stripe シークレット。ライブ課金は未接続で、/pricing は Checkout を呼び出しません。
STRIPE_PRICE_ID	いいえ	Terminal シートのサブスクリプション用 Stripe Price ID
STRIPE_WEBHOOK_SECRET	いいえ	Stripe webhook の署名検証用に予約されています。/api/billing/webhook は署名を検証しません。
SPACETRACK_USERNAME	いいえ	Space-Track のログイン情報（npm run ingest:spacetrack 用）
SPACETRACK_PASSWORD	いいえ	Space-Track のパスワード（npm run ingest:spacetrack 用）
PV_SECRET	いいえ	AUTH_SECRET が未設定の場合に使用する、レガシーの代替 HMAC シークレット。/api/pv ビーコンは削除されています。
NEXT_PUBLIC_PLAUSIBLE_DOMAIN	いいえ	Plausible の分析ドメイン
USAGE_LOG_SALT	いいえ	公開エージェントと MCP の ipHash ログ用の日次ソルト。未設定の場合は AUTH_SECRET にフォールバックします。

---

ライセンス

MIT