公众号推送控制台

Markdown 主通道 · 多图文(≤8)· 图片后台静默上传 · 城市代理出口

添加账号

注意:每个号要各自在公众号后台配置 IP 白名单(走代理就填代理机 IP)。同一代理IP的账号视为一组;代理同时作用于 API 推送和网页队列;代理账号/密码由服务商提供,无账密代理留空即可。

已有账号

名称类别AppID城市出口代理状态操作

网页登录态(声明原创 / 网页发表用)

「网页发布」流程需要账号扫码过一次(登录态一般可复用数天,过期重新扫码即可)。 点「扫码登录 / 续期」会弹出浏览器窗口,下方也会同步显示二维码;点「验证」实时检查登录态是否有效。 依赖宿主机 web-publisher/watch-login.js 在运行。
账号状态公众号Cookie 到期操作
publish 模式的结果会异步回填,刷新可看到最新状态
时间账号模式城市文章状态结果 / 原因

添加 / 更新城市代理

出口解析优先级(API 推送与网页发布共用,行为一致):账号出口代理 > 账号所属城市的城市代理 > direct 显式直连。 城市代理填 direct 表示显式直连(适用:服务器本身就在该城市,出口即本机公网 IP); 账号和城市都未配置且未声明 direct 时,推送与网页发布都会拒绝执行(绝不静默直连)。 目标城市需要有真实运行的代理机(如该地域云服务器上的 squid / 静态代理商的线路);账号密码由代理商提供,无账密留空。 注意:带账密的代理会自动拼接成 http://user:pass@IP:端口 格式存库。

已配置

城市代理出口备注操作

主题列表

主题决定文章的视觉样式(标题/表格/代码块等)。推送接口的 style 字段填主题名;不填则用带 ★ 的默认主题。主题文件存在宿主机 styles/ 目录,可直接备份。
主题名更新时间操作

编辑主题

API Key 与接口状态

第三方调用时在请求头带 X-API-Key: ...
接口状态:启用中 停用后任何 Key 都无法调用推送接口(403)
下方接口说明已含当前 Key,复制后可直接发给第三方开发人员
对外接口地址(复制文档时使用;第三方在本机调用填 http://localhost:3000,局域网调用填 http://你的IP:3000)

推送接口(唯一推送入口:JSON 或 multipart 二选一)

POST /api/push — mode: draft(草稿箱,推荐)/ publish(发布到历史消息,消耗发布额度)/ publish+notify=true(群发通知粉丝,进搜一搜索引,订阅号每天仅1次额度);accounts 可传账号名数组或 "all";articles 1~8 篇(多篇自动合成一条多图文,第 1 篇是头条)。需要原创声明时改用下方 push-web,文章参数完全一致。

curl -X POST http://localhost:3000/api/push \
  -H "Content-Type: application/json" \
  -H "X-API-Key: 你的key" \
  -d '{
    "mode": "draft",
    "accounts": ["acct_a", "acct_b"],   // 或 "all"
    "articles": [
      {
        "title": "文章标题",
        "author": "作者",
        "cover": "images/cover.png",     // 必填!封面图:data-images文件名 / http图片URL / base64 data URI
        "content": "## 正文\n\nMarkdown 内容,图片写 ![图](images/a.png)",
        "source_url": "https://...",     // 可选,阅读原文
        "digest": "摘要",                 // 可选
        "comment": false,                 // 可选,开启评论区
        "mini_program": {                 // 可选,小程序卡片(自动传图+注入标签)
          "appid": "wx...", "path": "pages/index/index",
          "title": "卡片标题", "image": "images/card.png", "text": "点击进入"
        }
      }
    ]
  }'

图片在你本地?用 multipart 形式,一次请求全推: curl -X POST .../api/push -H "X-API-Key: key" -F 'article={"title":"标题","cover":"head.png","content":"![首图](head.png)..."}' -F 'head.png=@图片路径' —— 正文图片直接写文件名,上传同名文件即自动匹配回填;cover 必填(写上传的文件名可复用); 引用了没传的文件名直接报错不静默。详见下方完整文档《形式二》。

返回:{ok, batch_id, results:[{account, ok, media_id | error, err_code}]}; 单号失败不影响其他号,详情看推送记录页。

查询批量结果:GET /api/records/batch/{batch_id}(同样需要 X-API-Key); 图片路径按 /data/images、/work/articles 顺序解析,http 地址直接下载转传; 正文支持小程序跳转标签(<a data-miniprogram-appid> / <mp-miniprogram>,不会被链接清洗移除,详见下方完整文档)。

网页发布接口(草稿 + 网页代操作)

POST /api/push-web — 唯一需要用到它的场景:要声明原创/快捷转载/代点发表。文章部分与 /api/push 完全一致(JSON/multipart 均可),额外支持原创参数;实际只存草稿,随后由本地脚本(publish-web.js)在公众号后台网页里代操作。

curl -X POST http://localhost:3000/api/push-web \
  -H "Content-Type: application/json" \
  -H "X-API-Key: 你的key" \
  -d '{
    "accounts": ["acct_a"],              // 或 "all"
    "original": true,                    // 可选,声明原创(网页脚本代勾)
    "original_scope": "all",             // 可选,all=统一全部篇 / first=仅首条(默认 all)
    "quick_reprint": false,              // 可选,开启快捷转载(必须 original=true)
    "web_publish": "draft",              // 可选,draft=脚本只存草稿 / publish=脚本代点发表(耗当日额度)
    "notify": false,                     // 可选,发表时群发通知推送给粉丝(必须 web_publish=publish,耗群发额度)
    "author": "作者名",                  // 可选,原创声明作者(必须 original=true,1~8字;不传默认「佚名」)
    "articles": [ ... ]                  // 与 /api/push 完全一致(title/content/cover 必填,1~8 篇)
  }'

流程:接口存草稿 → 推送记录出现「网页流程」任务 → 运行 node web-publisher/publish-web.js 账号名 [--publish] → 脚本按标记在网页里声明原创/快捷转载并保存。 需要该账号扫码过一次(登录态保存数天);web_status 在推送记录里跟踪进度。