# WeChat Article Downloader

Downloads WeChat official account articles as HTML, PDF, Word, Markdown or MHTML.

- Repository: https://github.com/qiye45/wechatDownload (9937 stars)
- Category: Media
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add qiye45/wechatDownload --skill wechat-article-downloader -g -a claude-code -y`
Codex: `npx skills add qiye45/wechatDownload --skill wechat-article-downloader -g -a codex -y`
Cursor: `npx skills add qiye45/wechatDownload --skill wechat-article-downloader -g -a cursor -y`
Gemini CLI: `npx skills add qiye45/wechatDownload --skill wechat-article-downloader -g -a gemini-cli -y`

## Description

Download WeChat official account articles in multiple formats (HTML, PDF, Word, Markdown, TXT, MHTML), including single article download, collection (appmsgalbum) download, local bulk workflows, and metadata export. Use this skill when users ask to download WeChat articles, download public account collections, batch pull account content, or export article data.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# WeChat Article Downloader

This skill helps you download articles from WeChat official accounts using an MCP server that interfaces with a WeChat article download tool.

## Prerequisites

The skill uses local MCP endpoint `http://127.0.0.1:4545/mcp` for full functionality.

If local MCP is unavailable, you may fallback to `https://changfengbox.top/api/mcp` for remote-supported tools.

Local MCP tools:
- `single_article_download` - Download a single article
- `get_public_account_id` - Get public account credentials
- `batch_download_articles` - Batch download all articles from an account
- `export_article_data` - Export article metadata to CSV

Remote fallback MCP (`https://changfengbox.top/api/mcp`) currently supports:
- Methods: `initialize`, `tools/list`, `tools/call`
- Tools in `tools/call` `name`:
  - `wechat` - Download a single article
  - `wechat_collection` - Download a public account collection (`appmsgalbum`)

Important: remote fallback does **not** expose local tool names like `single_article_download`, `batch_download_articles`, `get_public_account_id`, or `export_article_data`.

## Workflow

### 1. Check Local MCP Server Status

Before using most functionality, verify local MCP is running:

```python
import requests

LOCAL_MCP_ENDPOINT = "http://127.0.0.1:4545/mcp"

def check_local_mcp():
    response = requests.post(
        LOCAL_MCP_ENDPOINT,
        json={"jsonrpc": "2.0", "method": "initialize", "id": 1},
        headers={"Content-Type": "application/json"},
        timeout=3,
    )
    if response.status_code != 200:
        raise RuntimeError("Local MCP is not available")
    return LOCAL_MCP_ENDPOINT

local_mcp_endpoint = check_local_mcp()
```

If local MCP is inaccessible, inform the user they need to:
1. Open the WeChat article download tool
2. Check the "启动MCP" checkbox to start the MCP service
3. Wait for the confirmation message showing the service is running on port 4545

### 2. Single Article Download

The rest: https://github.com/qiye45/wechatDownload/blob/HEAD/skills/wechat-article-downloader/SKILL.md
