Communitygithub.com

0183ty2512/wechat-article-publisher

Skill pour Claude Code / Codex : Publier des articles Markdown sur un compte WeChat officiel via l'API, avec scripts principaux et détails des limitations de l'API.

Qu'est-ce que wechat-article-publisher ?

Ce skill permet de convertir et publier des articles au format Markdown vers un compte WeChat officiel (公众号) via son API. Il gère l'ensemble du processus : conversion du Markdown en HTML compatible WeChat, téléversement de l'image de couverture, création de brouillon ou publication directe. Le skill insiste sur une organisation stricte des fichiers (un dossier par article) pour maintenir la clarté et automatiser le traitement par lot. Il détaille également les points de blocage critiques rencontrés lors de l'utilisation de l'API WeChat : l'encodage JSON obligatoire en `ensure_ascii=False`, la limite drastique de 2 caractères chinois pour le champ auteur, et l'interdiction des balises `<style>` (nécessité de styles en ligne). Compatible avec Claude Code et Codex, ce skill fournit un script Python de publication (wechat_publish.py) qui gère la conversion, le téléversement et la mise en brouillon ou publication. Il inclut aussi des options pour la génération locale de preview HTML et le remplacement du titre.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add 0183ty2512/wechat-article-publisher

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

WeChat Official Account Article Publisher

Publier des articles Markdown sur un compte WeChat officiel via l'API — convertir le MD en HTML compatible WeChat et les téléverser comme brouillons ou articles publiés.

Organisation des fichiers — Un dossier par article (OBLIGATOIRE)

Chaque article DOIT vivre dans son propre dossier. Aucun fichier isolé dans le répertoire racine. Cela permet de regrouper les images de couverture, captures d'écran, HTML de preview et scripts spécifiques à l'article.

公众号/
├── AI工具前沿观察/
│   ├── AI工具前沿观察_2026-07-07.md
│   ├── AI工具前沿观察_2026-07-07.preview.html
│   └── ai-tools-frontier-2026-07-07.jpg
├── LaTeX教程/
│   ├── LaTeX教程-从零基础到学术公式自由.md
│   ├── latex_tutorial_screenshot.png
│   └── latex-tutorial-article.py
├── _scripts/          ← scripts de publication partagés uniquement
│   ├── wechat_publish.py
│   └── batch_publish_*.py
├── images/            ← ressources d'images partagées (non spécifiques à un article)
├── api.md             ← informations d'identification partagées
└── cover.jpg          ← couverture par défaut (remplacer par article)

Règles :

  1. Avant d'écrire un fichier article, créez d'abord son dossier (utilisez un nom de dossier en chinois correspondant au titre de l'article)
  2. Tous les fichiers appartenant à un article — .md, .preview.html, couverture .jpg, captures .png, scripts .py spécifiques — vont dans ce dossier
  3. Seuls les fichiers partagés/utilitaires restent à la racine ou dans _scripts/, _参考/, images/
  4. Lors de la publication par lots, chaque article doit être sorti dans son propre dossier, pas dans un répertoire plat

Prérequis

L'utilisateur doit avoir prêt :

  • AppID + AppSecret : Depuis le panneau de configuration du compte WeChat officiel → 设置与开发 → 基本配置
  • Liste blanche IP : L'adresse IP publique actuelle de l'utilisateur doit être ajoutée à la liste blanche sur la même page
    • Chaque fois que le réseau de l'utilisateur change, la nouvelle IP doit être ajoutée
    • Pour vérifier l'IP actuelle : curl ifconfig.me ou chercher "my ip"
  • Image de couverture : 900×500 pixels, format jpg/png
  • Type de compte : Doit être un 认证服务号 (Compte de service vérifié) ; les 订阅号 (abonnements) ne prennent pas en charge l'API

Workflow

Étape 1 : Rassembler les informations

Avant tout téléversement, collectez ces informations auprès de l'utilisateur :

  1. AppID & AppSecret — demandez si non fournis (l'utilisateur peut les avoir dans un fichier de configuration)
  2. Nom de l'auteur — ATTENTION : l'API de brouillon limite l'auteur chinois à 2 hanzi ou 4 caractères mixtes (par ex., "AI气象", "耄耋AI" OK ; "人工智能大气科学" = 8 hanzi → ÉCHEC)
  3. Image de couverture — 900×500 jpg/png. Redimensionner/convertir si nécessaire avec PIL
  4. Digest (résumé) (optionnel) — restez sous environ 40 caractères chinois (limite API environ 120 octets, chaque hanzi = 3 octets)

Étape 2 : Écrire / Localiser l'article Markdown

D'abord, créez un dossier pour l'article dans le répertoire de travail (par ex., 公众号/). Utilisez le titre de l'article (en chinois) comme nom de dossier. Ensuite, écrivez ou localisez le fichier Markdown dans ce dossier.

Tous les fichiers spécifiques à l'article (images de couverture, captures d'écran, HTML de preview, scripts d'assistance) vont dans ce même dossier.

Étape 3 : Convertir et téléverser

Exécutez le script de publication en pointant vers l'article dans son dossier :

python _scripts/wechat_publish.py "文章文件夹/article.md" --author "署名" --thumb "文章文件夹/cover.jpg"

Drapeaux optionnels :

DrapeauEffet
--publishPublier immédiatement (par défaut : enregistrer comme brouillon)
--digest "xxx"Résumé manuel (par défaut : extraire automatiquement les 40 premiers caractères)
--previewGénérer uniquement le HTML de preview, ne pas se connecter à l'API
--title "xxx"Remplacer le titre (par défaut : premier titre # dans le MD)
--source-url "url"Lien source original

Étape 4 : Vérifier dans le panneau d'administration

Après téléversement réussi → mp.weixin.qq.com → 草稿箱 (brouillons) → preview → publier manuellement.

Points critiques (d'après une expérience douloureuse)

Ces points sont documentés en détail dans references/api-limits.md. Les trois plus importants :

1. json.dumps(ensure_ascii=False) EST OBLIGATOIRE

requests.post(json=...) appelle en interne json.dumps(ensure_ascii=True), ce qui encode tout le chinois en \uXXXX. WeChat stocke ces séquences d'échappement comme texte littéral. Utilisez toujours :

payload = json.dumps(data, ensure_ascii=False).encode("utf-8")
requests.post(url, data=payload, headers={"Content-Type": "application/json; charset=utf-8"})

2. Champ auteur : 2 caractères chinois max

L'API draft/add a une limite draconienne : environ 8 octets pour le champ auteur. Chaque caractère chinois = 3 octets en UTF-8. Par conséquent : 2 hanzi max pour les noms purement chinois. Les noms mixtes chinois+ASCII peuvent atteindre environ 4 caractères (par ex., "耄耋AI").

3. Pas de balises <style> — styles en ligne uniquement

L'éditeur WeChat supprime les blocs <style> et affiche leur contenu CSS comme texte visible dans le corps. Utilisez les attributs style="" en ligne avec parcimonie. Gardez également le contenu total sous environ 20 000 caractères pour l'API.

Emplacement du script

Le script de publication wechat_publish.py doit être placé dans le répertoire des scripts partagés de votre projet (par ex., _scripts/wechat_publish.py).

Structure recommandée :

  • Script de publication partagé : <projet>/_scripts/wechat_publish.py
  • Chaque article dans son propre dossier : <projet>/<titre_article>/
  • Informations d'identification partagées : <projet>/api.md

Le script de publication gère :

  • La conversion markdown → HTML WeChat (Python-Markdown + fenced_code, tables)
  • Le téléversement de l'image de couverture (API thumb material)
  • La création de brouillon avec l'encodage JSON correct
  • La publication automatique optionnelle
  • Le mode preview (HTML local sans appels API)

Obtenez le dernier script sur : https://github.com/0183ty2512/wechat-article-publisher

Skills associés