Wechat Article For Ai

Convert WeChat Official Account (微信公众号) articles to clean Markdown files with locally downloaded images.

Security Scan

The skill's code, instructions, and requirements are coherent with its stated purpose (convert WeChat articles to Markdown with local images); it does network fetching and writes files locally but does not request unrelated credentials or system access.

Purpose & Capability

Name/description match the implementation: scraper (camoufox), parser, converter, downloader, and an MCP server are present. Required libraries (camoufox, httpx, bs4, markdownify, mcp) are consistent with scraping, rendering, and exposing a local MCP tool.

Instruction Scope

SKILL.md instructs installing Python deps and running the CLI or MCP server; runtime instructions stay within converting articles, downloading images, and optionally saving debug HTML. There are no instructions to read unrelated system files or exfiltrate secrets; the code writes output and debug HTML to the output directory as expected.

Install Mechanism

The registry has no formal install spec but includes a requirements.txt and SKILL.md instructs 'pip install -r requirements.txt'. The tool auto-downloads the Camoufox browser on first run (via the camoufox package) which will fetch browser binaries or resources from the network — this is expected for a headless-browser scraper but is a supply-chain/network fetch worth noting.

Credentials

The skill requests no environment variables, no credentials, and no config paths. Network access (fetching mp.weixin.qq.com pages and CDN image URLs) is necessary for its function and is the only external interaction in the code.

Persistence & Privilege

always is false and the MCP server runs on stdio when started; the skill does not modify other skills or persistent agent-wide settings. It writes outputs to a user-specified output directory only.

Assessment

This package appears to do what it claims, but before installing you should: (1) review and be comfortable with the camoufox dependency (it will auto-download browser components at runtime — a network fetch from its provider); (2) run it in an isolated environment or container if you want to limit network/file access; (3) confirm you trust any WeChat content you fetch (debug HTML and downloaded images are saved to disk); and (4) only enable the MCP server for trusted local AI clients since it exposes convert/batch_convert operations via the local stdio-based MCP transport. If you need extra assurance, audit the camoufox package and pinned dependency versions in requirements.txt before use.

WeChat Article to Markdown Converter

What this tool does

Converts WeChat public account articles into clean Markdown files with:

• YAML frontmatter (title, author, date, source URL)
• Locally downloaded images
• Preserved code blocks with language detection
• Audio/video reference extraction
• Clean formatting (no WeChat UI noise)

Prerequisites

• Python 3.10+
• Install dependencies: pip install -r requirements.txt
• Camoufox browser will be auto-downloaded on first run

Usage

CLI (single article)

python main.py "https://mp.weixin.qq.com/s/ARTICLE_ID"

CLI (batch from file)

python main.py -f urls.txt -o ./output -v

CLI Options

Flag	Description
-f FILE	Text file with URLs (one per line)
-o DIR	Output directory (default: ./output)
-c N	Image download concurrency (default: 5)
--no-images	Skip image download, keep remote URLs
--no-headless	Show browser (for solving CAPTCHAs)
--force	Overwrite existing output
--no-frontmatter	Use blockquote metadata instead of YAML
-v	Verbose/debug logging

MCP Server

Run as an MCP server for AI tool integration:

python mcp_server.py

Exposes two tools:

• convert_article(url, output_dir, download_images, concurrency, use_frontmatter) — Convert a single article
• batch_convert(urls, output_dir, download_images, concurrency) — Convert multiple articles

MCP Configuration (for claude_desktop_config.json or similar)

{
  "mcpServers": {
    "wechat-to-md": {
      "command": "python",
      "args": ["mcp_server.py"],
      "cwd": "<path-to-this-project>"
    }
  }
}

Output Structure

output/
  <article-title>/
    <article-title>.md    # Markdown file with YAML frontmatter
    images/
      img_001.png
      img_002.jpg
      ...

Common Issues

• CAPTCHA/verification page: Run with --no-headless to manually solve the CAPTCHA in the browser window, then retry.
• Empty content: WeChat may rate-limit requests. Wait a few minutes and try again.
• Image download failures: Failed images keep their remote URLs in the markdown. Re-run with --force to retry.

Limitations

• Only supports articles from mp.weixin.qq.com
• Requires a working internet connection and the ability to run a headless browser
• WeChat may block automated access; Camoufox helps evade detection but is not guaranteed