Clarke GEO registry

Clarke

仍在开发中。 此项目正在积极开发，尚未达到可用于生产环境的状态。

轨道基础设施的数据与智能层。

Clarke 对 GEO、LEO 和 MEO 的公开数据进行规范化处理，构建太空经济所缺少的轨道资产登记系统、定价情报和协调层。

---

项目简介

• 轨道登记系统 - 可搜索、筛选和导出的浏览器，涵盖所有已跟踪的 GEO 轨位，数据来自 FCC、Space-Track 和 UCS 的公开数据。此产品不包含 ITU 申报数据。ITU Space Explorer 是目前的 ITU 数据来源。SNS Online 已于 2025 年 1 月关闭。
• GEO 轨位指数 — /index（别名为 /research）：方法说明中的占用进入／退出、争议状态变化、FCC 数据差异。不是价格指数。
• 情报层 — 估值模型 v0（范围 + 置信度 + 驱动因素明细 + 30 天历史记录）、标准化的 0–100 拥堵／协调风险评分，以及逐个来源的数据新鲜度跟踪
• 终端席位 — 免费提供精简版登记系统；Pro 可解锁驱动因素明细、比较（最多 4 项）、增强导出和 Terminal API
• 数据质量 — 当 Space-Track 的 TLE 经度通过已发布的质量门槛时，使用其计算占用集群（同时保留并显示 UCS 目录经度）。差异超过 2° 时会标记。TLE 经度不是 FCC 或 ITU 的分配结果。
• Agent 访问 — 版本化的只读 HTTP API（公开 Agent + Pro Terminal）和 MCP 服务向大模型 Agent 与工具开放登记系统
• 博客 — 关于轨道基础设施、太空计算和太空经济的长篇文章
• 关于 — Clarke 是什么、为什么是现在、数据来源、登记系统方法和数据质量说明，均集中在一个页面

---

Agents API 与 MCP

Clarke 将其注册表公开为机器可读数据，供大模型 Agent 和工具使用。

HTTP API： 版本化、只读、限流、启用 CORS，并使用 ETag 缓存。响应采用 { data, meta } 封装，其中 meta.data_freshness 会报告各来源上次导入的时间。成功的 Agent 响应会设置 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}	一个轨位，与列表中的记录相同。clarke_get_terminal 返回相同的 JSON。
GET /api/v1/agents/satellites	GEO 卫星（可按 operator、ownerCountry、limit 筛选）
GET /api/v1/agents/deltas	导入时的占用情况、FCC 和争议变更。在存在第二份注册表快照之前，coverage=bootstrap。估值和拥塞情况显示在面向用户的 Slot Terminal 上。
GET /api/v1/openapi	面向 Agent 和 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 创建密钥。公共 Agent API 无需身份验证（60 次请求/分钟/IP）；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 的文件头。

公共 Agent HTTP 路由和远程 MCP 每次源站命中时，都会向 stdout 写入一行 clarke.usage JSON（Vercel Observability，以及项目配置了日志转发时的日志转发目标）。该行包含按日加盐的 IP 哈希、用户代理、路由、状态、MCP 工具名称，以及白名单字段 slug、limit、view、all、since、offset 和 after。其中不包含原始 IP、Cookie、授权信息或请求正文。MCP POST 采用 no-store，因此工具调用会显示出来。可按 clarke.usage 和 "transport":"mcp" 筛选日志。该行不会阻止客户端，也不会改变每分钟 60 次的普通限额或每分钟 12 次的高负载限额。防火墙机器人防护是独立开关。本地 stdio 不会打印此行，因为 stdout 用作 MCP 传输通道。

---

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

每次运行都会在 ingest_meta 中记录时间戳、行数和源数据版本（UCS 最新 GEO 发射、FCC 工作簿截至日期、TLE 历元范围），并显示在 Slot Terminal、/about 和 API 的 meta.data_freshness 中。摄取的 last_run 并非文件版本日期。当占用情况成员、争议记录、FCC 呼号、解析后的 data/ssal.xlsx 申报数据或这些文件版本发生变化时，FCC、UCS 和 Space-Track 摄取也会追加一条 registry_snapshots 记录。当两个快照都存储了这些工作簿行时，GET /api/v1/agents/deltas 会报告新增、移除和变更的申报数据。GET /api/v1/agents/deltas 会对这些行进行差异比较。需要在不完整摄取的情况下记录基线时，运行 npm run snapshot:registry 即可。Space-Track 摄取会存储 satcat 和 TLE，并采用 TLE 优先的占用权威规则：保留 UCS 的 longitude_geo（仅进行绕回归一化）；在通过时效和质量门槛时，占用情况、拥塞和估值 v0 按 TLE 子卫星经度进行聚类，否则使用 UCS 数据，并将 Δ / positionDisputed 写入审计记录。对于已有 TLE 的数据库：运行 npm run apply:positions，然后运行 npm run seed:valuations（历史数据是带标签的回填数据，并非交易）。

---

技术栈

• 前端： Next.js 16、Tailwind CSS 4、Manrope + IBM Plex Mono
• 数据库： 通过 better-sqlite3 使用 SQLite
• Agent 接口： 版本化 REST API + MCP 服务（@modelcontextprotocol/sdk）
• 数据： FCC SSAL、Space-Track、UCS Satellite Database、SEC EDGAR。本产品不包含 ITU 申报数据。ITU Space Explorer 是当前的 ITU 数据源。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。数据可信度、Agent 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	否	用于公开 Agent 和 MCP ipHash 日志的每日盐值。未设置时回退到 AUTH_SECRET

---

许可证

MIT