Weixin

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

安装使用

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

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

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

使用示例

'帮我用Weixin CLI获取公众号access_token并发布一篇图文消息',它会自动执行`weixin token`获取token,然后调用`weixin draft create`创建草稿,最后用`weixin article publish`发布文章。如果遇到40164错误,会提示你添加IP白名单,并给出具体步骤。

介绍

本工具集成了微信公众号/小程序开发中最常用的API操作,通过一个零依赖的命令行界面即可完成token获取、素材上传、草稿创建和文章发布等日常任务。同时,它针对开发中频繁遇到的40164(IP白名单)、45009(频率限制)等高频错误提供了详细的排查步骤和解决方案,帮助开发者快速定位问题。

使用方式非常简单:安装后直接在终端执行命令,无需任何外部依赖。例如输入 weixin token 即可获取access_token,weixin article publish 即可发布图文消息。工具还内置了OAuth授权、JSSDK签名、支付V3等开发场景的示例代码和配置说明,可作为开发参考手册。

适合所有需要对接微信公众号或小程序的开发者,包括后端开发、全栈开发者以及运维人员。无论你是初次接入还是解决线上故障,都能从中找到直接可用的命令和排查思路。

建议先阅读README中的快速入门部分,配置好AppID和AppSecret。对于生产环境,请注意token的过期时间并合理缓存,避免频繁调用。工具不提供图形界面,所有操作均通过命令行完成,适合习惯终端工作流的开发者。

核心特点

不同于其他微信API封装库,本工具提供零依赖的独立CLI,无需安装任何编程语言运行时或第三方包,开箱即用,并针对40164、45009等高频错误给出了精准的排查步骤和解决方案。

注意事项

不适合需要可视化界面管理公众号内容的场景,也不支持小程序云开发或微信支付商户平台的完整管理功能。

常见问题

如何获取access_token?

运行 `weixin token` 命令,工具会自动请求接口并返回token,同时会提示过期时间。建议将token缓存到本地文件中。

遇到40164错误怎么办?

40164表示IP白名单验证失败。请检查你的服务器出口IP,并在微信公众平台后台的“IP白名单”中添加该IP。工具运行时会自动检测当前IP并给出提示。

给 AI 助手的安装指引

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

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