07 c1 60 · 4d 4d 54 4c 53 · 6d 61 72 73 · 48 79 62 72 69 64 45 63 64 68 · 73 74 61 67 65 31 · 63 67 69 34 33 33 · 62 79 74 65 2d 70 65 72 66 65 63 74 · 07 c1 60 · 4d 4d 54 4c 53 · 6d 61 72 73 · 48 79 62 72 69 64 45 63 64 68 · 73 74 61 67 65 31 · 63 67 69 34 33 33 · 62 79 74 65 2d 70 65 72 66 65 63 74 ·
从零复现 · 纯 Go · byte-perfect
一套 HTTP API，
接住微信的全部能力
个人微信协议网关：从零复现微信 Mac / iPad 的 mars 传输 · MMTLS · HybridEcdh 登录与消息协议，不依赖、不代理真实客户端。收发消息、富媒体、朋友圈、视频号、公众号、小程序、搜一搜 —— 全部收进同一套接口，Webhook 实时回调。
160+
HTTP 接口
14
大能力域
Mac · iPad
双端协议
Webhook
实时事件回调
capabilities
全部能力总览
下面每一类都是可直接调用的 HTTP 接口，字段与真实微信客户端逐字节对齐。
🔑
登录 & 会话 9 接口
- 扫码登录
- 推手机免码登录
- 新设备滑块自动过
- 登录状态轮询
- 会话诊断
- 72h 自动续期
- 退出/清登录态
💬
消息收发 8 接口
- 发文本 / @群
- Webhook 收消息
- 消息 poll 拉取
- 语音转文字
- 文本翻译
- 查个人资料
🖼️
富媒体消息 14 接口
- 图片
- 视频
- 文件
- 语音·自动转 SILK
- 名片
- 引用
- 链接卡片
- 小程序卡片
- 表情
- 撤回
👥
好友 & 联系人 21 接口
- 加好友 / 同意
- 删好友
- 改备注
- 标签管理
- 置顶聊天
- 搜索陌生人
- 本地全文搜索
- 收藏管理
🏷️
群聊 10 接口
- 建群
- 链接加群
- 邀请 / 踢人
- 群公告
- 群成员列表
- 改群名
- 转让群主
- 退群
🌤️
朋友圈 13 接口
- 发文字 / 图文 / 视频
- 分享文章
- 时间线
- 好友主页
- 点赞 / 评论
- 删除
- 搜索朋友圈
📹
视频号 17 接口
- 推荐流
- 视频详情
- 搜一搜
- 作者主页
- 粉丝列表
- 私信收发
- 点赞/评论/关注
- 创作平台登录态直出
🔴
视频号直播 9 接口
- 直播广场
- 进直播间
- 发弹幕评论
- 福袋抽奖
- 礼物列表
- 在线数/点赞同步
📰
公众号 10 接口
- 搜索 / 关注
- 文章列表翻页
- 正文详情
- 阅读/点赞数
- 点赞 / 评论
🧩
小程序 12 接口
- jslogin 拿 code
- 调云函数
- 通用 wxAPI 通道
- 获取手机号
- 授权流程
- 生成短链
🔎
搜一搜 5 接口
- 统一搜索
- 账号
- 视频号
- 文章
- 朋友圈
🔗
第三方登录 4 接口
- 网页 OAuth 授权
- 扫码登录授权
- snsapi_login
- snsapi_userinfo
📦
CDN 媒体 15 接口
- 图/视频/文件上传
- 大文件自动分块
- 微信媒体下载
- 朋友圈/收藏/表情下载
- 私有化 CDN
🛒
电商 5 接口
- 搜索商品
- 小店商品列表
- 商品详情聚合
- 电商网关调用
engineering
工程底座
不是 hook、不是自动化点点点 —— 而是把协议本身从零实现出来。
纯 Go · byte-perfect
mars / MMTLS / HybridEcdh / stage1 逐字节复现，与真机对齐。
双端 · 多版本
微信 Mac 4.1.9 / 4.1.10 / 4.1.11，iPad 8.0.74 / 8.0.75。
多租户 · 合成设备
每个设备独立指纹，账号隔离，配额与限流按 key 维度。
Webhook 事件驱动
消息 / 联系人变动 / 上下线实时回调，HMAC 验签 防伪造。
quickstart
5 分钟接入
注册 → 初始化设备 → 扫码登录 → 设回调 → 收发消息。仓库里附带一个「收到「你好」自动回复」的 Python 示例，只用标准库。
- 注册账户，拿到 app_key / app_secret / webhook_secret。
- 初始化设备
POST /device/init→ 得到 device_id。 - 扫码登录：浏览器打开二维码页，手机扫。新设备首登过一次滑块。
- 设置回调
POST /device/callback，把消息推到你的 URL。 - 收发消息：Webhook 收，
POST /message/send发。
echo-bot · curl
# 1) 初始化一个设备（= 一个待登录的微信号） curl -X POST '<你的网关地址>/device/init' \ -H 'X-App-Key: <APP_KEY>' -H 'X-App-Secret: <APP_SECRET>' # → {"device_id":"m............................"} # 2) 把消息回调指向你的服务 curl -X POST '<你的网关地址>/device/callback' \ -H 'X-App-Key: <APP_KEY>' -H 'X-App-Secret: <APP_SECRET>' \ -d '{"device_id":"<DEVICE_ID>","callback_url":"http://you:9000/hook"}' # 3) 发一条文本 curl -X POST '<你的网关地址>/message/send' \ -H 'X-App-Key: <APP_KEY>' -H 'X-App-Secret: <APP_SECRET>' \ -d '{"device_id":"<DEVICE_ID>","to":"<wxid或群id>","content":"你好"}'
get started
开通 · 商务合作
个微 Mac / iPad 全功能接入,多租户、按量计费。加商务 QQ 开通试用、聊定制与报价。
商务 QQ · 开通试用
804922392
扫码加 QQ · 或点击复制 QQ 号 · 备注「网关」
Telegram 交流群
t.me ↗
技术交流 / 对接答疑