Weixin

微信公众号/小程序 API 调试与避坑 CLI 工具

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Weixin。
它的用途是:微信公众号/小程序 API 调试与避坑 CLI 工具
完整的 Skill 内容见:https://321skill.com/skills/weixin-x-3/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'帮我用 Weixin 工具获取微信公众号 access_token,并创建一个草稿文章。' 它会自动调用 CLI 工具,先执行 `weixin token` 获取 token,然后执行 `weixin draft create --title "测试文章" --content "..."` 创建草稿,最后返回草稿 ID 和状态。

介绍

本 Skill 围绕微信公众号和小程序开发中的高频痛点设计,帮助开发者快速完成 API 调用、错误排查与功能集成。它提供零依赖的命令行工具,直接调用公众号 API 获取 access_token、上传素材、创建草稿、发布文章,同时内置常见错误码(如 40164、45009)的解决方案,避免在开发过程中反复踩坑。此外,还涵盖公众号接入、OAuth 授权、JSSDK 签名、微信支付 V3 等核心业务流程的指导,适合需要快速上手微信生态的团队或个人。

使用方式非常简单:安装后,通过命令行即可执行 token 获取、素材上传、草稿创建、文章发布等操作,无需额外配置复杂的环境。对于高频错误,工具会给出明确的排查指引,例如 IP 白名单未配置、接口调用频率超限等,帮助开发者快速定位问题根源。对于 OAuth 和支付等场景,工具提供示例代码和配置检查,减少因文档缺失导致的开发延误。

本 Skill 主要面向后端开发、全栈开发以及运维工程师,尤其是负责微信公众号或小程序的后台服务、需要频繁调用官方 API 的开发者。对于正在从零搭建微信应用、遇到各种奇怪错误却无从下手的初级开发者,它也能提供实用的避坑经验。

使用时建议先阅读 README 中的环境要求,确保本地网络可访问微信服务器。注意工具仅封装了公众号/小程序的核心 API,不涵盖微信开放平台的其他能力(如第三方平台、企业微信等)。若需要批量处理大量素材或高并发场景,建议搭配官方文档进行二次开发。

核心特点

与其他微信 API 封装库不同,本工具以零依赖 CLI 形式提供,无需安装 Python 或 Node 运行时即可直接运行,并内置高频错误码的排查逻辑,而非仅仅提供 API 调用封装。

注意事项

不适用于微信开放平台的其他能力(如第三方平台、企业微信、微信小游戏等),且仅支持公众号/小程序的常用 API,未覆盖所有接口。

常见问题

如何获取 access_token?

运行 `weixin token` 命令,按照提示输入 AppID 和 AppSecret 即可获取,工具会自动缓存 token 避免重复请求。

遇到 40164 错误怎么办?

该错误表示 IP 不在白名单内,请登录微信公众平台,在“开发-基本配置”中将当前服务器 IP 加入白名单。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/weixin-x-3/raw/index.md 读取 Weixin 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。