全部 Skill/微信公众平台

微信公众平台 Skill

覆盖公众号运营与开发最常接的业务：access_token 获取与稳定版接口、关注者列表与标签黑名单、被动回复与客服消息、模板消息与订阅通知的选型、自定义菜单、网页授权登录、服务器配置与消息加解密、全局错误码与调用限额。重点讲清模板消息/订阅通知/一次性订阅消息三套并存机制的区别，以及 snsapi_base 与 snsapi_userinfo 两种网页授权 scope 的精确差异。

文档版 · 未实测wechat-mpdevelopers.weixin.qq.comaccess_token 放 URL 查询参数协同办公更新 2026-09-17
8份 reference
6个易错点
3条无凭证探测
2026-09-17文档抓取
INSTALL · 安装

安装

选你用的 Agent，复制命令。

npx -y skills add fxp/skillify --skill wechat-mp --agent claude-code --yes

装到项目的 .claude/skills/；加 -g 装到全局。装完需要你手动执行 /reload-plugins，这一步 Agent 代劳不了。

或者让 Agent 自己装

读 https://github.com/fxp/skillify/blob/main/skills/wechat-mp/prompt.md 并照它执行
下载 wechat-mp.skill 42 KB 源文件 ↗

装对了的标志：references/ 下有 8 份文档。

TRY ASKING · 装好后可以这样问

装好后，可以这样问你的 Agent

这份 Skill 覆盖的典型任务。点一下复制。

CAPABILITIES · 能力清单

8 类能力

每类能力对应一份 reference，Agent 按任务只打开需要的那份。

鉴权

access_token 获取、稳定版接口、IP 白名单查询、回调连通性检测

references/auth.mdGET /cgi-bin/token · POST /cgi-bin/stable_token · GET /cgi-bin/getcallbackip

错误码与限流

全局错误码、调用配额查询与清零、接口报警与自动屏蔽

references/errors-and-limits.mdPOST /cgi-bin/openapi/quota/get · POST /cgi-bin/clear_quota

服务器配置与消息加解密

接入校验、明文/兼容/安全三种模式、AES-256-CBC 签名与加解密流程

references/events.mdGET <your callback URL> (verify) · POST <your callback URL> (message push, XML/JSON)

自定义菜单

创建、查询、删除自定义菜单与个性化菜单，菜单点击事件

references/menu.mdPOST /cgi-bin/menu/create · GET /cgi-bin/menu/get

消息与客服消息

被动回复的 5 秒机制、常见事件推送、客服消息时间窗口、高级群发

references/messaging.mdPOST /cgi-bin/message/custom/send · POST /cgi-bin/message/mass/sendall

网页授权

snsapi_base 与 snsapi_userinfo 的区别，授权码换取用户信息

references/oauth.mdGET /sns/oauth2/access_token · GET /sns/userinfo

模板消息与订阅通知

模板消息、订阅通知（一次性/长期）、一次性订阅消息三套机制的选型与调用

references/template-subscribe.mdPOST /cgi-bin/message/template/send · POST /cgi-bin/message/subscribe/bizsend

用户管理

关注者列表、用户信息、标签管理、黑名单、账号迁移转 openid

references/users.mdGET /cgi-bin/user/get · GET /cgi-bin/user/info · POST /cgi-bin/tags/create
FACTS · 当前事实

当前事实

整理自官方文档（抓取于 2026-09-17），还没有用真实凭证验证。

项值
Base URLhttps://api.weixin.qq.com
换 tokenGET /cgi-bin/token?grant_type=client_credential&appid=&secret=，7200 秒；推荐改用 POST /cgi-bin/stable_token
成功判定HTTP 200 + 响应体 errcode 等于 0，不是 HTTP 状态码
网页授权 scopesnsapi_base（静默，仅 openid）vs snsapi_userinfo（需用户同意，拿昵称头像）
客服消息窗口用户发消息后 48 小时内最多 5 条；关注/扫码/点菜单是 1 分钟内最多 3 条
GOTCHAS · 易错点

照通用经验写容易错的 6 件事

来自官方文档，还没有用真实凭证验证。

  1. token 只能放 URL 查询参数，不是 Authorization 头。无凭证探测：不带 access_token 参数返回 41001 access_token missing，不是 401。
  2. 两套换 token 接口的 token 互相隔离。/cgi-bin/token（旧）与 /cgi-bin/stable_token（新，推荐）各自维护自己的 access_token，不能混用刷新逻辑。
  3. 模板消息、订阅通知、一次性订阅消息三套机制并存,不是简单的新旧替代。三者的 template_id 体系、data 键名格式（.DATA 后缀 vs 裸键名）、触发前提都不通用。
  4. 网页授权的 access_token 与全局 access_token 是两套不同 token。无凭证探测证实两者的报错文案不同：全局系列会提示改用稳定版接口，网页授权系列不会。
  5. 被动回复必须在 5 秒内同步返回。超时或回复非法内容会让用户看到系统提示；处理不完就回 success 或空串，耗时逻辑改走客服消息异步下发。
  6. MarkFail 自动屏蔽：多次推送失败后微信会暂停向你的服务器推送消息 1 分钟。这段时间内代码层面看不到任何错误请求，排查'突然收不到消息'要先查接口告警。
STATUS · 验证状态

验证状态

文档版：整理自官方文档（抓取于 2026-09-17），还没有用真实凭证调用验证。页面和 Skill 里标「文档原文，未实测」的报错与行为都来自文档本身。

无凭证探测

  • 换 token 接口对格式不合法的 appid 一律返回 40013，即使缺少 grant_type 参数也是先报 appid 错误
  • 伪造 access_token 调 cgi-bin 系列接口，报错文案主动建议改用 getStableAccessToken；伪造网页授权 access_token 调 sns 系列接口时报错文案不带这句建议
  • 18 次无凭证探测全部返回 HTTP 200，业务结果体现在 JSON 的 errcode 字段，没有一次返回非 200 状态码
有这个平台的沙箱或 API Key？联系我们——补测并做完装与不装的对照测试后，它会升级为「已实测」。