微信公众号文章读取器#

入口#

bash

cd ~/.openclaw/agents/xingchen/workspace/skills/wechat-article-reader
python3 scripts/gzh_article.py <command> [args]

环境变量配置#

详见 env-guide.md（MPTEXT_API_KEY 和 Cookie 的获取与配置说明）。

命令（12个）#

常用命令#

命令说明fetch "<url>"抓取单篇文章全文（标题+正文），curl 优先，不需要公众号名full "公众号名" [数量]列出某公众号文章+每篇预览前800字，不含阅读量list "公众号名" [数量]列出文章标题+摘要digest，不含正文mpsearch "<关键字>"按名称搜索公众号，返回名称和fakeidstats "<url>"拿文章标题搜 trends API，返回相似爆款文章的互动数据（新文章可能无结果）trends "<关键词>"查某关键词下的爆款文章列表，含阅读/点赞/评论数据compare --accounts "名1,名2" [--count N]对比多个公众号的文章列表compare --urls "url1,url2"对比多个链接对应的公众号文章列表compare "<关键词>"按关键词查爆款文章（不是对比，是搜索）resolve "<标题>"根据标题搜索并匹配文章链接

专用命令#

命令说明mparticles "<fakeid>" [数量]从 fakeid 查文章列表mparticles_by_url "<url>" [数量]从 URL 提取 biz 再查文章列表（URL 需含 __biz）mpinfo "<fakeid>"查公众号主体信息（公司名、是否认证、原创文章数）mpdownload "<url>" [格式]下载文章正文（mptext 方式，不含标题）

自动降级链路#

3 层路径#

命令P1P2P3fetchcurl（免费）mptextCookiecompare --urlsbiz→mptext正文识别账号名→mptextCookiemparticles_by_urlbiz→mptext正文识别账号名→mptextCookie

2 层路径#

命令P1P2listmptextCookiefullmptextCookiecompare --accountsmptextCookieresolvemptextCookiempsearchmptextCookiemparticlesmptextCookiempdownloadmptextcurl

单路径#

命令唯一路径statstrends APItrendstrends APImpinfomptext

已知局限#

• fetch 内容截断：JS验证拦截的文章只能拿 ~800 字，换 P2 可能完整
• mparticles_by_url：URL 不含 __biz 时走正文识别公众号名路径，无需 biz
• stats：仅对爆款文章有效，新文章无结果时提示"所有关键词查询均失败"
• 历史列表不全：原生 API 最多约 436 篇

详细说明见 references/priority.md