muse-protocol README

The project's README from github.com/duwqijlk/muse-protocol. As one markdown file: README.md.

muse.ai 注册 / 邀请码兑换 协议分析

补充一下,记得用JP 节点, JP 不需要绑卡,直接过

纯 HTTP 实现 muse.ai 的注册与邀请码兑换流程,不依赖浏览器。本文记录的是通过抓包逐字段比对得出的协议细节。

快速开始

pip install -r requirements.txt
cp config.example.json config.json   # 填入邮箱与可选代理
python example_register.py

目录结构

musepy/
  client.py    注册 + 兑换的完整协议客户端
  runner.py    多账号批量调度(sticky 代理 / 预算 / 停止语义)
  otp.py       验证码轮询(幂等:只取 send 之后的最新码)
  falco.py     行为埋点上报(可选)
  caa.py       注册漏斗事件上报(可选)
example_register.py        单账号端到端示例
example_batch.py           多账号批量示例
config.example.json        配置模板
test_onboarding_smoke.py   离线冒烟(披露解析纯函数)
test_runner_smoke.py       离线冒烟(批量调度,mock 网络)

协议流程

GET  /                                   拿初始 cookie
POST /api/auth/native/restart            → 201 {csrf_token}
POST /api/auth/native/send-otp           → 201
POST /api/auth/native/confirm-otp        → 200 {registration_state:"completion_required",
                                               tos:{content_version}}(动态 TOS 版本)
POST /api/auth/native/register-completion→ 200 {auth_meta_session:{frl_access_token, frl_account_id}}
POST auth.meta.com/hatch/session/bootstrap/ → 302…→ muse.ai 200 HTML(会话引导,必须)
     └ 从 muse.ai 文档解析动态披露 disclosure_text/disclosure_version 与状态门
       (resolvedDestination/isGeoGated/waitlist → 地区受限)
POST /api/hatch/accept-tos               → 200(单次调用;正文用服务端动态披露,非硬编码)
GET  /api/hatch/invite                   → 200 表示账号有效
POST /api/hatch/vm/wake                  → 200(必须,否则兑换误报 invalid;
                                             wake_trigger=mount + open_id + away_ms=0)
POST /api/hatch/stateful-sharing         → 200
POST /api/hatch/invite-code/redeem       → 200 {redemptionStatus:"redeemed"}
POST /api/hatch/invite                   → 200 {code}(取回自己的码,不等于页面刮开 reveal)

几个容易踩的坑

1. confirm-otp 必须带 supports_muse_link_transparency: true

{"otp_code":"123456","remember_device":true,"supports_muse_link_transparency":true}

2. register-completion 的姓名字段语义

{
  "date_of_birth": "1993-11-14",
  "first_name": "三郎",     // 名(given name)
  "last_name": "近藤",      // 姓(family name)
  "tos_content_version": "ntm_create_account:default_v1_meta_account_v3+docs_v2",
  "remember_device": true
}

first_name 是名、last_name 是姓,与直觉相反。生日早于约 18 年前会返回 403——同一会话同一份姓名,只把生日从 2013 改成 1993 就能从 403 变 200。

3. restart 的 body 不是空对象

{"resume": false}

4. accept-tos 是会话激活开关,且必须先引导会话

注册完成后必须先走 POST auth.meta.com/hatch/session/bootstrap/(form 表单只带 frl_access_token,手动跟随 302/301/303 跳转落到 muse.ai 200 文档),否则后续 hatch 接口一律 403。引导落地的 muse.ai 文档里带有 Next Flight 序列化的动态披露 (disclosureText / disclosureVersion,当前实测版本为 HATCH_ROW_v0),accept-tos 的正文必须用服务端返回的这份动态文案(不是硬编码常量),Referer 用披露页 URL;单次调用即可,不重试,403 时把响应体前 200 字符带出来便于诊断。

引导后若服务端判定 resolvedDestination == "waitlist" 或 isGeoGated == true, 属于地区受限:注册已完成、账号保留,但未证明已加入名单。

5. vm/wake 缺失会让兑换误报

不调 vm/wake 直接兑换,即使是有效码也会返回:

{"success":false,"reason":"invalid","detail":"この招待コードは存在しません"}

需要先从已登录页面提取 vmId:

re.search(r'vmId[\\"]*:[\\"]*([0-9a-fA-F-]{36})', html)

wake 的 body 实测为:wake_trigger: "mount"(首连)、open_id(新 uuid)、 away_ms: 0,而不是早期的 resume。

6. 兑换失败原因的含义

reason 含义
redeemed 成功
already_redeemed 本账号已经兑换过一个码
used_up 该码达到 30 次使用上限
invalid 码不存在,或没调 vm/wake

注册成功后 hatch_sess 由 register-completion 的响应头下发(约 886 字符),这是后续所有 hatch 接口的凭证。hatch_vml 在注册阶段一直是被清空状态(Max-Age=0),不属于必需项。

多账号批量(musepy/runner.py)

python example_batch.py [count]

config.json 里的批量字段:

字段 说明
otp_file 邮箱清单,每行 email----otp源URL(otp 源返回 [{"otp","time"},...] JSON)
proxy_file sticky 代理池,每行 host:port:user:pass(或 host:port)
codes_file 可选,待兑换邀请码池,每行一个
output_dir / tried_file 每账号结果 JSON 目录 / 已尝试邮箱清单
workers / max_per_ip worker 数(默认 5)/ 每条代理的验证成功上限(默认 6)
resolve_ip 是否通过 ipify 解析出口 IP(默认 true)
send_caa 批量模式下是否上报注册漏斗埋点

调度语义(与本地实现一致,不承诺任何绕过行为):

每账号结果写入 output_dir/<email>.json,字段:email/status/stage/registered/ own_code/own_code_status/reveal_status/is_revealed/ip/last_error。 frl_access_token 与 hatch_sess 仅在内存中使用,不落盘。

OTP 轮询幂等:每次 send_otp 前记录开始时间,musepy/otp.py 只取该时间之后的 最新 6 位验证码(45 秒超时、0.6 秒间隔、单请求 15 秒超时)。

埋点说明

站点前端会上报两类遥测:

两者都不参与注册判定,缺省不影响流程能跑通。musepy/falco.py 与 musepy/caa.py 保留了完整实现,可通过配置关闭。

使用声明

本项目仅供个人、非商业的学习与研究使用,不采用 MIT 等开源许可证。不得用于商业用途或再分发。实际使用时请遵守目标站点的服务条款与当地法律法规。

交流群 t.me/muihbb

muse-protocol (duwqijlk/muse-protocol)

Searching Database…

What is this?A Python library that re-implements the muse.ai sign-up and invite-code redemption flow over plain HTTP, without a browser, based on analysis of captured traffic.
Is it a finished tool, or a write-up of how the site works?Both: a musepy Python package plus protocol notes built by comparing captured requests field by field.
How stable is it over time?It mirrors one site's flow as observed at capture time, so it may break whenever the site changes its sign-up or redemption behaviour.
What does the write-up cover beyond the basic flow?It documents the stages of the sign-up sequence, the meaning of redemption failure reasons, cookie handling, and how the site's frontend telemetry is reproduced.
Who is it aimed at?The README frames it as study and research material for people interested in how the site's sign-up and invite flow works at the HTTP level, not as a product for end users.
Creator
duwqijlk
Size
0.1 MB
Stars
1.6K
Updated
CommitNov 15
Age
4d
Commits · 90 Days