Weixin
微信公众号/小程序 API 工具与避坑指南
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:Weixin。 它的用途是:微信公众号/小程序 API 工具与避坑指南 完整的 Skill 内容见:https://321skill.com/skills/weixin-x-2/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'使用 Weixin CLI 获取公众号的 access_token,然后用它上传一张图片素材并发布一篇图文消息。' 它会自动执行 `weixin token` 获取 token,再运行 `weixin material upload image <path>` 上传图片,最后 `weixin draft create` 和 `weixin publish` 完成发布,整个过程无需手动拼写 API 请求。
介绍
这个 Skill 提供了一套零依赖的命令行工具和实战手册,专门解决微信公众平台开发中反复出现的 API 调用问题。你不再需要手动拼请求、查文档排错,它能直接帮你取 token、上传素材、创建草稿、发布文章,还能快速定位 40164(IP 白名单)和 45009(调用频率超限)等高频错误,并给出修复建议。
使用方式很简单:通过 CLI 一条命令完成操作,例如 weixin token 获取 access_token,weixin draft create 创建草稿,weixin publish 发布文章。同时配套的文档详细说明了公众号接入、OAuth 网页授权、JSSDK 签名、支付 V3 等关键流程的坑点和最佳实践,适合边用边查。
适合需要与微信生态打交道的后端开发、全栈工程师和测试工程师。无论是日常运营(批量发文章、管理素材)还是开发调试(排查接口错误、接入支付),都能快速上手。如果你是刚接触微信生态的新手,建议先看手册中的“高频错误排查”章节,再动手操作。
注意:本工具仅适用于已认证的微信公众号或小程序,需提前准备好 AppID 和 AppSecret。另外,CLI 目前只支持 Linux/macOS 终端,Windows 用户需使用 WSL 或 Git Bash。
核心特点
相比微信官方 SDK,它提供了零依赖的 CLI 工具,无需安装任何语言环境即可直接调用;同时内置了 20+ 个真实高频错误的排查方案,而不仅仅是 API 封装。
注意事项
不适合没有微信开放平台账号或未获得 API 权限的场景,也不支持图形界面操作。
常见问题
如何获取 access_token?
运行 `weixin token` 命令,输入 AppID 和 AppSecret 即可自动获取。
40164 错误怎么解决?
将你的服务器公网 IP 添加到公众号后台的“IP白名单”中,然后重新获取 token。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/weixin-x-2/raw/index.md 读取 Weixin 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/weixin-x-2/raw/index.md(查看排版版本)