用途:把用户自己管理的微信公众号历史已发文章批量落盘到 Obsidian vault,属于 clip 家族的批量成员,与单篇归档的 soia-pkm-clip-wechat-article 互补。仅用于归档自己管理的公众号,不是通用公众号爬虫。
三条路线:路 A 官方 API(scripts/fetch_api.py,需已认证服务号/订阅号,走 freepublish/batchget 与 material/batchget_material,只覆盖草稿箱「发布」发出的文章,个人未认证号多半跑不通);路 C 公众号后台接口(scripts/fetch_mp.py,推荐读全部历史含手动群发老文,默认走 appmsgpublish 读当前登录账号,传 --name/--fakeid 则走 searchbiz+appmsg 读指定号);路 B 登录态 Cookie(scripts/fetch_cookie.py,走 profile_ext,作为路 C 失效时的备选)。三条路均按 url 去重。
安装:claude plugin marketplace add soia-team/soia-open-skills;claude plugin install soia-pkm-vault@soia。仅装单技能:npx skills add soia-team/soia-open-pkm-vault-skills -g -a '*' -s soia-pkm-clip-wechat-account -y。配置放私有 config.yml,密钥不进仓库与 vault。
用法示例:python3 scripts/fetch_mp.py --dry-run --limit 3。支持 --out、--limit、--vault、--account-name、--force、--sleep、--page-size。建议先 dry-run 小样本并向客户确认范围后再全量。
落地规范:输出到 vault 收件箱中转层(默认 Inbox/gzh-articles/<年>/),frontmatter 含 tags、source、url、title、author、published_at、captured_at、route、content_complete、topics。HTML 转 Markdown 不保证 100% 还原排版,content_complete:false 表示需人工核对。
限制:路 B/路 C 为非官方接口,有 ToS 风险,首次使用需客户显式同意并写入 consent.json(disclaimerVersion v1);token/Cookie 会过期,存在限流风险,列表接口不返回 author 字段,需用 --account-name 兜底;路 A 覆盖范围有限,不适合当作全量备份。