核心用法
Web Publisher 是一款面向内容创作者和运营团队的微信公众号发布工具,通过纯HTTP调用实现"零本地依赖"的发布流程。用户只需提供文章URL或本地文档(PDF/DOCX/PPTX/图片/音频等),工具自动完成正文提取、可选AI改写、封面生成,最终推送至微信公众号草稿或直接发布。
典型工作流:
1. 对话式登录:运行login获取浏览器授权链接,用户点击确认后login-status自动拉取凭证
2. 公众号配置:wechat config生成短链,用户在浏览器填写AppID/AppSecret,同时需将服务端IP加入微信公众平台白名单
3. 内容发布:draft <url|file>创建草稿,publish <url|file>直接发布,支持--rewrite启用AI改写
4. 文档转换:convert <input>纯提取Markdown,不触达微信
显著优点:
- 零本地依赖:CLI仅做HTTP调用,抓取/转换/改写/发布全部由服务端完成,无需安装Chrome、Puppeteer等重型依赖
- 对话式配置:登录、公众号绑定、页眉页脚设置均通过浏览器短链+对话完成,无需编辑配置文件
- 多格式支持:基于Microsoft markitdown支持50+文档格式,配合readability适配器覆盖主流内容平台
- 安全设计:AppSecret浏览器直传服务端AES-256-GCM加密,永不出现在对话上下文;API Key一次性下发,logout即撤销
潜在缺点与局限性:
- 服务端反爬限制:云端固定IP易被小红书、部分知乎专栏、登录墙文章、海外站点屏蔽,此时需回退到用户本地安装的
news-to-markdown-skill - 文件大小限制:本地文件上限50MiB,学术PDF/扫描件需加
--async走异步队列 - 仅支持微信公众号:其他平台(知乎、头条等)仅可作为内容来源,不支持作为发布目标
- 额度消耗:URL抓取失败仍可能计费,反爬站点建议优先用本地skill
适合人群:
- 自媒体运营者:需要批量抓取多平台内容改写后发布
- 企业内容团队:有标准化排版需求(支持主题/页眉页脚)
- 知识管理用户:希望将本地文档(论文、报告、会议纪要)快速转为公众号文章
- AI Agent用户:配合
browser-web-search实现"搜索-抓取-发布"自动化链路
常规风险:
- IP白名单遗漏:新手常见踩坑,未将服务端IP加入mp.weixin.qq.com后台会导致所有发布被微信拒绝
- 凭证失效:apiKey被换/撤销后需
login --force重新绑定 - 本地回退依赖:若不安装
news-to-markdown-skill,反爬站点完全无法处理 - 任务重复:超时后手动重试会创建多个草稿,建议用
status <jobId>查询而非重试