القائمة
Use when the user asks to download, archive, crawl, scrape, or export articles from a WeChat official account (公众号).
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/konglong87/wechat-download-skill --skill wechat-downloadيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
عرض SKILL.md
| name | wechat-download |
| description | Use when the user asks to download, archive, crawl, scrape, or export articles from a WeChat official account (公众号). |
| version | 1.0.1 |
通过本地部署的 wechat-download-api 服务，批量下载任意微信公众号的全部历史文章（含完整内容）。
本 skill (调用脚本) → wechat-download-api (本地 HTTP 服务 :8765) → 微信公众平台 API
用户安装本 skill 后，只需要在 agent 里说「下载 XXX 的公众号文章」。除扫码登录外，不要要求用户手动部署底层服务；agent 应优先自动运行本目录脚本完成环境准备。
从 skill 目录运行：
cd ~/.claude/skills/wechat-download
bash scripts/start_wechat_api.sh
# 默认端口 8765，可指定: bash scripts/start_wechat_api.sh 9876
脚本会自动发现 ./wechat-download-api、../wechat-download-api，也支持通过 WECHAT_API_REPO 环境变量定位。找不到时会自动 clone wechat-download-api 到当前 skill 目录，并安装底层服务依赖。
端口说明：本 skill 默认使用
8765而非 upstream 的5000，因为 macOS 上5000常被系统服务占用。如果你用 upstream 的start.sh启动了服务（端口5000），请在命令前加WECHAT_API_URL=http://localhost:5000。
脚本会自动：
.env（如果不存在）前提：用户需要有一个微信公众号（订阅号/服务号均可）。
http://localhost:8765/login.html.env，有效期约 4 天如果用户没有公众号，见下方「备选方案」。
如果服务还没启动，先运行：
bash scripts/start_wechat_api.sh
然后检查服务状态：
python3 scripts/download_wechat.py status
curl -s http://localhost:8765/api/admin/status
如果 isExpired: true → 重新扫码登录。
python3 scripts/download_wechat.py search "公众号名称"
从输出中获取 fakeid。
python3 scripts/download_wechat.py download "fakeid" 200 ./output_dir
功能：
.txt 文件failures.jsonpython3 scripts/download_wechat.py list "fakeid" 0 50 # 查看文章列表
python3 scripts/download_wechat.py rss "fakeid" # 获取 RSS 地址
ERROR: [Errno 48] address already in use
解决：换一个端口：bash scripts/start_wechat_api.sh 9876
url = a.get("url", "") # ❌ 错误！
url = a.get("link", "") # ✓ 正确
API 返回的文章列表使用 link 字段，不是 url。
Rate limited: 请求过于频繁，请X秒后重试
解决：脚本已内置自适应退避。如果仍然频繁触发，增大 MIN_DELAY（默认 3.2 秒）。
触发微信安全验证。
解决：
.env 中配置 PROXY_URLS（SOCKS5 代理池）无法获取文章内容。可能原因：文章被删除、访问受限或需要验证。
原因：文章已被删除 / 是广告推广 / 图片分享 / 微信风控。跳过即可，通常占 30-50%。
原因：微信凭证有效期约 4 天。
解决：重新访问 http://localhost:8765/login.html 扫码。
ModuleNotFoundError: No module named 'curl_cffi'
解决：需要可用的 C 编译器。macOS 需安装 Xcode CLT（xcode-select --install），Linux 需 build-essential 和 libcurl4-openssl-dev。预编译 wheel 在 PyPI 上覆盖主流平台。
如果用户没有微信公众号无法登录，可以用以下方法：
"公众号名" mp.weixin.qq.com/s 获取文章链接，直接访问 mp.weixin.qq.com 提取 #js_content 中的内容https://mp.weixin.qq.com/s/{short_id} 或带 __biz/mid/idx/sn 参数的完整链接استنادا إلى تصنيف SOC المهني
