/install wechat-browser-reader
WeChat Browser Reader
Read WeChat articles via Chrome DevTools when HTTP-based extractors fail.
Prerequisites
- Chrome with remote debugging enabled:
google-chrome --no-first-run --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-debug-profile - OpenClaw browser tools available (navigate_page, evaluate_script, etc.)
Workflow
1. Navigate
navigate_page(url=\x3Carticle_url>)
2. Handle Captcha (if present)
If the page shows "环境异常" / "去验证":
take_snapshot() # find the "去验证" element
click(uid=\x3Cverify_button_uid>)
If the page shows "轻触查看原文" (non-WeChat container):
evaluate_script(() => document.querySelector('.wx_expand_article_button_wrap')?.click())
3. Wait for Content
WeChat articles use JS encryption. Content may take 3-5 seconds to decrypt after page load.
wait_for(text=["activity-name", "js_content"], timeout=15000)
4. Extract Content
evaluate_script(() => {
const title = document.getElementById('activity-name')?.innerText || '';
const author = document.getElementById('js_name')?.innerText || '';
const content = document.getElementById('js_content')?.innerText || '';
return { title, author, contentLength: content.length, content };
})
If activity-name is empty but js_content exists, content is loaded — just extract it.
If both are empty after 10+ seconds, try:
evaluate_script(() => new Promise(resolve => {
setTimeout(() => {
const el = document.getElementById('js_content');
resolve({ exists: !!el, htmlLen: el?.innerHTML?.length || 0, text: el?.innerText || '' });
}, 5000);
}))
5. Return to User
Summarize or present the article content. Key fields:
- title: article title
- author: account name
- content: full article text
Common Issues
| Symptom | Cause | Fix |
|---|---|---|
| "环境异常" | Captcha triggered | Click "去验证", wait for redirect |
| "轻触查看原文" | Non-WeChat browser | Click the button or use JS click |
| Empty content after load | JS decryption not complete | Wait 3-5 seconds, retry extraction |
| Chrome not connected | Remote debugging not running | Start Chrome with --remote-debugging-port=9222 |
| Page stuck on loading | Network or rendering issue | Reload page, check network conditions |
Tips
- Always use
evaluate_scriptwithsetTimeout(3-5s) for reliable content extraction — WeChat's JS decryption is async - If captcha keeps appearing, the IP may be rate-limited — wait a few minutes
- The approach works because a real Chrome browser executes WeChat's decryption scripts, unlike HTTP-only fetchers
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install wechat-browser-reader - After installation, invoke the skill by name or use
/wechat-browser-reader - Provide required inputs per the skill's parameter spec and get structured output
What is WeChat Browser Reader?
Read WeChat Official Account articles (mp.weixin.qq.com) via Chrome DevTools browser automation. Use when user provides a WeChat article URL and other extrac... It is an AI Agent Skill for Claude Code / OpenClaw, with 142 downloads so far.
How do I install WeChat Browser Reader?
Run "/install wechat-browser-reader" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is WeChat Browser Reader free?
Yes, WeChat Browser Reader is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does WeChat Browser Reader support?
WeChat Browser Reader is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created WeChat Browser Reader?
It is built and maintained by 反应慢 (@zmlgit); the current version is v1.0.0.