Weixin

微信公众号/小程序 API 零依赖 CLI 工具

安装使用

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

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

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

使用示例

'使用Weixin CLI获取公众号的access_token,并创建一个图文素材草稿,标题为“测试”,内容为“Hello World”。' 它会执行 `weixin token` 获取有效 token,然后执行 `weixin draft create --title '测试' --content 'Hello World'`,返回草稿 ID 和创建状态。

介绍

解决微信公众号/小程序开发中频繁调用官方 API 的痛点,包括获取 access_token、上传素材、创建草稿、发布文章等操作,同时提供 40164/45009 等高频错误的排查思路和实战避坑指南。该工具是一个零依赖的 CLI,无需安装任何第三方库即可直接运行,适合快速集成到现有开发流程中。

使用时只需在终端执行对应命令,例如 weixin token 获取令牌,weixin draft create 创建草稿,weixin publish 发布文章。所有命令均封装了微信官方接口的签名、超时、重试逻辑,并内置了常见错误的诊断提示,帮助开发者快速定位问题。

适合后端开发、全栈开发、智能体开发者,尤其是需要对接微信公众号/小程序生态的团队或个人。也适用于需要批量管理公众号内容、做自动化运营的运维人员。

建议先阅读 README 中的“高频错误排查”章节,了解常见错误码的解决方案;使用前请确保已准备好公众号的 AppID 和 AppSecret,并配置好 IP 白名单。该工具不做用户认证和权限管理,仅用于开发测试阶段,生产环境需结合安全策略使用。

核心特点

相比官方 SDK 或第三方库,该工具是零依赖的单一 CLI,开箱即用;并且内置了高频错误码的排查手册,能直接给出错误原因和修复建议,而非仅仅返回错误信息。

注意事项

不适用于需要复杂业务逻辑编排或深度定制化的场景,仅覆盖公众号/小程序基础 API 的调用和常见问题排查。

常见问题

如何获取 access_token?

在终端执行 `weixin token` 命令,工具会自动请求微信接口并返回 token,同时缓存到本地文件,避免重复请求。

遇到 40164 错误怎么办?

40164 表示 IP 未在白名单中,请登录微信公众平台 -> 开发 -> 基本配置,将当前服务器的公网 IP 加入白名单。

给 AI 助手的安装指引

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

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