addashboard-cli 0.6.2 → 0.7.0

package/dist/schemas/submit-plan.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.submitPlanSchema = exports.metaSubmitPlanSchema = exports.ydaSubmitPlanSchema = exports.planProgressSchema = void 0;
+exports.formatPlanIssues = formatPlanIssues;
+exports.parseSubmitPlan = parseSubmitPlan;
+/**
+ * 入稿計画 JSON (planVersion:1) のスキーマ。
+ *
+ * プランナー (`skills/ad-ops/ad-planner.html` の `buildSubmitPlanWithStats`) が書き出し、
+ * `webgram submit-plan` が読む JSON の**唯一の契約**。型はここから `z.infer` で導出する。
+ *
+ * ⚠ backend の `backend/src/schemas/meta.ts` とは別リポジトリ扱い (cli は独立した npm パッケージで
+ *    backend を import できない)。**backend 側の入稿スキーマを変えたらここも直す**。
+ *
+ * 厳しさの方針:
+ *   - エンベロープ (planVersion / platform / accountId / campaigns) と**階層キー**は strict。
+ *     ここがズレると「Meta なのに adGroups が入っている」類の事故になり、dry-run まで気づけない。
+ *   - キャンペーン / 広告セット / 広告の**中身は passthrough**。backend がフィールドを足したときに
+ *     CLI 側が古いだけで入稿できなくなるのを避ける (検証の主戦場は backend の zod)。
+ *   - ただし「これが無いと入稿が必ず失敗する」キーだけは required にして手前で落とす。
+ */
+const zod_1 = require("zod");
+/** 広告 (媒体共通の最低限)。媒体固有のキーは passthrough で素通しする。 */
+const adSchema = zod_1.z
+    .object({
+    adName: zod_1.z.string().min(1, '広告名が空です'),
+    finalUrl: zod_1.z.string().min(1, '最終リンク先URLが空です'),
+})
+    .passthrough();
+/** YDA: campaigns[].adGroups[].ads[] */
+const ydaAdGroupSchema = zod_1.z
+    .object({
+    name: zod_1.z.string().min(1, '広告グループ名が空です'),
+    ads: zod_1.z.array(adSchema),
+})
+    .passthrough();
+const ydaCampaignSchema = zod_1.z
+    .object({
+    name: zod_1.z.string().min(1, 'キャンペーン名が空です'),
+    adGroups: zod_1.z.array(ydaAdGroupSchema),
+})
+    .passthrough();
+/** Meta: campaigns[].adSets[].ads[] */
+const metaAdSetSchema = zod_1.z
+    .object({
+    name: zod_1.z.string().min(1, '広告セット名が空です'),
+    ads: zod_1.z.array(adSchema),
+})
+    .passthrough();
+const metaCampaignSchema = zod_1.z
+    .object({
+    name: zod_1.z.string().min(1, 'キャンペーン名が空です'),
+    adSets: zod_1.z.array(metaAdSetSchema),
+})
+    .passthrough();
+/** 1 キャンペーンの入稿進捗 (計画ファイルに書き戻して再開可能にする)。 */
+exports.planProgressSchema = zod_1.z.object({
+    index: zod_1.z.number().int(),
+    name: zod_1.z.string(),
+    /**
+     * `unknown` は「リクエストがタイムアウトして成否が判定できない」状態。
+     * **failed にしてはいけない**（再実行で同じキャンペーンをもう一度作る）。
+     */
+    status: zod_1.z.enum(['pending', 'submitted', 'failed', 'unknown']),
+    campaignId: zod_1.z.string().nullable(),
+    error: zod_1.z.string().nullable(),
+    submittedAt: zod_1.z.string().nullable(),
+    targetErrors: zod_1.z.array(zod_1.z.string()).optional(),
+});
+const envelope = {
+    planVersion: zod_1.z.number().int(),
+    accountId: zod_1.z.string().min(1, 'accountId が空です'),
+    progress: zod_1.z.array(exports.planProgressSchema).optional(),
+};
+/**
+ * platform 未記載は yda 扱い (platform 導入前に書き出された計画ファイルとの後方互換)。
+ * 判別に使うのは platform であって階層キーではない — キーの取り違えを検出したいので、
+ * 「adSets が入っている yda プラン」はここで落ちるのが正しい。
+ */
+exports.ydaSubmitPlanSchema = zod_1.z.object({
+    ...envelope,
+    platform: zod_1.z.literal('yda').optional(),
+    campaigns: zod_1.z.array(ydaCampaignSchema).min(1, '計画に campaigns がありません'),
+});
+exports.metaSubmitPlanSchema = zod_1.z.object({
+    ...envelope,
+    platform: zod_1.z.literal('meta'),
+    campaigns: zod_1.z.array(metaCampaignSchema).min(1, '計画に campaigns がありません'),
+});
+exports.submitPlanSchema = zod_1.z.union([exports.metaSubmitPlanSchema, exports.ydaSubmitPlanSchema]);
+/**
+ * zod のエラーを「どのキャンペーン・どの広告が壊れているか」が分かる1行に畳む。
+ * path をそのまま出すと `campaigns.0.adSets.1.ads.3.finalUrl` になり、
+ * 入稿計画を開いて数えないと当該行に辿り着けないため、日本語の位置に直す。
+ */
+function formatPlanIssues(error) {
+    return error.issues.slice(0, 20).map((i) => {
+        const where = i.path
+            .reduce((acc, seg, idx, arr) => {
+            if (typeof seg === 'number')
+                return acc;
+            const next = arr[idx + 1];
+            const label = seg === 'campaigns'
+                ? 'キャンペーン'
+                : seg === 'adGroups'
+                    ? '広告グループ'
+                    : seg === 'adSets'
+                        ? '広告セット'
+                        : seg === 'ads'
+                            ? '広告'
+                            : String(seg);
+            acc.push(typeof next === 'number' ? `${label}[${next + 1}]` : label);
+            return acc;
+        }, [])
+            .join(' > ');
+        return where ? `${where}: ${i.message}` : i.message;
+    });
+}
+/**
+ * 計画ファイルを検証する。失敗時は人が読める複数行のエラーを返す。
+ * union のエラーはそのままだと「どちらの媒体としても不正」が2重に出て読めないので、
+ * platform を先に見て単一スキーマで検証する。
+ */
+function parseSubmitPlan(raw) {
+    const platform = raw?.platform ?? 'yda';
+    if (platform !== 'yda' && platform !== 'meta') {
+        return { ok: false, errors: [`submit-plan は yda / meta のみ対応です (指定: ${String(platform)})`] };
+    }
+    const schema = platform === 'meta' ? exports.metaSubmitPlanSchema : exports.ydaSubmitPlanSchema;
+    const r = schema.safeParse(raw);
+    return r.success ? { ok: true, plan: r.data } : { ok: false, errors: formatPlanIssues(r.error) };
+}
+//# sourceMappingURL=submit-plan.js.map

package/dist/schemas/submit-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit-plan.js","sourceRoot":"","sources":["../../src/schemas/submit-plan.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "addashboard-cli",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "description": "webgram CLI — ad-dashboard (https://macchiato.site) を Claude Code / Codex CLI から操作するための CLI",
   "bin": {
     "webgram": "./dist/index.js"
@@ -35,6 +35,7 @@
   },
   "scripts": {
     "build": "tsc",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.test.json",
     "dev": "tsx src/index.ts",
     "start": "node dist/index.js",
     "test": "vitest run",
@@ -46,7 +47,8 @@
   },
   "dependencies": {
     "axios": "^1.7.7",
-    "commander": "^12.1.0"
+    "commander": "^12.1.0",
+    "zod": "4.4.3"
   },
   "devDependencies": {
     "@playwright/test": "1.61.1",

package/skills/ad-ops/README.md

@@ -24,6 +24,7 @@ ad-dashboard (`https://macchiato.site`) の webgram CLI を Claude Code / Codex
 
 - アカウント参照データ: `アカウント/<platform>/<名前>.json`（`アカウント/yda/` / `アカウント/meta/`）
 - Meta は入稿前に **accountId(`act_` 付き) / FBページID / pixelId / CVイベント** が必須（未入力は書き出しブロック）
+  - この ID は `list --platform meta --resource pixels --account-id act_<ID>` / `--resource pages` / `--resource instagram-accounts` で取得する（`pages` は `--account-id` 不要 / `instagram-accounts` は任意だが原則指定する）
 - **Meta の本番入稿 PoC は未実施** — 初回は配信オフ (`PAUSED`)・1 キャンペーン・最小予算から
 
 ## 利用者の初回セットアップ

package/skills/ad-ops/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ad-ops
-description: ad-dashboard (https://macchiato.site) の webgram CLI 経由で広告を YDA / Meta に半自動入稿する (TikTok は将来対応予定)。用途は 2 系統 — 動画の API 入稿フロー (5 ステップ + 固定デフォルト + URL 空き番号自動割当 + 一覧 OK 確認、現状 YDA) と、入稿プランナー `ad-planner.html` (YDA / Meta を案件×媒体の統合プルダウンで切替する GUI → 入稿計画JSON → `submit-plan` で dry-run → 本実行)。「広告運用」「広告入稿」「動画入稿」「まとめ入稿」「ASC 入稿」「YDA 入稿」「Meta 入稿」「入稿プランナー」「YDA入稿プランナー」「Meta入稿プランナー」「入稿シート」「TikTok 入稿」「webgram」「ad-dashboard」と言われたら使用。Node.js が入っていれば追加インストール不要 (`npx` 経由)。
+description: ad-dashboard (https://macchiato.site) の webgram CLI 経由で広告を YDA / Meta に半自動入稿する (TikTok は将来対応予定)。発火したら「入稿先アカウント&媒体」→「今回の方式 (HTMLプランナーで手動指定=既定 / 前回の入稿計画を参考にする / チャットで1つずつ聞く)」の順に確定させる。入稿の実体は 2 系統 — 動画・ローカル画像の API 入稿フロー (固定デフォルト + URL 空き番号自動割当 + 一覧 OK 確認、現状 YDA) と、入稿プランナー `ad-planner.html` (YDA / Meta を案件×媒体の統合プルダウンで切替する GUI → 入稿計画JSON → `submit-plan` で dry-run → 本実行)。「広告運用」「広告入稿」「動画入稿」「まとめ入稿」「ASC 入稿」「YDA 入稿」「Meta 入稿」「入稿プランナー」「YDA入稿プランナー」「Meta入稿プランナー」「入稿シート」「TikTok 入稿」「webgram」「ad-dashboard」と言われたら使用。Node.js が入っていれば追加インストール不要 (`npx` 経由)。
 ---
 
 # ad-ops skill (広告運用スキル)
@@ -55,19 +55,39 @@ skills/ad-ops/scripts/adops.sh preflight yda <accountId>
 > 全件パスしたが、`list accounts` が返す 17 件に含まれておらず本実行で 401。
 > フェーズ1〜3 の作業がすべて無駄になった。
 
-## 【必須】入口メニュー: 用途の分岐
+## 【必須】入口: アカウント&媒体 → 今回の方式
 
-**本スキルが発火したら、フェーズ0 の `preflight` を通したうえで、最初に `AskUserQuestion` で用途を確認する。**（文脈から暗黙に判断しない。特に「ローカル画像で入稿」は暗黙判断では絶対に選ばれない）
+**本スキルは広告入稿の専用スキル**。発火したら `preflight` → **入稿先アカウント&媒体** → **今回の方式** の順で確定させ、対応するフローへ入る。用途を4択で聞く旧メニューは廃止した（実運用がほぼ入稿なので毎回の無駄だった）。
+
+### 入口ステップ1: 入稿先アカウント & 媒体の決定
+
+* **`preflight` は全分岐の共通の前提**。落ちたら分岐せずその場で止めて報告する
+* `AskUserQuestion` で **案件 × 媒体**を選ばせる。選択肢は `アカウント/<platform>/index.json`（プランナーのヘッダー統合プルダウン `#accSelect` と同じ母集団）から作り、`webgram list accounts` の結果と突き合わせる
+* **【必須】`list accounts` に無い ID は本実行で 401 になり、dry-run は通ってしまう**（冒頭の失敗例を参照）。**ここで弾いて先に進ませない**
+* ユーザーの依頼にアカウント名・媒体が明示されていれば、確認を省いて既定として提示してよい
+* ここで決まった `platform` / アカウント名は**以降の全分岐で使い回す。下流で再度聞かない**（旧 Step 3 の「入稿先アカウント名」はこのステップに前倒しした）
+
+### 入口ステップ2: 今回の方式（3択）
+
+* **提示条件**: ユーザーの発話に入稿パラメータ（予算・CTA・tCPA・配信開始日時・キャンペーン名など）も方式の明示も無いときだけ `AskUserQuestion` を出す。明示があればスキップして該当フローへ直行する
 
 | 選択肢 | 遷移先 |
 |---|---|
-| 動画を API 入稿する | 下の「動画入稿フロー」Step 0〜6 |
-| **ローカル画像で入稿する** | 下の「画像入稿フロー（ローカル画像・YDA）」Step 0〜6 |
-| 入稿プランナーで量産する | 「起点フロー（4フェーズ）」 |
-| チーム週次レビューを見る | 「チーム週次レビュー取得（review コマンド）」 |
+| **HTMLプランナーで手動指定（既定）** | ステップ1の結果を渡して `adops.sh planner --platform <pf> --account "<名前>"` を起動 → 「入稿プランナー」起点フロー（4フェーズ）。以降のパラメータは GUI で決めるので個別に聞かない |
+| 前回の入稿計画を参考にする | 下の「直近プラン採用ロジック」→ 引き継ぎ値を提示して差分だけ確認 → 動画/画像入稿フロー Step 4（一覧提示＋OK 確認）へ |
+| チャットで1つずつ聞く | 動画入稿フロー Step 1〜6 / 画像入稿フロー Step 1〜6 |
+
+* 「チャットで1つずつ聞く」の**動画/画像の振り分けは素材パスの拡張子で判定する**（`.mp4` 等 → 動画 / `.jpg` `.jpeg` `.png` `.gif` → 画像）。素材が未提示なら `AskUserQuestion` でパス提示を促す（Step 1 の手順をそのまま使う）
 
-* **`preflight` は分岐前の共通の前提**。落ちたら分岐せずその場で止めて報告する
-* ユーザーの依頼に媒体・素材が明示されていれば選択肢の既定として提示してよいが、**確認そのものは省略しない**
+### 直近プラン採用ロジック（「前回の入稿計画を参考にする」を選んだとき）
+
+1. `入稿計画/` 配下を、**ステップ1で決めた案件×媒体アカウント**で絞り込む。判定は JSON 内の `platform` と `campaigns[].accountId`（Meta は `act_` 付き）を正とし、ファイル名は候補の絞り込み補助にとどめる
+2. タイムスタンプ降順で **最新1件を自動採用**し、**採用したファイルパスをユーザーに提示する**
+3. 該当が 0 件なら、その旨を伝えて「チャットで1つずつ聞く」にフォールバックする
+4. **引き継ぐのは入稿パラメータだけ**（予算 / CTA / アトリビューション / tCPA・入札戦略 / ターゲティング / 配信日時）。**クリエイティブ（mediaId・画像/動画パス）・キャンペーン名・URL 末尾番号は引き継がない** — 毎回新規なので、URL 空き番号の自動割当と CP 名の自動生成（Step 3 のルール）で採り直す
+5. 引き継いだ値を一覧で提示し、**変更点を 1 問で聞く**。以降は Step 4（一覧提示 → OK 確認・必須）へ合流する
+
+* **【必須】これはパラメータの初期値として読むだけ。** 過去の入稿計画JSONの存在を**入稿済み・フェーズ完了の根拠にしてはならない**（後述の同名ガードを参照）
 
 ## 動画入稿フロー (メイン用途)
 
@@ -114,14 +134,32 @@ npx -y addashboard-cli@latest auth whoami
 
 * **スマートターゲティング: 常時 ON** (backend 側の既定も `true`。明示的に OFF にしたい場合だけユーザーに確認する)
 
+* **配信開始日時: 翌日 05:00** (プランナーで空欄のときの既定。**YDA は Yahoo Ads API の `startDate` が日付のみなので実際に効くのは「翌日」まで**で、05:00 は載らない)
+
 **必ずユーザー確認 or 自動生成が必要な項目**:
 
-* **入稿先アカウント名**: アカウント名で指定可 (アカウント ID は不要、CLI 側で名前 → ID 解決)。指定なければ AskUserQuestion で聞く
+* **入稿先アカウント名**: **入口ステップ1 で確定済み**。ここで再度聞かない (アカウント名で指定可。アカウント ID は不要、CLI 側で名前 → ID 解決)
 
 * **入稿リンク (URL 末尾番号)**: 既存アカウントの入稿履歴から使用済み番号を取得し、**未使用の空き番号を自動割当**
 
   * 連番でなくて OK。被らないことだけ守る (例: 1〜50 が使用中なら 51 以降、または途中の 7 が未使用なら 7)
 
+  * **【必須】「使用済み」は媒体側で配信中 (ACTIVE) のものだけ。配信停止 (PAUSED / 配信オフ) のキャンペーン・広告が使っている番号は「未使用」として扱い、再利用の候補に入れる**
+
+    * 判定材料は `webgram list --platform <媒体> --resource campaigns` が返す `status` (アカウントJSONの `refs.campaigns[].status` にも入る)
+    * **status が取れなかった媒体・アカウントでは従来どおり全件を使用済みとして扱い、「オフ判定ができなかった」ことをユーザーに明示する。** 勝手に空き扱いにしない
+    * **番号の持ち主 (キャンペーン名 / 広告名) と配信状態をセットで確認してから再利用する。** オフでも再開予定のものがあり得る
+
+  * **【必須】番号を決める前に AskUserQuestion で採番方針を選ばせる**（既定は「オフの中での MAX」）
+
+    | 選択肢 | 挙動 |
+    | --- | --- |
+    | オフの中での MAX (既定) | 配信停止番号のうち最大のものを再利用する |
+    | オフの中での MIN | 配信停止番号のうち最小のものを再利用する |
+    | オフを含めた未使用番号全体の MIN | 欠番 + 配信停止番号をすべて未使用とみなし、その最小を使う |
+
+    * 選択後、判定に使った **使用済み (ACTIVE) 番号一覧 / オフ番号一覧 / 割り当てた番号** を Step 4 の確認表の直前に提示する
+
   * ベース URL は案件ごとに固定 (Bit.ly 系ドメイン等)。末尾パラメータ番号のみ可変
 
   * 案件ごとの URL 一覧はシート管理されているので、そこから引く運用も可
@@ -139,6 +177,9 @@ npx -y addashboard-cli@latest auth whoami
 | 1 | YDA | video\_A.mp4 | 07\_video\_A\_2026-07-16 | <https://.../?p=07> | 12,000 | tCPA 8,500 |
 | 2 | YDA | video\_B.mp4 | 08\_video\_B\_2026-07-16 | <https://.../?p=08> | 12,000 | tCPA 8,500 |
 
+**表の直前に、URL 末尾番号の根拠を出す**: 採番方針 / 使用済み (ACTIVE) 番号 / オフ (PAUSED) 番号 / 割り当てた番号。
+オフ判定ができなかった場合はその旨も書く。
+
 URL 番号・予算・配信戦略に不満があれば Step 3 に戻ってパラメータを差し替える。
 
 ### Step 5: 順次実行
@@ -278,7 +319,8 @@ skills/ad-ops/scripts/adops.sh open yda <accountId> campaigns
 | 汎用入稿 (JSON) 実入稿     | `npx -y addashboard-cli@latest submit --platform <媒体> --json-file <path> --no-dry-run --yes`                  |
 | 入稿計画 順次入稿 dry-run | `npx -y addashboard-cli@latest submit-plan --plan-file <入稿計画.json>`（yda / meta。`plan.platform` 未記載は yda 扱い） |
 | 入稿計画 順次入稿 実入稿   | `npx -y addashboard-cli@latest submit-plan --plan-file <入稿計画.json> --no-dry-run --yes`（1CPずつ・再開可能） |
-| チーム週次レビュー取得       | `npx -y addashboard-cli@latest review --team <伊藤T\|松井T> [--week <YYYY-MM-DD>]`                              |
+
+**【重要】本実行がタイムアウトしたら「失敗」と決めつけない。** CLI の進捗は `unknown`（成否不明）になる。backend は入稿を続けており、**キャンペーンと広告が作成済みのことがある**（実測あり）。この状態で再実行すると二重入稿になるため `unknown` は自動でスキップされる。媒体の管理画面を確認し、作成済みなら計画ファイルの `status` を `"submitted"`、未作成なら `"pending"` に直してから再実行する（exit code は 3）。
 | 「予実」「予実管理」「今月の予実」「着地予測」「予実サマリ」 | `npx -y addashboard-cli@latest pl summary`（月指定は `pl summary --month YYYY-MM`） |
 | 「案件別の予実」「案件ごとの損益」 | `npx -y addashboard-cli@latest pl projects`（`--month` / `--status` / `--platform` で絞り込み可） |
 
@@ -288,47 +330,6 @@ skills/ad-ops/scripts/adops.sh open yda <accountId> campaigns
 
 ***
 
-## チーム週次レビュー取得（review コマンド）
-
-チーム × 週で **全案件の週次レビュー（課題・今週のアクションプラン）を 1 回でまとめて取得** し、LLM（このセッション）が案件ごとに要約するためのコマンド。CLI の役割は JSON 取得までで、要約は LLM が行う。
-
-### 自然言語 → コマンド マッピング
-
-以下のような依頼で発火する:
-
-- 「伊藤T（松井T）の先週の課題とアクションプラン（を案件ごとに要約して）」
-- 「チームの週次レビュー（を見せて／まとめて）」
-- 「先週の課題まとめ」「先週のアクションプランまとめ」
-
-→ 実行するコマンド（**先週がデフォルト**）:
-
-```bash
-npx -y addashboard-cli@latest review --team 伊藤T
-```
-
-特定週を指定する場合は、その週の月曜（JST）を `--week` で渡す:
-
-```bash
-npx -y addashboard-cli@latest review --team 松井T --week 2026-07-13
-```
-
-- `--team` は `伊藤T` または `松井T` のいずれか（必須）
-- `--week` 省略時は **先週の月曜（JST）** を自動採用（例: 実行日が 2026-07-23(水) なら 2026-07-13）
-- 出力は JSON（`team` / `weekStart` / `teamProjectCount` / `reviewCount` / `reviews[]`）
-
-### 結果の要約（LLM 側の必須整形）
-
-`review` の JSON は **そのまま貼らない**。案件ごとに次の形で要約する:
-
-- **案件名（clientName / platform があれば併記）**
-  - 課題: `issue` を要約
-  - 今週のアクションプラン: `thisWeekPlan` を要約
-  - 数値実績（`actualCpa` / `actualCtr` / `actualCvr` 等）があれば補足。目標（`goalCpa` 等）と併記できると良い
-
-冒頭または末尾で **`reviewCount`（レビュー記入のあった案件数）/ `teamProjectCount`（チームの総案件数）** に触れ、「N 件中 M 件にレビュー記入あり」といった全体像を示す。`reviews` が空（`reviewCount: 0`）の場合は「該当週の週次レビュー記入はありませんでした」と伝える。
-
-***
-
 ## 入稿プランナー（YDA / Meta 媒体切替・JSON入稿）
 
 動画の API 入稿とは別に、**一括入稿を計画・確認する**ためのシングルHTMLツール。2026-07-16 / 07-21 定例フィードバックを反映。**2026-07-23 に CSV 書き出しを廃止し、保存・入稿受け渡しを JSON に統一**。**2026-07-30 に媒体スキーマ駆動化（`PLATFORMS` レジストリ）して Meta に対応**。
@@ -350,10 +351,10 @@ npx -y addashboard-cli@latest review --team 松井T --week 2026-07-13
 | クリエイティブ形式         | 画像のみ（Card 1200 / SQ 1080 の mediaID）                | **画像（imageHash）／動画（videoId + サムネ imageHash）両対応**（広告行の形式列 IMAGE / VIDEO）    |
 | 参照データ (`refs.media`) | `{card, sq}`                                       | `{image, video, thumb}`                                                  |
 | プロジェクト必須項目        | accountId / 目的(goal) / 配信開始日 / 入札                    | accountId(`act_`) / **FBページID** / **pixelId**(`OFFSITE_CONVERSIONS`/`VALUE` 時) / CVイベント / 最適化 / 課金 / 入札戦略 / 配信開始日（配信終了日は任意） |
-| 配信期間の指定階層         | 案件設定チップのみ（配信開始日）                          | **広告セット行の列 → 案件設定チップ → 既定（当日）** の順で解決。**時刻も指定可**（`YYYY-MM-DD [HH:mm[:ss]]`・JST） |
+| 配信期間の指定階層         | 案件設定チップのみ（配信開始日）                          | **広告セット行の列 → 案件設定チップ → 既定（翌日 05:00）** の順で解決。**時刻も指定可**（`YYYY-MM-DD [HH:mm[:ss]]`・JST） |
 | 入札                | 最大配信 / tCPA（`MAXIMIZE_CONVERSIONS`+targetCpa）       | `LOWEST_COST_WITHOUT_CAP` / `LOWEST_COST_WITH_BID_CAP` / `COST_CAP` / `LOWEST_COST_WITH_MIN_ROAS`（後2者は `bidAmount` 必須） |
 | ターゲティング列          | 年齢 / 性別 / デバイス / 曜日時間帯 / **オーディエンス（含む・除外）** / **配置（含む・除外）** / 地域・サーチKW。**オーディエンス・配置は参照表の実IDで入稿JSONに載り、本番の配信ターゲティングに反映される**（数値IDでない値は落として警告）。**入稿JSONに載らないのは 地域 と サーチKW だけ** | 年齢(ageMin/ageMax) / 性別 / デバイス / 配置（Facebook / Instagram / Audience Network / Messenger、既定は自動配置） |
-| 命名規則              | `{番号}{c\|s}-{見出し}L{本文}-{paramCode}` / `?ad=&creative=` | **同形式を踏襲**（形式記号は `i`(画像) / `v`(動画)）                                       |
+| 命名規則              | `{番号}{c\|s}-{見出し}L{本文}-{paramCode}` / `?ad=&creative=` | **同形式を踏襲**（形式記号は `i`(画像) / `v`(動画)）。**最終URLは `{記事URL}?ad={paramCode}` のみ**（`creative=` もパス連結もしない）。paramCode は**広告行 > 広告セット**の実効値 |
 | 手入稿の除外            | バナー(固定サイズ)は API 未対応 → `手入稿` フラグで入稿JSONから除外          | 手入稿フラグの区分は無し（未解決の広告のみ除外）                                                 |
 | 管理画面              | `https://ads.yahoo.co.jp/manager/#/{mccId}/{accountId}/list/campaigns`（**CP詳細への直リンクは不可**） | `adsmanager.facebook.com/adsmanager/manage/campaigns?act=<数値>`            |
 
@@ -488,14 +489,27 @@ npx -y addashboard-cli@latest list --platform yda --resource ads \
 
 #### Meta の初回セットアップ（`アカウント/meta/<名前>.json`）
 
-1. アカウントを特定: `webgram list --platform meta --resource accounts` → 対象の **accountId（`act_` 付き）** を確定。あわせて **FBページID / IGユーザーID（任意）/ pixelId** を確認する（この3つは CLI では取れないので Meta Business 管理画面から拾う）。
-2. クリエイティブ参照を取り込む:
+1. アカウントを特定: `webgram list --platform meta --resource accounts` → 対象の **accountId（`act_` 付き）** を確定。
+2. **入稿アセットID（FBページID / pixelId / IGユーザーID）を取得する**:
+   ```bash
+   npx -y addashboard-cli@latest list --platform meta --resource pixels --account-id act_<ID>  # pixelId（アカウント配下）
+   npx -y addashboard-cli@latest list --platform meta --resource pages                          # FBページID
+   npx -y addashboard-cli@latest list --platform meta --resource instagram-accounts --account-id act_<ID>  # IGユーザーID
+   ```
+   * **`pages` は `--account-id` を取らない**。`act_<ID>/promote_pages` は 200 を返すが常に 0 件で、ページはビジネスマネージャ配下でしか引けないため、トークンから見える全ページを返す。
+   * **【最重要】一覧に出る ≠ そのページで入稿できる。** 各行の **`canAdvertise`**（`tasks` に `ADVERTISE` を含むか）を見て、**`true` のページだけを使う**。`false` のページを指定すると入稿の広告作成で `code 10 / subcode 3858749`「ページに投稿するには広告主の役割以上のアクセス許可が必要」で落ちる（キャンペーンと広告セットだけ作られて残る）。
+     実測（2026-08-16）では 62 件中 `canAdvertise: true` は **`source` に `me` を含む 9 件だけ**で、`owned` / `client` 由来の 53 件はすべて false だった。使いたいページが false のときは、Meta Business でそのページへ広告主以上の役割を付与してもらう必要がある。
+   * **`instagram-accounts` の `--account-id` は任意**。指定すると広告アカウント配下（`act_<ID>/instagram_accounts`）も併せて引く。**アカウントによって「act_ 配下にだけ出る / business 配下にだけ出る」が分かれる**ので、原則は指定する。
+   * **ページ紐付け型の IG は現状どの経路でも引けない**（トークンに `pages_read_engagement` が無いため）。既存広告が使っている IG が一覧に出ない場合はこれ。既存キャンペーンを `campaign-import` して実際の `instagramUserId` を写すか、管理画面から拾う。
+   * `pages` の各行の `source` は取得経路（`me` = トークン所有ユーザーが管理 / `owned` = BM所有 / `client` = BMのクライアント）。どれを使うかは案件で決める。
+   * 一覧が多い場合は名前で絞り込んで対象を特定する。判断がつかない場合のみ Meta Business 管理画面で照合する。
+3. クリエイティブ参照を取り込む:
    ```bash
    npx -y addashboard-cli@latest list --platform meta --resource image-library --account-id act_<ID>   # imageHash
    npx -y addashboard-cli@latest list --platform meta --resource video-library --account-id act_<ID>   # videoId
    npx -y addashboard-cli@latest list --platform meta --resource campaigns --account-id act_<ID>       # 既存CP/広告セット
    ```
-3. 取得結果を下記スキーマに整形して `アカウント/meta/<アカウント名>.json` へ保存する（雛形は同梱の `アカウント/meta/sample_account.json`）:
+4. 取得結果を下記スキーマに整形して `アカウント/meta/<アカウント名>.json` へ保存する（雛形は同梱の `アカウント/meta/sample_account.json`）:
    ```json
    {
      "accountJsonVersion": 1,
@@ -515,7 +529,7 @@ npx -y addashboard-cli@latest list --platform yda --resource ads \
      }
    }
    ```
-4. プランナーの「＋新規追加 → 📄 ファイルから追加」または「📁 フォルダ」再接続で一覧に出る。
+5. プランナーの「＋新規追加 → 📄 ファイルから追加」または「📁 フォルダ」再接続で一覧に出る。
 
 **プランナー内の「❓使い方」ボタンから、この取込プロンプト（媒体別の文言）をコピーできる**ので、AI に貼るだけでも進められる。
 
@@ -528,7 +542,7 @@ npx -y addashboard-cli@latest list --platform yda --resource ads \
 | **pixelId**                 | `optimizationGoal` が **`OFFSITE_CONVERSIONS` / `VALUE`** の場合は公式必須（`promoted_object`）。未入力は書き出しブロック（backend 側も 400 を返す） |
 | **customEventType（CVイベント）** | `promoted_object` の CV イベント（既定 `PURCHASE`）                   |
 | `bidAmount`                 | 入札戦略が `COST_CAP` / `LOWEST_COST_WITH_BID_CAP` のときのみ必須        |
-| `instagramUserId`           | 任意（Instagram 配置を使う場合に指定）                                    |
+| `instagramUserId`           | 任意（Instagram 配置を使う場合に指定）。`list --resource instagram-accounts --account-id act_<ID>` で取得できる（ページ紐付け型は引けないので既存CPのインポート値を使う） |
 
 ### 入稿手順（YDA）：未知の画像・キャンペーン/広告グループは先に登録
 
@@ -544,7 +558,7 @@ npx -y addashboard-cli@latest list --platform yda --resource ads \
 
 ### 入稿手順（Meta）
 
-1. **プランナーで計画**: ヘッダーの統合プルダウンで **`<案件名> Meta`** を選ぶ（`アカウント/meta/<名前>.json` 未整備なら先に上記セットアップ）。キャンペーン > 広告セット > 広告を作り、共通設定チップで FBページID / pixelId / CVイベント / 最適化 / 課金 / 入札戦略 / 配信開始日 / 配信終了日（任意・空欄なら無期限）を確定する。**配信日時は広告セット行の列でも個別に上書きできる**（優先順位: 広告セット行 > 案件設定チップ > 既定=当日）。書式は `YYYY-MM-DD` または `YYYY-MM-DD HH:mm[:ss]`（**JST**）で、時刻を省くと開始は `00:00:00` / 終了は `23:59:59` になる。
+1. **プランナーで計画**: ヘッダーの統合プルダウンで **`<案件名> Meta`** を選ぶ（`アカウント/meta/<名前>.json` 未整備なら先に上記セットアップ）。キャンペーン > 広告セット > 広告を作り、共通設定チップで FBページID / pixelId / CVイベント / 最適化 / 課金 / 入札戦略 / 配信開始日 / 配信終了日（任意・空欄なら無期限）を確定する。**配信日時は広告セット行の列でも個別に上書きできる**（優先順位: 広告セット行 > 案件設定チップ > 既定=翌日05:00）。書式は `YYYY-MM-DD` または `YYYY-MM-DD HH:mm[:ss]`（**JST**）で、時刻を省くと開始は `00:00:00` / 終了は `23:59:59` になる。
    - **既知の制約**: 解決は「行が空ならチップを継承」なので、**チップに終了日が入っているとき、特定の広告セットだけを無期限にすることはできない**。混在させたい場合はチップの終了日を空にし、期限を付けたい広告セット行だけに終了日時を入れる。
 2. **入稿JSON書き出し**: ワンクリックで `<案件名>_Meta入稿計画_<日時>.json`（`planVersion:1`、`platform:"meta"`）を出力。`act_` 形式違反・FBページID 未入力・（`OFFSITE_CONVERSIONS`/`VALUE` 時の）pixelId 未入力・0件 は**書き出しをブロック**する。
 3. **dry-run で一括検証**:
@@ -569,7 +583,7 @@ npx -y addashboard-cli@latest list --platform yda --resource ads \
 - **入稿JSON書き出し**: 設定ダイアログなしの**ワンクリック**。参照未解決の広告は自動除外、accountId 未入力・0件なら書き出し中止（空入稿防止）。媒体別の中身:
   - **YDA（見出し・本文の空欄許容）**: **タイトル番号 / 説明文番号は空欄でよい**（見出し・本文を使わない広告のケース）。空欄の広告はエラーにならず、`headlines` / `descriptions` は**空配列**で書き出され、backend も空を受理する。**空を許容するのはこの2フィールドのみ**（画像番号 `imageNo`・`paramCode`・principal・finalUrl は従来どおり必須）。**番号を入れたのに参照表（refs.titles / refs.descriptions）に無い場合は従来どおり「未解決」エラー**で、その広告は書き出しから除外される（別の障害なので緩めない）。Meta は従来どおり見出し・本文とも必須。
   - **YDA**: アカウントID・目的(goal)・配信開始日は案件設定チップ、入札はキャンペーン行（tCPA→`MAXIMIZE_CONVERSIONS`+targetCpa）、ターゲティングは広告グループ行の列（日本語ラベル→API enum 自動変換）から `*_入稿計画_*.json`（planVersion:1、広告は IMAGE 形式: mediaIds/headlines/descriptions/principal）を生成。手入稿バナーも自動除外。
-  - **Meta**: 予算は広告セット行（CBO は使わない）、目的は `objective`、最適化/課金/入札戦略/pixel/CVイベント/FBページID は案件設定チップ、ターゲティング（年齢・性別・デバイス・配置）は広告セット行の列から `*_Meta入稿計画_*.json`（planVersion:1、`platform:"meta"`、`campaigns[].adSets[]`、広告は IMAGE / VIDEO）を生成。`act_` 形式違反・FBページID 未入力・pixelId 必須ケースの未入力でブロック。 **配信日時（`startTime` / `endTime`）は広告セットごとに解決される（広告セット行 > 案件設定チップ > 既定=当日）。入力は `YYYY-MM-DD [HH:mm[:ss]]`・JST 前提で、書き出し時に `+0900` 付き ISO8601 に正規化される（時刻を明示した場合は 23:59:59 に丸めずその時刻を尊重）。`startTime` は常に送り、配信終了日が空欄なら `endTime` キー自体を送らない（無期限配信）。`lifetimeBudget` 指定時に限り backend が配信開始日+30日を補完する。**
+  - **Meta**: 予算は広告セット行（CBO は使わない）、目的は `objective`、最適化/課金/入札戦略/pixel/CVイベント/FBページID は案件設定チップ、ターゲティング（年齢・性別・デバイス・配置）は広告セット行の列から `*_Meta入稿計画_*.json`（planVersion:1、`platform:"meta"`、`campaigns[].adSets[]`、広告は IMAGE / VIDEO）を生成。`act_` 形式違反・FBページID 未入力・pixelId 必須ケースの未入力でブロック。 **配信日時（`startTime` / `endTime`）は広告セットごとに解決される（広告セット行 > 案件設定チップ > 既定=翌日05:00）。入力は `YYYY-MM-DD [HH:mm[:ss]]`・JST 前提で、書き出し時に `+0900` 付き ISO8601 に正規化される（時刻を明示した場合は 23:59:59 に丸めずその時刻を尊重）。`startTime` は常に送り、配信終了日が空欄なら `endTime` キー自体を送らない（無期限配信）。`lifetimeBudget` 指定時に限り backend が配信開始日+30日を補完する。**
 
 ### 量産構造（媒体要件の核）
 
@@ -587,7 +601,7 @@ npx -y addashboard-cli@latest list --platform yda --resource ads \
 
 - 「**ローカル画像で入稿**」「**この画像で入稿して**」「画像パスを渡された（ドラッグ&ドロップされた）」ときは、**入口メニューの『ローカル画像で入稿する』へ分岐**し、「画像入稿フロー（ローカル画像・YDA）」を Step 0 から進める。プランナーは開かない。
 - 「入稿プランナー」「YDA入稿プランナー」「入稿シート」「タイトル/画像一覧」「まとめ入稿の確認用シート」等を求められたら、**`adops.sh planner` で開く**（`open <path>` は使わない。`file://` だとプランが読み込まれず空の画面になる）。**媒体が明示されていなければどちらの媒体か確認**し、開いたあとヘッダーの統合プルダウン（案件 × 媒体）で切替えるよう伝える。
-- 「**Meta入稿プランナー**」「Meta のまとめ入稿」等と言われたら、同じ `ad-planner.html` を `adops.sh planner` で開いて **統合プルダウンで `<案件名> Meta` に切替**するよう案内する。アカウント参照データ（`アカウント/meta/<名前>.json`）が無ければ**先に初回セットアップ**（`list --platform meta --resource image-library|video-library|campaigns` で取り込み）へ誘導する。**FBページID / pixelId / CVイベント**が未確定なら、書き出しがブロックされる旨を先に伝えて確認する。
+- 「**Meta入稿プランナー**」「Meta のまとめ入稿」等と言われたら、同じ `ad-planner.html` を `adops.sh planner` で開いて **統合プルダウンで `<案件名> Meta` に切替**するよう案内する。アカウント参照データ（`アカウント/meta/<名前>.json`）が無ければ**先に初回セットアップ**（`list --platform meta --resource pixels|pages|instagram-accounts|image-library|video-library|campaigns` で取り込み）へ誘導する。**FBページID / pixelId / CVイベント**が未確定なら、`list --resource pages|pixels` で候補を出して確定させる（IG は `--resource instagram-accounts --account-id act_<ID>`）（書き出しがブロックされる旨も先に伝える）。
 - 入稿計画JSONは書き出し後 `webgram submit-plan --plan-file <入稿計画.json>` で **dry-run一括検証 → `--no-dry-run --yes` 本実行** にかける（1CPずつ・進捗書き戻しで途中失敗後も再開可、`submitted` 済みはスキップ）。`plan.platform` で YDA / Meta が自動判別される（未記載は yda 扱い）。
 - **Meta は本番PoC 未実施**なので、実入稿を頼まれたら「配信オフ（PAUSED）・1キャンペーン・最小予算から」を必ず提案してから進める。