WeChat 公式アカウントへの公開
ワークスペースの vault に長い記事を書き、HITL(人による確認) を経て WeChat 公式アカウントの草稿箱 へ送ります — Agent に一括公開ツールはありません。 ワークフローは ファイル中心 です。Markdown は vault に置き、wechat-article-formatter が同じディレクトリに .wechat.html を生成し、WebUI でプレビューして満足したら、あなたが WeChat 公式アカウントの草稿へ送信 をクリックします。
WeChat(iLink) は 個人 WeChat の QR コードログインです。WeChat 公式アカウント(WeChat Official) は AppID + AppSecret と草稿 API を使います。両者は独立したチャネルなので混同しないでください。
前提条件
- WeChat 公式アカウント(購読号またはサービス号)を開設し、開発者インターフェースを有効にしていること。
- mp.weixin.qq.com → 設定と開発 → 基本設定 で AppID と AppSecret を取得すること。
- 同じ画面の IP ホワイトリストに サーバーの公開 IP を追加すること(
uploadimgとdraft/addに必要)。 - 任意:必要な場合は 設定 → チャネル → WeChat 公式アカウント でチャネルを紐づけ、フォロワーからのメッセージを受け取ります(草稿のpushだけなら認証情報の設定で足ります)。
認証情報の設定
- 設定 → チャネル → WeChat 公式アカウント を開きます。
- AppID と AppSecret を入力します。
- カードに表示される サーバーの公開 IP(送信 IP を自動検出)を WeChat の IP ホワイトリスト(mp.weixin.qq.com → 設定と開発 → 基本設定)へコピーします。
- 接続テスト をクリックします — 失敗した場合はまず IP ホワイトリストを補ってください。
- 保存します。認証情報のキーは
wechatOfficialCredentialsです。
ワークフロー:vault → HTML → 草稿
ステップ 1 — vault に Markdown を書く
Typora や Obsidian などが使えて、ワークスペースに保存します(例articles/my-post.md)。画像は相対パスで書いてください。
ステップ 2 — プリセット Skill で体裁を整える
Agent に伝えてください(または Kanban の WeChat 公式アカウント ブランチを使います)。
「articles/my-post.md を WeChat 公式アカウント向けの HTML に変換して。」
wechat-article-formatter は md_to_wechat_html.py を呼び出し、articles/my-post.wechat.html を生成します。見出し・段落・コードブロック・表・画像にはすべてブロック単位のインラインスタイルが付きます。
ステップ 3 — HTML アーティファクトをプレビューする
会話で HTML アーティファクトを開き、ArtifactCard にインライン描画される版面と画像を確認します。 入力欄にmp.weixin.qq.com/s/... の記事リンクを貼り付けると、Composer が wechat-article-formatter Skill で読み込んで体裁を整えるよう促します。
ステップ 4 — HITL で草稿箱へ送る
- HTML アーティファクトのカードで WeChat 公式アカウントの草稿へ送信 をクリックし、WeChatDraftPanel を開きます。
- タイトル(必須)、著者(必須・最大 8 文字・既定のプレースホルダなし)、要約(任意・空なら自動抽出)を入力します。
- カバー:本文内の最初の
<img>が自動入力されます。ワークスペースの画像候補から選ぶか、ワークスペース相対パスを手動で入力します。 - 本文が コンプライアンススキャン に該当した場合:高リスク(例:いいね誘導)は 422 でブロック され、該当項目を表示します。中リスク(例:医療効果表現)は push を許可しますが警告を表示します。
- 著者が未入力なら確認ボタンは無効です。入力を終えると送信を確認できます。
relative_toでパスを検証します(ワークスペースが未解決なら 503 で fail-closed)。- 本文内の inline 画像を先に WeChat CDN(
uploadimg)へアップロードし、続いてカバーの thumb を処理します。 draft/addを呼び出し、本文はインライン style 付きの HTML 断片です。
ステップ 5 — WeChat バックエンドで一括送信(人による操作)
mp.weixin.qq.com → 草稿箱 を開き、プレビューしてから一括送信または予約公開します。Myrm が自動で一括送信することはありません — これは意図的な HITL 設計です。セキュリティと設計上のトレードオフ
トラブルシューティング
関連ドキュメント
- マルチチャネル連携 — WeChat iLink と WeChat 公式アカウントの違いを含む
- プリセット Skill:
myrm-agent-server/assets/prebuilt_skills/wechat-article-formatter/SKILL.md