bzd6661/wechat-article-for-ai

WeChat-Artikel-zu-Markdown-Konverter

Was dieses Tool tut

Konvertiert WeChat Public Account Artikel in saubere Markdown-Dateien mit:

• YAML-Frontmatter (Titel, Autor, Datum, Quell-URL)
• Lokal heruntergeladenen Bildern
• Erhaltenen Codeblöcken mit Spracherkennung
• Extraktion von Audio-/Videoreferenzen
• Sauberer Formatierung (kein WeChat-UI-Rauschen)

Voraussetzungen

• Python 3.10+
• Abhängigkeiten installieren: pip install -r requirements.txt
• Camoufox-Browser wird beim ersten Start automatisch heruntergeladen

Verwendung

CLI (einzelner Artikel)

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

CLI (Stapelverarbeitung aus Datei)

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

CLI-Optionen

Flag	Beschreibung
-f DATEI	Textdatei mit URLs (eine pro Zeile)
-o VERZ	Ausgabeverzeichnis (Standard: ./output)
-c N	Parallelität beim Bilddownload (Standard: 5)
--no-images	Bilddownload überspringen, entfernte URLs behalten
--no-headless	Browser anzeigen (zum Lösen von CAPTCHAs)
--force	Vorhandene Ausgabe überschreiben
--no-frontmatter	Blockquote-Metadaten statt YAML verwenden
-v	Ausführliche/Debug-Protokollierung

MCP-Server

Als MCP-Server für die Integration mit KI-Tools ausführen:

python mcp_server.py

Stellt zwei Tools bereit:

• convert_article(url, output_dir, download_images, concurrency, use_frontmatter) — Konvertiert einen einzelnen Artikel
• batch_convert(urls, output_dir, download_images, concurrency) — Konvertiert mehrere Artikel

MCP-Konfiguration (für claude_desktop_config.json oder ähnlich)

{
  "mcpServers": {
    "wechat-to-md": {
      "command": "python",
      "args": ["mcp_server.py"],
      "cwd": "<Pfad-zu-diesem-Projekt>"
    }
  }
}

Ausgabestruktur

output/
  <artikel-titel>/
    <artikel-titel>.md    # Markdown-Datei mit YAML-Frontmatter
    images/
      img_001.png
      img_002.jpg
      ...

Häufige Probleme

• CAPTCHA/Verifizierungsseite: Führen Sie das Tool mit --no-headless aus, um das CAPTCHA manuell im Browserfenster zu lösen und wiederholen Sie den Vorgang.
• Leerer Inhalt: WeChat drosselt möglicherweise Anfragen. Warten Sie einige Minuten und versuchen Sie es erneut.
• Fehlgeschlagener Bilddownload: Fehlgeschlagene Bilder behalten ihre entfernten URLs im Markdown. Führen Sie den Befehl mit --force erneut aus, um es noch einmal zu versuchen.

Einschränkungen

• Unterstützt nur Artikel von mp.weixin.qq.com
• Erfordert eine funktionierende Internetverbindung und die Fähigkeit, einen Headless-Browser auszuführen
• WeChat kann automatisierten Zugriff blockieren; Camoufox hilft, die Erkennung zu umgehen, ist aber nicht garantiert