Communitygithub.com

0183ty2512/wechat-article-publisher

Claude Code / Codex スキル:Markdown 記事を API 経由で微信(WeChat)公式アカウントに公開するためのコアスクリプトと API 制限の詳細解説

wechat-article-publisher とは?

このスキルは、Markdown 形式で記述された記事を微信(WeChat)公式アカウントの API を使ってアップロード・公開するためのツールです。Python スクリプト (`wechat_publish.py`) が Markdown を WeChat 互換の HTML に変換し、カバー画像のアップロード、下書き保存、即時公開を自動で行います。前提条件として、認証済みサービスアカウント(認証サービス番号)、AppID / AppSecret、IP ホワイトリスト登録が必要です。特に、中国語 2 文字制限のある著者名フィールド、`json.dumps(ensure_ascii=False)` の必須指定、`<style>` タグの使用禁止(インラインスタイルのみ)といった重要な注意点をドキュメント化しており、Claude Code や Codex エージェントと連携して安全かつ効率的に記事公開ワークフローを実行できます。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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. 記事ファイルを書く前に、まずフォルダを作成してください(フォルダ名は中国語で記事タイトルと同じにします)
  2. 1つの記事に属するすべてのファイル — .md、.preview.html、カバー .jpg、.png スクリーンショット、記事固有の .py — はそのフォルダに入れます
  3. 共有・ユーティリティファイルのみ ルートレベルまたは _scripts/、_参考/、images/ に配置します
  4. 一括公開時 は、各記事をフラットなディレクトリではなく、それぞれのフォルダに出力します

前提条件

ユーザーは以下を準備しておく必要があります:

  • AppID + AppSecret: WeChat 公式アカウント管理画面(設定と開発 → 基本設定)から取得
  • IP ホワイトリスト: 現在の公開 IP を同じ画面でホワイトリストに追加しておくこと
    • ユーザーのネットワークが変わるたびに、新しい IP を追加する必要があります
    • 現在の IP を確認するには: curl ifconfig.me または「my ip」を検索
  • カバー画像: 900×500 ピクセル、jpg/png 形式
  • アカウントタイプ: 認証済みサービスアカウント(認証服務号) である必要があります;購読号(訂閱號)は API をサポートしていません

ワークフロー

ステップ 1: 情報収集

アップロード前に、ユーザーから以下を収集します:

  1. AppID & AppSecret — 提供されていない場合は質問します(コンフィグファイルに保存されている場合があります)
  2. 著者名 — 注意:下書き API は中国語著者名を 2 漢字 または 4 混合文字 に制限しています(例:「AI氣象」、「耄耋AI」は OK;「人工智能大氣科學」= 8 漢字 → 失敗)
  3. カバー画像 — 900×500 jpg/png。必要に応じて PIL でリサイズ/変換します
  4. ダイジェスト(省略可能) — 約 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

関連スキル