cgptmail

mail.chatgpt.org.uk 的非官方 TypeScript / Node.js SDK —— 无需 API key，无需浏览器，纯 HTTP 协议级实现。

该站点本身只在浏览器里运行；本 SDK 复刻了它的鉴权协议（gm_sid Cookie + X-Inbox-Token），把同样的能力暴露成 Node API + CLI。

安装

npm install cgptmail
# 或
bun add cgptmail

要求 Node ≥ 18（依赖内置 fetch）。

30 秒上手

import { MailClient } from "cgptmail";

const cli = new MailClient();
const mb = await cli.createMailbox();
console.log(mb.address); // 例如 [email protected]

const msg = await mb.waitForEmail({
  timeoutSec: 180,
  match: (m) => /verify|code|otp/i.test(m.subject),
});
console.log(msg.subject, msg.text);

CLI

npx cgptmail stats
npx cgptmail new
npx cgptmail inbox <address>
npx cgptmail get <id> --address <address>
npx cgptmail wait <address> --timeout 180 --match "code|verify"
npx cgptmail clear <address>

协议要点

| 步骤 | 调用 | 作用 | |---|---|---| | 1 | GET / | Set-Cookie: gm_sid + HTML 中嵌入 __BROWSER_AUTH.token | | 2 | POST /api/inbox-token | 用 gm_sid 续 token，并滑动 gm_sid 30 分钟有效期 | | 3 | /api/* | 同时携带 Cookie: gm_sid 与 X-Inbox-Token；某些响应里 piggyback 新 auth |

MailClient 自动处理：

• bootstrap、提前 120 s 续约、piggyback 续约
• 401/403 自愈：先续一次 token；token 也续不动就重 bootstrap 整条会话
• 并发安全的 token 刷新
• 429 抛 RateLimitError；waitForEmail 内置退避

API

import {
  MailClient,
  Mailbox,
  Email,
  EmailSummary,
  Stats,
  RateLimitError,
  AuthError,
  BootstrapError,
  ApiError,
} from "cgptmail";

const cli = new MailClient({ baseUrl?, userAgent?, onRequest? });

await cli.stats();                       // Stats
const mb = await cli.createMailbox();    // Mailbox
const mb2 = cli.mailbox("[email protected]");  // 用已有地址构造 (不调用服务端)

await mb.list();                                 // EmailSummary[]
await mb.get(id);                                // Email
await mb.delete(id);
await mb.clear();
await mb.waitForEmail({ timeoutSec, intervalSec, match, since, signal });

协议层细节

• gm_sid 是 HttpOnly; Max-Age=1800 的 Cookie；每次 token 续约都会重新下发 → 滑动续期。
• __BROWSER_AUTH.token 是服务端 HMAC 签的 {sid, exp}，sid 与 Cookie 同值。
• token 寿命约 600 s；SDK 提前 120 s 主动续，与官方 JS 保持一致。
• 若长时间断网或 sid 死亡，下一次业务调用会自动重 bootstrap。

许可

MIT