这份文档怎么用:整份复制,发给你的 AI 助手(WorkBuddy / CodeBuddy 等能读写文件、能执行命令的 AI),再加一句「按这份文档帮我配置」。
文档里所有命令、脚本、报错都是实测过的,照着走就能跑通。
版本:2026-11-02 实测环境:个人主体、未认证订阅号。
把下面这段和整份文档一起发给 AI。
你现在帮我做一件事:把我的公众号文章,通过官方接口自动推进草稿箱。
请先完整读一遍我发你的这份文档,然后严格按这个节奏跟我配合:
1. 先别写代码。用三句话告诉我:这套东西能做什么、不能做什么、我大概要花多久。
2. 然后把「第 2 节」的准备清单发给我,逐项问我拿到了哪些、缺哪些。
3. 缺的我去补,补一个你确认一个。不要跳步,不要假设我已经有了。
4. 七样齐了再开始装环境、建脚本。
5. 每一步做完,用一句话告诉我「现在是什么状态」,再进下一步。
6. 到了「第 7 节」的决策点,必须主动问我要不要开定时任务,不要自己替我决定。
7. 中途报错,先查「第 8 节」的错误码对照表,不要瞎猜、不要反复重试同一条命令。
8. 任何时候,不要替我点「发表」。
我的情况:
- 操作系统:______(Windows / macOS / Linux)
- 有没有云服务器:______(有 / 没有 / 不知道)
- 公众号主体:______(个人 / 公司,是否已认证)
一句话:AI 帮你把「排版 + 传图 + 写摘要 + 配封面 + 存草稿」全干完,最后那一下「发表」你自己点。
| 能力 | 个人主体未认证订阅号 | 已认证的企业号 |
|---|---|---|
| 拿接口凭证 | ✅ | ✅ |
| 上传封面、正文配图 | ✅ | ✅ |
| 新建草稿 | ✅ | ✅ |
| 删除草稿、列草稿 | ✅ | ✅ |
| 自动发布 | ❌ 返回 48001 |
✅ |
| 群发推送给粉丝 | ❌ | ✅ |
为什么个人号不能自动发布:微信 2025 年 7 月起,回收了个人主体账号的发布接口权限。这不是技术问题,是平台规则,任何工具都绕不过去。
| 你的号 | 能到什么程度 | 代价 |
|---|---|---|
| 个人主体(未认证) | 全自动到草稿箱,手动点发表 | 0 元 |
| 企业主体 + 微信认证 | 全自动写完发出去 | 300 元/年认证费 |
时间成本:第一次配置 20~40 分钟。之后每篇 30 秒。
| # | 要准备什么 | 怎么拿 | 缺了会怎样 |
|---|---|---|---|
| 1 | 一个公众号(订阅号即可) | 已有 | 没号什么都做不了 |
| 2 | AppID | 后台 → 设置与开发 → 基本配置 | 接口认不出你是谁 |
| 3 | AppSecret(开发者密码) | 同一页,点「重置」生成 | 拿不到通行证 |
| 4 | 公众号登录密码 | 你自己设的。忘了要邮箱重置 | 生成密钥那一步过不去 ← 最常卡在这 |
| 5 | 公众号绑定的邮箱 | 后台 → 设置与开发 → 账号设置 | 密码忘了就没救了 |
| 6 | 一个 IP 固定的电脑或服务器 | 见第 4 节 | 接口报 40164 |
| 7 | 你的文稿素材 | 自己攒的,几篇都行 | 没东西可发 |
绝大多数人平时都是扫码登录公众号,根本没设过密码。
而重置 AppSecret 时,微信会强制要求「账号密码验证」——这是死规定,绕不过去。
所以先确认:你还记得公众号的登录密码吗?
先把这个弄好,再开始配置。不然一定会卡在生成密钥那一步,白折腾。
路径:公众号后台 → 设置与开发 → 基本配置
页面上「开发者ID(AppID)」那一行,一长串 wx 开头的,复制下来。
AppID 不是秘密,不敏感,但它决定了你调用的是哪个号,别复制错。
同一页,「开发者密码(AppSecret)」那一行:
**** 加一个「重置」按钮 → 说明还没生成过,点「重置」第 1 步 身份确认 —— 用管理员微信扫码
第 2 步 密码验证 —— 输入公众号登录密码
第 3 步 查看开发者密码 —— 新密钥完整显示一次
关键细节(很多人栽在这):新密钥在第 3 步一显示,它就已经生效了;但旧密钥要等整个流程提交完成才作废。
如果看到密码就关窗口,会出现一个很诡异的状态:新旧两个密钥同时都能用。你以为已经重置了,其实没有。
所以:扫完码、输完密码、看到密钥之后,别急着关窗口,确认流程自己走完。
想验证「重置有没有真的生效」,让 AI 按第 8 节末尾的「密钥有效性三连测」跑一遍。
微信的接口不是拿着密钥就能调,它还要确认是谁在调。
只有白名单里登记过的 IP,才能换到 access_token。不在名单里,直接报:
errcode: 40164 invalid ip 1.2.3.4, not in whitelist
| 你的情况 | 能不能跑 | 代价 |
|---|---|---|
| 有云服务器(最省事) | ✅ 长期稳定 | 一年百来块,或者复用你已有的服务器 |
| 只有自己的电脑 | ✅ 能用 | 宽带 IP 一变就要回后台改白名单,每次都要扫码 + 输密码 |
| 家里路由器重启、换网络、出差 | ⚠️ IP 大概率变了 | 同上,改一次白名单 |
重要:服务器不用为了这件事专门买。如果你已经有跑网站、跑其他项目的云服务器,直接用就行——这套脚本零依赖、跑完就退出,占不到 1MB 内存。
⚠️ 白名单是公众号后台自己的设置,跟你云服务器的安全组、防火墙是两回事,别搞混。
不用留。只放你实际跑脚本的那一台就行。
旧 IP 留着是隐患:宽带 IP 会被运营商回收再分配给别人,而那个人不需要做任何事,就已经「在白名单里」了。
在你电脑或服务器上建一个目录,比如 wxpub/:
wxpub/
├── wxpub.py ← 主脚本(下面第 5.2 节的完整代码)
├── .env ← 存 AppID 和 AppSecret(权限 600)
├── .token_cache.json ← 自动生成,存 token,别删别外传
└── articles/ ← 每篇文章一个文件夹或一组文件
├── 001.json
├── 001-body.html
└── 001-cover.png
让 AI 把下面的代码原样保存成
wxpub.py。不要「优化」,不要改结构。
纯标准库,Python 3.6 以上就能跑,不需要 pip install 任何东西。
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
公众号草稿推送(单文件版,零第三方依赖,Python 3.6+)
用法:
python wxpub.py test # 只测密钥和白名单
python wxpub.py push articles/001.json # 推一篇进草稿箱
python wxpub.py list # 列出草稿箱
凭据:读同目录 .env,文件里两行
WX_APPID=wx................
WX_APPSECRET=................
"""
import json
import mimetypes
import os
import re
import sys
import time
import urllib.parse
import urllib.request
import uuid
API = "https://api.weixin.qq.com"
HERE = os.path.dirname(os.path.abspath(__file__))
ENV_FILE = os.path.join(HERE, ".env")
CACHE = os.path.join(HERE, ".token_cache.json")
ERR_HINT = {
40164: "调用方 IP 不在公众号后台白名单里。去「设置与开发 → 基本配置 → IP白名单」加上当前公网 IP。",
40013: "AppID 无效,检查有没有复制完整。",
40125: "AppSecret 无效或已被重置。回后台重新生成一个。",
40001: "access_token 无效。通常是对应的 AppSecret 错了,或 token 被别处刷新顶掉了。",
45009: "接口调用次数超限(每天 2000 次)。",
48001: "这个账号没有该接口权限。个人主体订阅号常见。",
45110: "接口被微信回收。个人主体账号的发布/群发接口 2025 年 7 月起已回收。",
40007: "media_id 无效,封面图可能没上传成功。",
40009: "图片尺寸或大小不符合要求(封面建议 900x383,且小于 10MB)。",
53404: "草稿箱满了(上限 100 篇),先去后台清理。",
}
def load_env():
if not os.path.exists(ENV_FILE):
return
with open(ENV_FILE, "r", encoding="utf-8") as f:
for line in f:
line = line.strip()
if not line or line.startswith("#") or "=" not in line:
continue
k, v = line.split("=", 1)
os.environ.setdefault(k.strip(), v.strip().strip('"').strip("'"))
def die(msg, code=1):
sys.stderr.write("\n[失败] %s\n" % msg)
sys.exit(code)
def ok(msg):
sys.stdout.write("[OK] %s\n" % msg)
def info(msg):
sys.stdout.write(" %s\n" % msg)
def check(j, what):
if isinstance(j, dict) and j.get("errcode"):
c = j["errcode"]
hint = ERR_HINT.get(c, "")
die("%s 失败:errcode=%s errmsg=%s%s"
% (what, c, j.get("errmsg", ""), ("\n 原因:" + hint) if hint else ""))
return j
def http_get_json(url, timeout=30):
req = urllib.request.Request(url, headers={"User-Agent": "wxpub/1.0"})
with urllib.request.urlopen(req, timeout=timeout) as r:
return json.loads(r.read().decode("utf-8"))
def http_post_json(url, payload, timeout=60):
data = json.dumps(payload, ensure_ascii=False).encode("utf-8")
req = urllib.request.Request(url, data=data, headers={
"Content-Type": "application/json; charset=utf-8",
"User-Agent": "wxpub/1.0"})
with urllib.request.urlopen(req, timeout=timeout) as r:
return json.loads(r.read().decode("utf-8"))
def http_post_file(url, path, timeout=180):
boundary = "----WXBoundary" + uuid.uuid4().hex
name = os.path.basename(path)
ctype = mimetypes.guess_type(name)[0] or "application/octet-stream"
with open(path, "rb") as f:
blob = f.read()
head = ("--%s\r\n"
'Content-Disposition: form-data; name="media"; filename="%s"\r\n'
"Content-Type: %s\r\n\r\n" % (boundary, name, ctype)).encode("utf-8")
tail = ("\r\n--%s--\r\n" % boundary).encode("utf-8")
req = urllib.request.Request(url, data=head + blob + tail, headers={
"Content-Type": "multipart/form-data; boundary=" + boundary,
"User-Agent": "wxpub/1.0"})
with urllib.request.urlopen(req, timeout=timeout) as r:
return json.loads(r.read().decode("utf-8"))
def get_token(force=False):
load_env()
appid = os.environ.get("WX_APPID", "").strip()
secret = os.environ.get("WX_APPSECRET", "").strip()
if not appid or not secret:
die("缺少 WX_APPID / WX_APPSECRET。\n"
" 在同一目录建 .env 文件,写两行:\n"
" WX_APPID=wx................\n"
" WX_APPSECRET=................")
tag = secret[:8]
now = int(time.time())
if not force and os.path.exists(CACHE):
try:
with open(CACHE, "r") as f:
c = json.load(f)
# 同时比对 appid 和密钥前缀,换过密钥就不会误用旧 token
if c.get("appid") == appid and c.get("sk") == tag \
and int(c.get("expire_at", 0)) - 300 > now:
info("access_token 用缓存(还剩 %d 秒)" % (int(c["expire_at"]) - now))
return c["access_token"]
except Exception:
pass
q = urllib.parse.urlencode({"grant_type": "client_credential",
"appid": appid, "secret": secret})
j = check(http_get_json(API + "/cgi-bin/token?" + q), "获取 access_token")
tok = j.get("access_token")
if not tok:
die("返回里没有 access_token:%s" % j)
try:
with open(CACHE, "w") as f:
json.dump({"appid": appid, "sk": tag, "access_token": tok,
"expire_at": now + int(j.get("expires_in", 7200))}, f)
os.chmod(CACHE, 0o600)
except Exception:
pass
ok("access_token 已获取(有效期 %s 秒)" % j.get("expires_in"))
return tok
def upload_inline_images(tok, html, base_dir):
"""正文里的本地图片先传到微信,换成 mmbiz 地址,否则发出去是裂图。"""
def repl(m):
src = m.group(1)
if src.startswith("http"):
return m.group(0)
p = src if os.path.isabs(src) else os.path.join(base_dir, src)
if not os.path.exists(p):
info("正文图片找不到,已跳过:%s" % src)
return m.group(0)
r = check(http_post_file(
API + "/cgi-bin/media/uploadimg?access_token=" + tok, p), "上传正文图片")
url = r.get("url", "")
ok("正文图片已上传:%s" % url[:60])
return m.group(0).replace(src, url)
return re.sub(r'<img[^>]+src="([^"]+)"', repl, html)
def upload_cover(tok, path):
r = check(http_post_file(
API + "/cgi-bin/material/add_material?access_token=%s&type=image" % tok, path),
"上传封面")
mid = r.get("media_id")
if not mid:
die("封面图上传后没拿到 media_id:%s" % r)
ok("封面 media_id = %s" % mid)
return mid
def cmd_test(force=False):
tok = get_token(force=force)
j = check(http_get_json(
API + "/cgi-bin/account/getaccountbasicinfo?access_token=" + tok), "读取账号信息")
ok("接口通了,账号信息:")
for k in ("nick_name", "user_name", "principal_name"):
if j.get(k):
info("%-14s %s" % (k + ":", j[k]))
info("verify_type: %s (-1=未认证, 0=已认证)" % j.get("verify_type"))
def cmd_list():
tok = get_token()
j = check(http_post_json(
API + "/cgi-bin/draft/batchget?access_token=" + tok,
{"offset": 0, "count": 20, "no_content": 1}), "读取草稿列表")
print("草稿箱共 %s 篇\n" % j.get("total_count"))
for it in j.get("item", []):
n = ((it.get("content") or {}).get("news_item") or [{}])[0]
print(" %-46s %s" % (n.get("title", "")[:46], it.get("media_id")))
def cmd_push(article_path):
with open(article_path, "r", encoding="utf-8") as f:
art = json.load(f)
base = os.path.dirname(os.path.abspath(article_path))
for k in ("title", "body", "thumb"):
if not art.get(k):
die("文章配置缺字段:%s" % k)
if len(art["title"]) > 64:
die("标题 %d 字,超过微信 64 字上限" % len(art["title"]))
body_path = art["body"] if os.path.isabs(art["body"]) else os.path.join(base, art["body"])
thumb_path = art["thumb"] if os.path.isabs(art["thumb"]) else os.path.join(base, art["thumb"])
for p in (body_path, thumb_path):
if not os.path.exists(p):
die("文件不存在:%s" % p)
with open(body_path, "r", encoding="utf-8") as f:
html = f.read()
digest = (art.get("digest") or "").strip()
if not digest:
digest = re.sub(r"\s+", " ", re.sub(r"<[^>]+>", "", html)).strip()[:120]
ok("标题:%s(%d 字)" % (art["title"], len(art["title"])))
info("摘要:%s" % digest[:60])
info("正文:%d 字节" % len(html.encode("utf-8")))
info("封面:%s(%.0f KB)"
% (os.path.basename(thumb_path), os.path.getsize(thumb_path) / 1024.0))
tok = get_token()
html = upload_inline_images(tok, html, base)
mid = upload_cover(tok, thumb_path)
payload = {"articles": [{
"title": art["title"],
"author": art.get("author", ""),
"digest": digest,
"content": html,
"content_source_url": art.get("source_url", ""),
"thumb_media_id": mid,
"need_open_comment": 1,
"only_fans_can_comment": 0,
}]}
j = check(http_post_json(
API + "/cgi-bin/draft/add?access_token=" + tok, payload), "新建草稿")
print("")
ok("已进草稿箱")
info("media_id: %s" % j.get("media_id"))
print("")
print("下一步:手机微信 → 订阅号消息 → 右上角 → 草稿箱 → 预览 → 手动点发表")
def main():
if len(sys.argv) < 2:
print(__doc__)
return
cmd = sys.argv[1]
if cmd == "test":
cmd_test("--refresh" in sys.argv)
elif cmd == "push":
if len(sys.argv) < 3:
die("用法:python wxpub.py push articles/001.json")
cmd_push(sys.argv[2])
elif cmd == "list":
cmd_list()
else:
print(__doc__)
if __name__ == "__main__":
main()
在 wxpub/ 目录下建一个 .env 文件,写两行:
WX_APPID=你的AppID
WX_APPSECRET=你的AppSecret
然后把它权限收紧(Linux / macOS):
chmod 600 .env
Windows 上这条命令可以跳过,但别把
.env放进任何同步网盘、也别提交到 Git。
# 1. 先看语法有没有问题
python wxpub.py
# 2. 测密钥和白名单
python wxpub.py test --refresh
成功长这样:
[OK] access_token 已获取(有效期 7200 秒)
[OK] 接口通了,账号信息:
nick_name: 你的公众号名字
principal_name: 你的主体名称
verify_type: -1 (-1=未认证, 0=已认证)
看到这个,说明密钥对、白名单通、接口能用,最难的部分过去了。
⚠️ 一定要加
--refresh。不加的话它可能直接读缓存,你换了密钥也测不出来,会误以为一切正常。
每篇文章准备三样:
| 文件 | 是什么 | 要求 |
|---|---|---|
001-body.html |
正文 HTML | 只用内联样式,见 6.2 |
001-cover.png |
封面图 | 建议 900×383,小于 10MB |
001.json |
配置 | 见 6.4 |
微信的编辑器会清洗它不认识的东西。所以:
| ✅ 可以 | ❌ 会被删掉 |
|---|---|
内联 style="..." |
<style> 标签 |
<p> <section> <strong> <img> |
class 属性 |
| 普通 inline CSS | JavaScript、<script> |
正确的写法:
<section style="font-size:16px;line-height:1.85;color:#3f3f3f;">
<p style="margin:0 0 22px;">这里是正文第一段,每段之间留 22px 空隙。</p>
<p style="margin:0 0 10px;font-size:17px;font-weight:bold;
border-left:3px solid #4a9ee0;padding-left:10px;">小标题这样写</p>
<p style="margin:0 0 22px;">小标题下面的正文。</p>
</section>
几个实测好用的细节:
16px,行高 1.85,颜色 #3f3f3f——手机上看着不累22px,别一行行手敲 <br>background:#F4F8FC + 左边框),别混在正文里media_id,才能建草稿——缺封面存不了articles/001.json:
{
"title": "标题,64 字以内",
"author": "作者名,短一点",
"digest": "摘要,120 字以内。留空会自动截取正文开头",
"body": "001-body.html",
"thumb": "001-cover.png"
}
python wxpub.py push articles/001.json
成功会打印 media_id。然后:
python wxpub.py list
能看到刚推的那篇,就说明真的进箱了。
一定要回查。有两次我们以为成功了,其实是排版被清洗、或者标题截断,肉眼在后台列表里根本看不出来。
基础链路已经通了,你的第一篇草稿在后台。
现在有两个可选的自动化,要不要开,你自己定:
A. 每天固定时间,自动生成一篇草稿推进草稿箱。
你只管审核和点发表。安全,推荐。
B. 连最后那一下「发表」也自动点掉。
技术上能做,但有三件事你必须先知道:
① 公众号后台几天不操作就要重新扫码,定时任务半夜跑起来遇到登录失效,
会卡在那里,你可能以为发出去了其实没发;
② 发表不可撤回,订阅号一天只有一次群发额度,点错了改不回来;
③ 平台对异常操作有风控,可能出现验证码或限制。
你要 A、要 B、两个都要,还是都不要?
前提:素材提前准备好,存在一个固定目录。
素材目录/
├── 未使用/
│ ├── 001-标题.md
│ ├── 002-标题.md
│ └── ...
├── 已使用/
└── 日志.txt
给 AI 的定时任务提示词(直接抄):
每天早上 8:00,做这几件事:
1. 扫描「未使用」目录,按文件名排序,取第一篇。
2. 按《公众号草稿自动推送操作文档》第 6 节的排版规范,把它整理成正文 HTML:
- 只保留内联样式,不要 style 标签、不要 class
- 口语稿要做断句、加标点、去「啊、那么、这个、就是说」这类填充词
- 不新增原文没有的观点、数据、例子
- 加小标题分段,但不改变原意
3. 生成封面图,900×383。
4. 写对应的 json 配置,推送到公众号草稿箱。
5. 成功后,把素材文件移到「已使用」目录。
6. 失败就把错误码和原因追加到「日志.txt」,不要重试超过 2 次。
7. 全部做完,用一句话告诉我:今天推了哪一篇,成功还是失败。
注意:不要尝试自动发表。只到草稿为止。
节奏建议:
53404技术上怎么做:定时任务 → 启动浏览器 → 进公众号后台草稿箱 → 找到目标那篇 → 点「发表」。
前提条件(缺一个就白搭):
🔴 三个必须接受的风险:
| 风险 | 具体表现 | 后果 |
|---|---|---|
| 登录态过期 | 后台几天不操作要重新扫码 | 任务卡住,你以为发了其实没发 |
| 点错不可逆 | 草稿箱里有好几篇,按钮位置相近 | 发错文章,且无法撤回 |
| 平台风控 | 自动化操作特征明显 | 账号出现验证码或功能限制 |
如果还是要开,必须加这三道保险:
我的建议:A 开,B 先别开。
一天点一次按钮,十秒钟的事。省这十秒,赌的是「发错一篇不可撤回」——不值。
真要做到全自动发布,正规解法是企业主体 + 微信认证(300 元/年),那才是名正言顺的自动发布。
| 错误码 | 意思 | 怎么办 |
|---|---|---|
40164 |
IP 不在白名单 | 查当前公网 IP,加进后台白名单(要扫码 + 密码) |
40125 |
AppSecret 无效 | 密钥错了或已被重置,重新生成 |
40013 |
AppID 无效 | 复制不完整,重新复制 |
40001 |
access_token 无效 | 通常是密钥错,或 token 被别的工具顶掉了 |
48001 |
无此接口权限 | 个人号没有发布权限,正常现象,只能手动点 |
45110 |
接口被回收 | 2025 年 7 月起的政策,个人主体号的发布/群发 |
45009 |
调用次数超限 | 每天 2000 次,等明天 |
40007 |
media_id 无效 | 封面没传成功,重传 |
40009 |
图片不合规 | 封面改 900×383,压到 10MB 以内 |
53404 |
草稿箱满了 | 上限 100 篇,去后台删一些 |
40164。重查 IP,重加白名单。40001。别同时用。<style> 标签或 class。改成内联样式。draft/add 是「新增」不是「覆盖」。同一篇改完重推,草稿箱会多一份,记得先删旧的。不要只测新密钥能不能用,要测旧的死没死。让 AI 跑这三条:
1. 用一个故意写错的假密钥取 token → 必须返回 40125(这是对照组,证明接口真的在校验)
2. 用新密钥取 token → 必须成功
3. 用旧密钥取 token → 必须返回 40125。如果还能成功,说明旧密钥没死,泄露没堵住
少了第 1 条对照,结论就不可信——很可能接口只是返回了缓存,看着「都能用」,其实是假象。
最后那句还是得说:发出去之前,自己看一遍。AI 排版很稳,但它不知道哪句话不该说。
想存一份到本地,或者转给同事看:下载原文 .md 文件。
下载 .md 原文