WeChat 官方アカウント記事公開ツール
Markdown 記事を WeChat 官方アカウントに API 経由で公開します — MD を WeChat 互換の HTML に変換し、下書き保存または公開記事としてアップロードします。
ファイル構成 — 記事ごとにフォルダを作成(必須)
各記事は必ず専用のフォルダに配置してください。 ルートディレクトリにファイルを直接置かないでください。これにより、カバー画像、スクリーンショット、プレビュー HTML、記事固有のスクリプトをひとまとめに管理できます。
公众号/
├── 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/ ← 共有公開スクリプトのみ
│ ├── wechat_publish.py
│ └── batch_publish_*.py
├── images/ ← 共有画像アセット(記事固有ではないもの)
├── api.md ← 共有認証情報
└── cover.jpg ← デフォルトカバー(記事ごとに上書き可能)
ルール:
- 記事ファイルを書く前に、まずフォルダを作成してください(フォルダ名は中国語で記事タイトルと同じにします)
- 1つの記事に属するすべてのファイル —
.md、.preview.html、カバー.jpg、.pngスクリーンショット、記事固有の.py— はそのフォルダに入れます - 共有・ユーティリティファイルのみ ルートレベルまたは
_scripts/、_参考/、images/に配置します - 一括公開時 は、各記事をフラットなディレクトリではなく、それぞれのフォルダに出力します
前提条件
ユーザーは以下を準備しておく必要があります:
- AppID + AppSecret: WeChat 公式アカウント管理画面(設定と開発 → 基本設定)から取得
- IP ホワイトリスト: 現在の公開 IP を同じ画面でホワイトリストに追加しておくこと
- ユーザーのネットワークが変わるたびに、新しい IP を追加する必要があります
- 現在の IP を確認するには:
curl ifconfig.meまたは「my ip」を検索
- カバー画像: 900×500 ピクセル、jpg/png 形式
- アカウントタイプ: 認証済みサービスアカウント(認証服務号) である必要があります;購読号(訂閱號)は API をサポートしていません
ワークフロー
ステップ 1: 情報収集
アップロード前に、ユーザーから以下を収集します:
- AppID & AppSecret — 提供されていない場合は質問します(コンフィグファイルに保存されている場合があります)
- 著者名 — 注意:下書き API は中国語著者名を 2 漢字 または 4 混合文字 に制限しています(例:「AI氣象」、「耄耋AI」は OK;「人工智能大氣科學」= 8 漢字 → 失敗)
- カバー画像 — 900×500 jpg/png。必要に応じて PIL でリサイズ/変換します
- ダイジェスト(省略可能) — 約 40 中国語文字以内に抑えます(API 制限約 120 バイト、各漢字 = 3 バイト)
ステップ 2: Markdown 記事の作成/特定
まず、 作業ディレクトリ(例:公众号/)下に記事用のフォルダを作成します。フォルダ名は記事タイトル(中国語)にします。その後、Markdown ファイルをそのフォルダ内に作成または特定します。
すべての記事固有ファイル(カバー画像、スクリーンショット、プレビュー HTML、ヘルパースクリプト)はこの同じフォルダに入れます。
ステップ 3: 変換とアップロード
公開スクリプトを実行し、フォルダ内の記事を指定します:
python _scripts/wechat_publish.py "文章フォルダ/article.md" --author "署名" --thumb "文章フォルダ/cover.jpg"
オプションフラグ:
| フラグ | 効果 |
|---|---|
--publish | 即時公開(デフォルト:下書きとして保存) |
--digest "xxx" | 手動要約(デフォルト:最初の 40 文字を自動抽出) |
--preview | プレビュー HTML のみ生成、API に接続しない |
--title "xxx" | タイトルを上書き(デフォルト:MD の最初の # 見出し) |
--source-url "url" | 元のソースリンク |
ステップ 4: バックエンドで確認
アップロード成功後 → mp.weixin.qq.com → 草稿箱(下書き箱)→ プレビュー → 手動公開。
重要な注意点(苦い経験から)
これらは references/api-limits.md に詳細に記載されています。最も重要な3つ:
1. json.dumps(ensure_ascii=False) は必須
requests.post(json=...) は内部で json.dumps(ensure_ascii=True) を呼び出し、すべての中国語を \uXXXX としてエンコードします。WeChat はこれらのエスケープシーケンスをリテラルテキストとして保存します。常に使用:
payload = json.dumps(data, ensure_ascii=False).encode("utf-8")
requests.post(url, data=payload, headers={"Content-Type": "application/json; charset=utf-8"})
2. 著者フィールド:最大 2 中国語文字
WeChat の下書き追加 API は著者フィールドに約 8 バイトという厳しい制限があります。各中国語文字は UTF-8 で 3 バイトです。したがって:純中国語名では最大 2 漢字。中国語と ASCII の混合では約 4 文字まで可能です(例:「耄耋AI」)。
3. <style> タグ禁止 — インラインスタイルのみ
WeChat エディタは <style> ブロックを削除し、その CSS コンテンツを表示本文としてレンダリングします。インライン style="" 属性は控えめに使用してください。また、API の場合は総コンテンツを約 20,000 文字以内に抑えてください。
スクリプトの配置場所
公開スクリプト wechat_publish.py は、プロジェクトの共有スクリプトディレクトリ(例:_scripts/wechat_publish.py)に配置してください。
推奨構成:
- 共有公開スクリプト:
<プロジェクト>/_scripts/wechat_publish.py - 各記事を専用フォルダに:
<プロジェクト>/<記事タイトル>/ - 共有認証情報:
<プロジェクト>/api.md
公開スクリプトが処理する内容:
- Markdown → WeChat HTML 変換(Python-Markdown + fenced_code, tables)
- カバー画像のアップロード(thumb material API)
- 正しい JSON エンコードによる下書き作成
- オプションの自動公開
- プレビューモード(API 呼び出しなしのローカル HTML)
最新のスクリプトは以下から入手: https://github.com/0183ty2512/wechat-article-publisher