Description
n8n 微信公众号节点
一个面向生产环境的 n8n 微信公众号（WeChat Official Account）社区节点。
项目聚焦公众号内容自动化中最常用、最稳定的能力：图片素材、草稿管理、发布管理、内容数据分析。代码基于当前 n8n 社区节点规范重新实现，不是旧社区项目的 Fork，也不保留不必要的兼容层和通用 API 兜底。
功能
图片与素材
- 上传正文图片（
/cgi-bin/media/uploadimg） - 上传永久图片素材（
/cgi-bin/material/add_material） - 创建草稿
- 获取草稿
- 获取草稿列表
- 更新草稿
- 删除草稿
- 标题
title - 作者
author - 摘要
digest - 正文 HTML
content - 原文链接
contentsourceurl - 封面素材 ID
thumbmediaid - 正文显示封面
showcoverpic - 开启评论
needopencomment - 仅粉丝可评论
onlyfanscan_comment - 2.35:1 / 1:1 封面裁剪参数
- 提交发布
- 查询发布状态
- 获取已发布文章
- 获取已发布文章列表
- 删除已发布文章
- 发表内容每日阅读数据（
/datacube/getarticleread） - 发表内容每日分享数据（
/datacube/getarticleshare） - 发表内容概况总数据（
/datacube/getbizsummary） - 发表内容发表详细数据（
/datacube/getarticletotaldetail） - 数据从
2025-11-01开始； - 每日阅读、每日分享、文章详细数据一次只能查询 1 天；
- 内容概况总数据一次最多查询 30 天；
end_date最大为昨日，建议次日 08:00 后查询前一天数据；- 接口仅对符合微信当前权限要求的认证服务号开放。
- 消息 Trigger / Response
- 公众号回调 Webhook
- AES 消息加解密
- 自定义菜单
- 用户与标签管理
- 模板消息
- 客服消息
- 评论管理
- 二维码管理
- App ID
- App Secret
- Credential 只保存 App ID 和 App Secret；
- 每次该 Node 执行第一次调用微信时，以
force_refresh: false获取当前 Stable Access Token； - 同一次 Node 执行内复用该 Token；
- 不做进程级 Token Cache、TTL、强制刷新、Cooldown 或 Token 失效自愈；
- Access Token 不写入 Workflow JSON、Credential、节点输出或日志。
- 每个微信请求只发送一次；
- Token 错误直接返回微信
errcode/errmsg； - 网络失败不自动重试；
- 创建草稿、上传素材、提交发布等写操作不会因为网络结果未知而被自动重放。
节点直接接收 n8n Binary 数据。如果图片来自 URL，建议先使用 n8n 的 HTTP Request 节点下载为 Binary，再交给本节点上传。
草稿管理
支持单图文和多图文草稿，常用字段包括：
普通图文会显式发送 article_type: "news"。
发布管理
> 微信公众号的 freepublish/* 接口权限与草稿接口权限并不完全相同。个人主体、未认证或不具备相应发布权限的账号，可能可以正常使用草稿接口，但调用发布接口时返回 48001。请以公众号后台实际显示的接口权限为准。
定时、审批和人工确认应由 n8n Workflow 负责，本节点不在内部隐藏调度逻辑。
内容数据分析
从 1.1.0 起，节点接入微信当前维护的“发表内容”数据接口，不再新增已经被微信标记为停止维护的旧图文统计接口：
其中“发表内容发表详细数据”可返回文章标题、文章链接、阅读人数、分享人数、点赞/在看、留言、收藏、阅读后关注、阅读送达率、阅读完成率、平均阅读时长和跳出位置等指标，适合在 n8n 中进一步落库、汇总或交给分析流程处理。
微信当前文档对这组新接口有几个重要限制：
节点会在发请求前校验日期格式、起始日期、跨度和“昨日”边界，减少无效调用。
V1 暂不包含
为了保持节点简单、稳定，V1 暂不提供：
这些能力只有在出现稳定、重复的真实使用需求后，才会作为正式 Operation 加入。
凭据配置
在 n8n 中创建 WeChat Official Account API Credential，只需要：
App Secret 以密码字段保存。
微信公众号服务端 API 还要求调用服务器的出口 IP 已加入公众号后台的 API IP 白名单。如果微信返回 40164，节点会给出针对性的白名单错误提示。
Access Token
节点使用微信 Stable Access Token，但不在插件内部维护长期 Token 状态：
微信 Stable Token 的普通模式在 Token 有效期内重复调用不会轮换 Token，因此这种方式牺牲极少的请求开销，换取更少的状态和更低的维护复杂度。
请求策略
节点本身不做自动重试：
如果业务确实需要等待、重试或报警，应在 n8n Workflow 中显式配置，让恢复逻辑可见、可控、可审计。
输出结构
每个输入 Item 对应一个输出 Item，并保留正确的 pairedItem 关系。
原始输入 JSON 会保留，微信 API 的响应统一放在：
$json.wechat
例如创建草稿成功后：
$json.wechat.media_id
如果开启 n8n 的 Continue On Fail，错误信息会通过经过脱敏的 wechatError.message 返回。
安装
发布到 npm 后，可以在 n8n 的 Community Nodes 中安装：
n8n-nodes-wechat-official-account
生产环境建议固定精确版本，不要依赖浮动的 latest。
兼容性
稳定版 1.0.0 基于以下环境开发和验证：
@n8n/node-cli 0.45.5n8n-workflow 2.36.4包要求 Node.js 22 或更高版本，并遵循当前 n8n strict community-node 规范。
如果 n8n 进行较大版本升级，建议先重新执行测试、Lint 和 Build，再升级生产环境中的节点版本。
开发
npm ci
npm test
npm run lint
npm run build
项目使用当前 @n8n/node-cli 构建与校验体系。
从旧微信公众号节点迁移
建议新旧包短期并存，而不是直接覆盖：
1. 安装本节点；
2. 新建对应公众号 Credential；
3. 在 Workflow 中只替换微信公众号适配节点；
4. 验证真实草稿/素材结果；
5. 保留旧 Workflow 或旧版本作为回滚路径；
6. 新版本稳定运行后，再删除旧社区节点。
安全设计
https://api.weixin.qq.com；常见错误会提供更明确的诊断，例如：
40164：服务器出口 IP 未加入微信 API 白名单；45009：接口调用额度不足；45011：调用频率过高；48001：当前公众号没有该接口权限。61500：数据分析日期格式错误；61501：数据分析日期范围超出接口限制。维护原则
这个仓库长期遵循几个原则：
1.0.0 后进入低维护模式：只有生产 Bug、上游 Breaking Change 或重复真实需求才修改。更多技术细节：
