publish-ig-bs
Playwright(永続プロファイル)で Meta Business Suite を自動操作し、Instagram カルーセル(画像 2-10 枚)または **リール(reels/video.mp4)** を予約投稿する。 content/sns/instagram 配下の carousel/ または reels/ を読み取り 1 パックずつ投稿。 予約(--schedule)と即時(--now
SKILL.md.claude/skills/social/publish-ig-bs/SKILL.md
GitHubPlaywright で Business Suite(business.facebook.com)のコンポーザを自動操作し、Instagram カルーセルを予約投稿する。設計は [[publish-x]] に倣う(永続プロファイル・システム Chrome で bot 回避・偽成功を出さない fail-safe・dry-run 必須)。
CI 経路(2026-09-21)
投稿も本スキル(Business Suite Playwright)を CI で回す。 Meta の利用制限で Graph API トークンを発行できないため、
scripts/ig-graph-publish.mjs(公式 API・即時公開のみ)は制限が解けたときの代替として残すが主経路ではない。
CI 実行は ops-write.yml(dispatch + plan hash)で、セッションは encrypted-state(login-collectors.yml と同じ
restore-auth-state)。手順:
npm run ops-write:plan -- --operation instagram.publish-bs --args '{"pack":"<exam>/<pack>","schedule":"YYYY-MM-DDTHH:MM"}'
# → 表示された hash と inputs(パック配下の caption/画像の sha256)を確認してから
gh workflow run ops-write.yml --ref develop -f operation=instagram.publish-bs -f args='{...同じ JSON...}' -f plan_sha256=<hash> -f commit=true
commit=false なら plan だけ。--reel は args に "reel": true。CI は headless なので初回は commit=false で plan を確認し、
Mac の --dry-run でセレクタが生きていることを確かめてから commit=true に進む(Business Suite の UI 変更で
セレクタが外れたら Issue ops-write-instagram が立つ)。予約スロットの実体確認(プランナー月ビュー)はローカル。
既存予約・公開済み投稿を改修するとき
SNS 投稿画像ポリシー §0.1 を先に読む。新規投稿フローを既存投稿の編集代わりに再実行しない。投稿 ID・予約の実体・変更可能項目を確認し、対応する編集処理がない場合はその不足を明示する。保存後の実表示と予約日時・公開状態の再照合までを外部更新の完了条件とする。
⚠️ 重要 1: IG 投稿の唯一の経路(予約 --schedule / 即時 --now)
- 旧 Graph API ルート
scripts/publish-ig.mjsは 2026-06-17 に全廃。IG 投稿は本スキルに一本化された。 - 予約投稿(Graph API 非対応だった)に加え、即時公開も
--nowで本スキルが担う(fail-safe が緩むため検証用・非推奨)。 - ToS リスク: ブラウザ自動操作は Meta 利用規約上グレー〜違反。アカウント制限の可能性は自己責任。
⚠️ 重要 2: セレクタは 2026-06-09 に dry-run で実測確定済み(最終確定クリックのみ未実走)
SEL は実アカウント(Doboku-note / dobokunotecom)の dry-run で全工程を実測確定済み。ただし React UI は変わるため、初回・1週間以上空いた後・失敗時は必ず --dry-run を回し、.local/playwright-ig-bs-debug/dry-run-scheduled-ready.png で「Instagram 単独・日時・確定ボタン『日時を指定』」を目視してから本番投稿する。失敗時は *-missing.png を見て下表と SEL を更新。
予約モード未確認のまま確定すると即時公開が誤爆しうる([[publish-x]] の 2026-04-18 事故と同型)。本スクリプトは「最終ボタンが**『日時を指定』**表示(=予約モード)になるまで確認できなければ中止」する fail-safe を持つ(即時公開ボタンは『公開する』で別物)。
IG 単独化の副作用(実測で判明)
- 投稿先ドロップダウンで Facebook ページ option(
role=option/aria-selected)を外すと Instagram 単独モードに切り替わる。 - Instagram 単独の選択状態を検証できない場合は確定せず停止する。
- IG 単独モードではメディアボタンが 「写真・動画を追加」(FB+IG 時は「写真を追加」)に変わる →
SEL.addMediaは/写真.*追加/で両対応。 - IG 単独だと予約セクションは Instagram 1 行のみ(FB+IG だと 2 行)。
setScheduleは全行に同一日時を入れるため両構成で安全。 - アカウント名が違う環境では env
IG_BS_FB_PAGE/IG_BS_IG_ACCOUNTで上書き。
前提条件
- システム Chrome がインストール済み(Playwright 同梱 Chromium は Meta に bot 判定されやすい)
- 初回ログイン(一度だけ。2FA はブラウザ上で手動):
→npx tsx .claude/skills/social/publish-ig-bs/publish-ig-bs.ts loginbusiness.facebook.com/latestに入るとセッションが<auth root>/profiles/playwright-ig-bs-profile/に保存され自動終了。 - セッション切れ時: 同じ
loginで再ログイン。 - SingletonLock エラー時:
pkill -f "playwright-ig-bs-profile" 2>/dev/null; rm -f <auth root>/profiles/playwright-ig-bs-profile/SingletonLock
使い方
# 1) 利用可能なパックを探す(carousel/img + carousel/caption.txt を持つもの)
ls content/sns/instagram/civil-1/theme-packs/
# 2) dry-run(初回必須。予約確定の手前まで実行しスクショ)
npx tsx .claude/skills/social/publish-ig-bs/publish-ig-bs.ts post \
"civil-1/theme-packs/hoki-labor/pack-01" --schedule 2026-06-10T07:00 --dry-run
# 3) 予約ウィジェットのセレクタを対話採取(Inspector を schedule 手前で起動)
npx tsx .claude/skills/social/publish-ig-bs/publish-ig-bs.ts post \
"civil-1/theme-packs/hoki-labor/pack-01" --schedule 2026-06-10T07:00 --pause
# 4) 本番予約投稿(dry-run 成功後に --dry-run を外す)
npx tsx .claude/skills/social/publish-ig-bs/publish-ig-bs.ts post \
"civil-1/theme-packs/hoki-labor/pack-01" --schedule 2026-06-10T07:00
引数
| パラメータ | 必須 | 説明 |
|---|---|---|
post <pack> |
✓ | パックのパス。content/sns/instagram 相対 or 絶対/プロジェクト相対。carousel/img/*.png + carousel/caption.txt(または直下 img/ + caption.txt)を含むこと |
--schedule <dt> |
※ | 予約日時 JST(YYYY-MM-DDTHH:MM)。Meta 制約: 約20分後〜カルーセル75日先/リール29日先。--now と排他 |
--now |
※ | 予約せず即時公開(fail-safe が緩むため非推奨。検証用) |
--dry-run |
- | 確定の手前で停止しスクショ(初回・セレクタ更新後は必須) |
--pause |
- | schedule 手前で page.pause()(Playwright Inspector でセレクタ採取) |
--keep-fb |
- | Facebook 同時投稿トグルを触らない(既定は IG 単独に寄せる) |
※ --schedule か --now のいずれか一方が必須。
パック構造(読み取り対象)
<pack>/
carousel/
caption.txt # そのまま投稿キャプションになる(IG 上限 2200 文字)
img/
00-cover.png # ソート順 = カルーセル並び順(2-10 枚)
01-problem.png
...
<pack>/img + <pack>/caption.txt(carousel/ なし)でも可。投稿後 <pack>/status.json に carousel.{status,scheduled_at,...} を記録(旧い写し・P7 で消す。公開の状態の正本は台帳で、予約したら recordIg で台帳にも書く)。
実測セレクタ表(2026-06-09 dry-run 検証済み)
| 操作 | セレクタ(SEL 内) |
備考 |
|---|---|---|
| コンポーザ判定 | 「投稿の詳細」テキスト / role=button name=キャンセル |
モード非依存 |
| 投稿先を開く | getByRole("combobox", { name: /^投稿先\s/ })(実測 2026-09-11。旧 UI のみ FB ページ名へフォールバック) |
boundingBox で開を確認 |
| FB を外す | role=option name=Doboku-note の aria-selected を true→クリック→false 検証 |
IG 単独化 |
| メディア追加 | role=button name=/写真.*追加/ → filechooserへ1枚ずつ投入 |
各サムネのCDN読込と既存画像順の維持を確認後に次へ。多枚一括投入は完了順に並び替わるため禁止(2026-09-11実測) |
| キャプション | [contenteditable=true][role=textbox] / textarea → clipboard paste + read-back 検証。10枚カルーセルで欄が遅延描画される現行UIは左ペイン末尾へ自動スクロールして再探索 |
日本語 OK |
| 予約 ON | role=switch name=日時を設定 の aria-checked |
これで日時欄が出現 |
| 日付 | input[placeholder="yyyy/mm/dd"] に YYYY/MM/DD |
全行に同一日時 |
| 時 / 分 | input[aria-label="時間"] / input[aria-label="分"] に HH / MM |
24時間。午後時刻は AM/PM 要確認 |
| 予約確定 | role=button name=日時を指定(即時は 公開する) |
予約 ON で「公開する」→「日時を指定」に変化 |
| 予約モード検証 | 上記「日時を指定」ボタンが visible か | fail-safe の要 |
| 確定後の成功検知 | タイトル /日時が指定されました|時間を節約|.../ or role=button name=後で |
下記の通り 複数パターン |
時刻欄は
role="spinbutton": 値は.valueでなくaria-valuenow(ゼロ埋め無し "8" 等)。keyboard.type("08")で設定しaria-valuenowをparseInt比較で検証+リトライ。.fill()/inputValue()は効かない(2026-06-09 に分が既定値のまま残る事故あり)。確定後の成功モーダルは Meta が出し分ける(実測 2 種): ①「投稿の日時が指定されました」+宣伝アップセル(後で / 宣伝)②「今から投稿を日時指定で時間を節約できます」(後で / 別の投稿を日時指定)。共通の「後で」ボタン+タイトル文言で成功判定し、「後で」で閉じる。
✅ 予約成功ログは信用せず必ずプランナーで実体確認。
セレクタを直したらこの表と SEL を同時に更新。
カルーセルは scripts/lib/instagram-image-upload.mjs で画像を直列に送る。各画像の処理を最大120秒待ち(遅延時も追加送信せず待つ)、完成サムネのURLパスと入力順を記録し、予約編集で開き直した一覧の並びも照合する。表紙だけが先頭にあればよいとせず、途中の説明と最後のCTAまで順序を確認する。既存予約の修正は対象投稿IDを確認して「投稿の編集」を使い、元の本文・予約日時・アカウントを保つ。
リール(--reel)2026-06-09 実機検証済み
--reel で reels/video.mp4 + reels/caption.txt を読み、リールを予約投稿する。カルーセルとは別 UI フロー。
# 予約(初回・更新後は --dry-run 必須)
npx tsx .claude/skills/social/publish-ig-bs/publish-ig-bs.ts post \
"cem/exam-packs/r04/pack-07" --reel --schedule 2026-06-20T09:00 [--dry-run]
- 2 種のリールを扱える(どちらも
<dir>/video.mp4+<dir>/caption.txtフォールバックで読む):- フルリール:
<pack>/reels/video.mp4(4問・長尺)。生成はig-reel-create。 - 1問1リール(推奨):
<pack>/reels-pp/q<N>/video.mp4(36-45秒)。生成はper-problem-shorts.mjs --ig-mode。post の引数に q ディレクトリを渡す。
- フルリール:
- カバー(サムネ)を明示設定: パックに
cover.png(reels-pp)またはreels/img/00-cover.png(旧構造)があれば、編集ステップでファイルアップロードしてサムネを確定する(Meta 自動抽出任せにしない)。per-problem-shorts.mjs --ig-modeはcover.png(論点カバー=先頭スライド)を出力する。カバーを指定したパックは、編集 UI やアップロードを確認できなければ停止する。未指定パックだけ Meta 自動サムネを使う。reels/cover.pngにも対応。 - 動画・音声・カバーは git に持たない(JIT): mp4・wav・cover.png は再生成可能な派生物で gitignore(コミットは slide-data + script.txt + caption.txt。wav は Drive vault 退避=
drive-vault-sync --group sns-archived-media/script.txt から再生成可)。video.mp4・wavが無いのは正常 — 投稿時に生成し、予約後に削除する。scripts/publish-reel-jit.mjs(生成→予約→mp4/cover削除)が1コマンド化。 - 投稿後
status.jsonにreel.{...}を記録(caption.txt / status.json は追跡。status.json は P7 で消す旧い写しで、正本は台帳)。
リールフローの実測(カルーセルとの差分)
| 操作 | セレクタ/挙動 |
|---|---|
| 入口 | ホーム → role=button name="リール動画を作成" → /latest/reels_composer |
| 動画追加 | role=button name="動画を追加" → filechooser。アップ後 ~20-40s 処理待ち(自動生成サムネ出現で判定) |
| 投稿先 IG 単独化 | カルーセルと同じ role=option(FB ページを外す) |
| キャプション | 共通(contenteditable textbox) |
| ステップ送り | 3 ステップ(作成→編集→シェアする)。右下の「次へ」を座標で click(サムネ送りの「次へ」ZWSP を誤爆しない)。カバー等の処理中で無効なら押さず最大180秒待つ |
| カバー設定(2026-06-24 実機確定) | カバーありなら role=button「編集」クリック → 「サムネイル」節へスクロール → 画像をアップロードタブ → パネル内の画像をアップロードで filechooser → cover.png 投入(画像を変更表示で確定)。「次へ」送りでは編集が自動完了して飛ぶため編集タブを直接押す。サムネ=「カバー」ではなく「サムネイル」ラベル。指定カバーの設定失敗時は確定せず停止。スクショは .local/playwright-ig-bs-debug/reel-cover-* |
| 予約 | シェアするで role=button name="日時を指定" → 日付/時刻(共通 spinbutton)→ 確定 role=button name="公開日時を指定" |
| 即時 | role=button name="今すぐシェア"(--now) |
| fail-safe | 「公開日時を指定」ボタンが出るまで確認できなければ中止(即時シェア誤爆防止) |
「予約完了」ログを信用しない(実体検証)
✅ 予約投稿 完了 / ✅ リール予約 完了 ログは成功の証拠にしない。Business Suite の プランナー(コンテンツ → カレンダー/予定) を開き、当該カルーセル/リールが正しい日時・正しいアカウント(Instagram のみ)で予約キューに実在することを目視するまで「完了」と報告しない。
スクリプト本体
.claude/skills/social/publish-ig-bs/publish-ig-bs.ts
混在バッチ
batch <json> は items: [{packArg, schedule, kind}] を順番に処理する。kind は carousel または reel(省略は既存互換で reel)。日時は JST の YYYY-MM-DDTHH:MM。初回は両形式を post ... --dry-run で検証する。途中失敗時は停止し、再投入前に実予約と各 status.json を照合する。