wechat-downloadlisted

# 微信公众号文章下载 通过本地部署的 [wechat-download-api](https://github.com/tmwgsicp/wechat-download-api) 服务，批量下载任意微信公众号的全部历史文章（含完整内容）。 ## 触发条件 - 用户要求下载/爬取微信公众号文章 - 用户要求搜索公众号并获取文章 - 用户说「下载 XX 公众号的文章」 - 用户提到 wechat-download / 公众号下载 / 微信文章抓取 ## 架构 ``` 本 skill (调用脚本) → wechat-download-api (本地 HTTP 服务 :8765) → 微信公众平台 API ``` - **wechat-download-api**：第三方开源服务，使用 Chrome TLS 指纹（curl_cffi）模拟浏览器，通过微信公众平台后台凭证调用接口 - **本 skill 脚本**：封装了 API 的搜索、列表、下载功能，带限频自适应和断点续传 ## 使用方式 用户安装本 skill 后，只需要在 agent 里说「下载 XXX 的公众号文章」。除扫码登录外，不要要求用户手动部署底层服务；agent 应优先自动运行本目录脚本完成环境准备。 ### 1. 启动服务 从 skill 目录运行： ```bash 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`。 脚本会自动： - 查找或下载 wechat-download-api 仓库 - 创建 `.env`（如果不存在） - 安装缺失的 Python 依赖 - 后台启动服务 ### 2. 扫码登录 **前提：用户需要有一个微信公众号（订阅号/服务号均可）。** 1. 浏览器打开 `http://localhost:8765/login.html` 2. 用公众号管理员微信扫码 3. 登录成功后凭证自动保存到 `.env`，有效期约 **4 天** > 如果用户没有公众号，见下方「备选方案」。 --- ## 操作流程 ### 第一步：检查/启动服务 如果服务还没启动，先运行： ```bash bash scripts/start_wechat_api.sh ``` 然后检查服务状态： ```bash python3 scripts/download_wechat.py status ``` ### 第二步：检查登录 ```bash curl -s http://localhost:8765/a