addashboard-cli 0.13.0 → 0.15.0

package/skills/ad-ops/ad-planner.html

@@ -918,7 +918,7 @@ finalUrl = baseURL + paramCode + "?ad=" + paramCode + "&creative=" + …
    （cli/test/unit/plannerVersion.test.ts が package.json との一致を検証するので、
    手で書き換えて放置するとテストが落ちる）。
    利用者が「どの版のプランナーを開いているか」を言えないと、不具合報告が噛み合わない。 */
-const APP_VERSION = '0.13.0'; /* version:sync */
+const APP_VERSION = '0.15.0'; /* version:sync */
 /* 案A: embed廃止。参照データ(refs)・初期プラン・共通設定は外部JSONから起動時に読み込む。
    同梱デフォルト: アカウント/<媒体>/index.json の先頭アカウント (refs+principal+projectName+baseArticleUrl) と サンプルプラン.json (project+campaigns)。
    固有名詞はハードコードせず、すべて外部JSON由来にする。 */
@@ -1173,6 +1173,10 @@ const EC = {
   LONG_HEADLINE_UNRESOLVED:'LONG_HEADLINE_UNRESOLVED',
   LONG_HEADLINE_TOO_LONG:'LONG_HEADLINE_TOO_LONG',
   LONG_HEADLINE_MISSING:'LONG_HEADLINE_MISSING' /* 動画広告は長見出しが必須 */,
+  VIDEO_EXTRA_UNRESOLVED:'VIDEO_EXTRA_UNRESOLVED' /* 2本目以降の動画が未登録 = 足りない本数で入稿してしまう (Google 動画広告・#347) */,
+  VIDEO_DUPLICATE:'VIDEO_DUPLICATE'               /* 同じ YouTube 動画を2回選んでいる (backend が 400) */,
+  VIDEO_TOO_MANY:'VIDEO_TOO_MANY'                 /* 動画が 5 本を超える */,
+  VIDEO_EXTRA_IGNORED:'VIDEO_EXTRA_IGNORED'       /* 画像広告に2本目以降の番号がある (warn・送らない) */,
   BUSINESS_NAME_MISSING:'BUSINESS_NAME_MISSING' /* proto 上 REQUIRED */,
   LOGO_MISSING:'LOGO_MISSING'                   /* 画像広告はロゴ 1-5 件が必須 */,
   LOGO_FOREIGN_ACCOUNT:'LOGO_FOREIGN_ACCOUNT'   /* ロゴが別 Customer の asset = 入稿時に必ず落ちる */,
@@ -1185,6 +1189,7 @@ const EC = {
   THUMB_MISSING:'THUMB_MISSING'           /* YDA は動画からサムネを自動生成しないので必ず要る */,
   VIDEO_PATH_IGNORED:'VIDEO_PATH_IGNORED' /* 動画 mediaID が解決済みなのにローカル動画パスも入力 (warn) */,
   BANNER_VIDEO_UNSUPPORTED:'BANNER_VIDEO_UNSUPPORTED' /* 広告タイプ=バナー × 形式=動画 は未対応 */,
+  BANNER_CARD_UNSUPPORTED:'BANNER_CARD_UNSUPPORTED'   /* 広告タイプ=バナー × 形式=Card(1200x628) は Yahoo が拒否する */,
   /* ByteDance (TikTok) 固有 */
   IDENTITY_MISSING:'IDENTITY_MISSING'  /* 広告主として表示する TikTok アカウント未設定 = 広告が作れない */,
   IDENTITY_BC_MISSING:'IDENTITY_BC_MISSING' /* identityType=BC_AUTH_TT なのに BC ID が無い (実運用の identity はほぼ BC_AUTH_TT) */,
@@ -1198,6 +1203,12 @@ const EC = {
    同梱デフォルトアカウントは <account.dir>/index.json の先頭エントリを起動時に読み込んで決める（固有名詞のハードコードなし）。 */
 let BUNDLED_ACCOUNT_ID = '';
 let BUNDLED_ACCOUNT_NAME = '';
+/* Google 動画広告の動画本数の上限（公式ヘルプ「Upload 1-5 videos per ad」・backend と同じ） */
+const GOOGLE_MAX_VIDEOS=5;
+/** 「542, 543」「542、543」「542 543」を番号の配列に。重複は先に出たほうを残す */
+function splitNos(v){ const out=[]; String(v==null?'':v).split(/[,、\s]+/).map(x=>x.trim()).filter(Boolean).forEach(x=>{ if(out.indexOf(x)<0) out.push(x); }); return out; }
+/** 広告行の動画番号（先頭が代表 = imageNo）。画像広告や旧プランは imageNo だけ */
+function videoNosOf(a){ return splitNos([a.imageNo==null?'':a.imageNo, a.format==='VIDEO'?(a.moreVideoNos||''):''].join(',')); }
 /* ============================================================
    S7: PLATFORMS — 媒体スキーマ定義レジストリ
    ------------------------------------------------------------
@@ -1761,6 +1772,15 @@ PLATFORMS.yda = {
        ・**サムネは必須**。YDA は動画からサムネを自動生成しないので (本番実測)、
          mediaId かローカルパスのどちらかが無いと広告作成が R0001 で落ちる
        ・バナー × 動画 は backend の zod が弾く組み合わせ。dry-run より手前で気づけるよう err にする */
+    /* バナー × Card(1200x628) は **Yahoo が受け付けない組み合わせ**。
+       公式の入稿規定でバナー(画像)の対応アスペクト比に 1.91:1 は無く (1:1 / 6:5 等のみ)、
+       1200x628 はレスポンシブのサイズとして載っている。2026-10-13 に広告事業部へ確認済み。
+       本番実測でも 24アカウント・980広告のうち BANNER_AD × 1200x628 は 0 件で、
+       1200x628 を使う 322 件はすべて RESPONSIVE_AD だった。
+       実 API は 220115 Unexpected aspect ratio で弾くが、**dry-run は実 API を叩かないので通る**。
+       バナー × 動画 と同じく、書き出しの手前で止める。 */
+    if(isBanner && !isVideo && fmt.mediaKey==='card')
+      pushErr('バナー×Card(1200)は入稿不可（レスポンシブにするか SQ を使う）', EC.BANNER_CARD_UNSUPPORTED);
     const videoPath=String(ad.videoPath||'').trim();
     const thumbnailPath=String(ad.thumbnailPath||'').trim();
     if(isVideo){
@@ -3846,12 +3866,23 @@ const GOOGLE_COLS = {
     {field:'format', label:'形式', kind:'select', options:['IMAGE','VIDEO'], minWidth:'70px',
      coerce:v=>(String(v).toUpperCase()==='VIDEO'?'VIDEO':'IMAGE'),
      title:'IMAGE = Demand Gen 画像広告 / VIDEO = Demand Gen 動画広告（YouTube）'},
+    /* 動画広告は 1 広告に最大 5 本（縦・横・正方形など・#347）。セルは「542, 543」のように並べ、
+       先頭（imageNo）が代表 = 広告名・キャンペーン名の番号。2本目以降は moreVideoNos に持つ。
+       imageNo を単一のまま残すのは、命名・連番・新規登録素材のパス補完がすべて imageNo を見ているため。
+       縦横の区別は持たない（Google が配信面ごとに比率で選ぶので、入稿には要らない）。 */
     {field:'imageNo', label:'クリエイティブ番号', kind:'refcombo', refTable:'media', drawerType:'media', mediaAxis:'format',
-     width:'6ch', sequenceable:true, errCodes:[EC.IMAGE_UNRESOLVED],
-     ghostKey:'media', ddTitle:'登録クリエイティブから選択',
-     ghostTitle:r=>(r.mediaKind==='VIDEO'?'YouTube動画ID ':'画像アセット ')+r.mediaId,
+     width:'9ch', sequenceable:true, errCodes:[EC.IMAGE_UNRESOLVED, EC.VIDEO_EXTRA_UNRESOLVED, EC.VIDEO_DUPLICATE, EC.VIDEO_TOO_MANY],
+     multiMax:a=>(a.format==='VIDEO'?GOOGLE_MAX_VIDEOS:0),
+     get:a=>splitNos([a.imageNo==null?'':a.imageNo, a.moreVideoNos||''].join(',')).join(', '),
+     set:(a,v)=>{ const l=splitNos(v); a.imageNo=l.length?(/^\d+$/.test(l[0])?Number(l[0]):l[0]):''; a.moreVideoNos=l.slice(1).join(', '); },
+     ghostKey:'media', ddTitle:'登録クリエイティブから選択（動画は複数可）',
+     ghostTitle:r=>(r.mediaKind==='VIDEO'?'YouTube動画ID ':'画像アセット ')+[r.mediaId].concat(r.extraVideoIds).join(', '),
      ghost:(r,a)=>{ if(!a.imageNo) return '<span class="idpill" style="color:var(--faint)">—</span>';
-       if(r.mediaId!=='') return '<span class="idpill">'+(r.mediaKind==='VIDEO'?'VID ':'IMG ')+esc(r.mediaId)+'</span>';
+       if(r.errCodes.includes(EC.VIDEO_TOO_MANY)) return '<span class="err">'+GOOGLE_MAX_VIDEOS+'本まで</span>';
+       if(r.errCodes.includes(EC.VIDEO_DUPLICATE)) return '<span class="err">同じ動画が重複</span>';
+       if(r.errCodes.includes(EC.VIDEO_EXTRA_UNRESOLVED)) return '<span class="err">2本目以降が未登録</span>';
+       const more=r.extraVideoIds.length?' <span class="pill" title="代表を含めて'+(r.extraVideoIds.length+1)+'本">計'+(r.extraVideoIds.length+1)+'本</span>':'';
+       if(r.mediaId!=='') return '<span class="idpill">'+(r.mediaKind==='VIDEO'?'VID ':'IMG ')+esc(r.mediaId)+'</span>'+more;
        if(r.pendingImage) return '<span class="idpill warn" title="アカウント未登録。入稿前にアップロードして新規登録">🆕未登録</span>';
        return '<span class="idpill err">#N/A</span>'; }},
     {field:'titleNo', label:'見出し番号', kind:'refcombo', refTable:'titles', drawerType:'titles',
@@ -4092,7 +4123,7 @@ PLATFORMS.google = {
       businessName:'', logoAsset:'', logoImagePath:'', cta:'詳しくはこちら', startDate:'',
       deliveryStatus:'オフ'
     },
-    ad:{format:'VIDEO', imageNo:'', titleNo:'', longNo:'', descNo:'', videoPath:'', adName:''},
+    ad:{format:'VIDEO', imageNo:'', moreVideoNos:'', titleNo:'', longNo:'', descNo:'', videoPath:'', adName:''},
     adGroup:{name:'', paramCode:'', isExisting:false,
              tg_location:'日本', tg_language:'日本語',
              /* 従来の 'YouTube'（3面まとめて）と同じ配信範囲を、選択肢に載っている値で表す。
@@ -4154,7 +4185,7 @@ PLATFORMS.google = {
       g.tg_channel=out.join(', ');
     }));
   },
-  creativeFields:['imageNo','titleNo','longNo','descNo','videoPath'],
+  creativeFields:['imageNo','moreVideoNos','titleNo','longNo','descNo','videoPath'],
   notSubmittedFields:[],
   labels:{submitButton:'完成 → 保存して入稿', paramCodeLabel:'paramCode', tgDroppedWarn:''},
 
@@ -4224,9 +4255,20 @@ PLATFORMS.google = {
       pushWarn('動画パス無視（動画IDが解決済み）', EC.IMAGE_PATH_IGNORED);
     if(fmt.id==='IMAGE' && videoPath!=='')
       pushWarn('動画パス無視（画像広告）', EC.IMAGE_PATH_IGNORED);
+    /* 2本目以降の動画（#347）。未登録のローカル動画は先頭（代表）だけ — 2本目以降は登録済みの番号に限る */
+    const extraNos = fmt.id==='VIDEO' ? videoNosOf(ad).slice(1) : [];
+    const extraVideoIds = extraNos.map(n=>String(((refs.media[n]||{}).video)||''));
+    if(fmt.id==='VIDEO' && extraNos.length){
+      if(extraVideoIds.some(v=>v==='')) pushErr('2本目以降の動画が未登録（登録済みの番号を選ぶ）', EC.VIDEO_EXTRA_UNRESOLVED);
+      const ids=[String(mediaId||'')].concat(extraVideoIds).filter(Boolean);
+      if(new Set(ids).size!==ids.length) pushErr('同じ動画を2回選んでいる', EC.VIDEO_DUPLICATE);
+      if(extraNos.length+1>GOOGLE_MAX_VIDEOS) pushErr('動画は'+GOOGLE_MAX_VIDEOS+'本まで', EC.VIDEO_TOO_MANY);
+    }
+    if(fmt.id==='IMAGE' && String(ad.moreVideoNos||'').trim()!=='') pushWarn('2本目以降の番号を無視（画像広告は1つ）', EC.VIDEO_EXTRA_IGNORED);
     const aid=String(group.adGroupId||'').trim();
     return {crName, adName, autoAdName, campaignId:'', adGroupId:aid, mediaKind:fmt.apiMediaKind, imageNo:noStr,
       mediaId:mediaId||'', imageAsset:imageAsset||'', squareAsset:squareAsset||'', pendingImage, videoPath,
+      extraVideoIds,
       titleText:titleText===undefined?'':titleText,
       longText:longText===undefined?'':longText,
       descText:descText===undefined?'':descText,
@@ -4435,6 +4477,13 @@ PLATFORMS.google = {
            superRefine の「動画が指定されていません」が出ない（zod は基底 parse に失敗すると
            refinement を走らせない）。キーごと出さないほうが理由が届く。 */
         else if(r.mediaId) out.youtubeVideoId=String(r.mediaId);
+        /* 2本以上のときだけ videos[]（#347）。1本なら旧形式のまま出す — 1本の計画まで新形式にすると
+           旧 CLI で何も入稿できなくなる */
+        if(r.extraVideoIds.length && (out.youtubeVideoId || out.videoPath)){
+          out.videos=[out.youtubeVideoId ? {youtubeVideoId:out.youtubeVideoId} : {videoPath:out.videoPath}]
+            .concat(r.extraVideoIds.map(id=>({youtubeVideoId:id})));
+          delete out.youtubeVideoId; delete out.videoPath;
+        }
         out.longHeadlines=r.longText?[String(r.longText)]:[];
         if(logo) out.logoImages=[logo];
         /* 動画広告のロゴは v23 では任意。ローカルパスからの作成は画像広告に絞る
@@ -5575,7 +5624,13 @@ function renderDrawer(){
   /* S7: 入力先の見出しは列記述子のラベル (媒体ごとの列名をここに書かない) */
   const dcol=colDefs('ads').find(c=>c.field===drawerTarget.f); const fieldName=dcol?dcol.label:'';
   let curNo=''; const fa=findAd(drawerTarget.u); if(fa) curNo=String(fa.a[drawerTarget.f]||'');
-  tgtEl.textContent='入力先: '+fieldName+(curNo?(' ／ 現在 '+curNo):' ／ 未設定');
+  /* 複数選択できる列（Google の動画広告）。押すたびに ON/OFF し、選んだ順に並ぶ。先頭が代表 */
+  const multiMax = (dcol && dcol.multiMax && fa) ? dcol.multiMax(fa.a) : 0;
+  const curList = multiMax ? splitNos(getVar({kind:'a',a:fa.a,g:fa.g,c:fa.c}, colIndex(drawerTarget.f,'ads'), 'ads')) : (curNo?[curNo]:[]);
+  const orderMark = no=>{ const i=curList.indexOf(String(no)); if(!multiMax || i<0) return '';
+    return '<span class="pill"'+(i===0?' title="広告名・キャンペーン名はこの番号から付きます"':'')+'>'+(i===0?'1 代表':String(i+1))+'</span>'; };
+  tgtEl.textContent='入力先: '+fieldName+(curList.length?(' ／ 現在 '+curList.join(', ')):' ／ 未設定')
+    + (multiMax?('（押すたびに追加/解除・最大'+multiMax+'本・先頭が代表）'):'');
   /* S10: 参照テーブルは列記述子の refTable から引く。値の見せ方は refTables[key] (label/drawerLabel/dropEmpty)。 */
   const rkey=(dcol&&dcol.refTable) || (drawerTarget.type==='titles'?'titles':'media');
   const T=refTableDef(rkey)||{}, store=st.refs[rkey]||{};
@@ -5595,9 +5650,9 @@ function renderDrawer(){
     if(isMedia && !hasFmt(v)) return;
     if(q && !refSearchStrings(T,no,v).some(s=>s.includes(q))) return;
     const txt = T.drawerLabel ? T.drawerLabel(v) : esc(String(v==null?'':v));
-    html+='<div class="ddrow'+(String(no)===curNo?' cur':'')+'" data-no="'+esc(no)+'">'
+    html+='<div class="ddrow'+(curList.indexOf(String(no))>=0?' cur':'')+'" data-no="'+esc(no)+'">'
       +(single?'':thumbImgHtml(no))+'<span class="ddno">'+esc(no)+'</span>'
-      +(single?'':newBadge(rkey,no))+'<span class="ddtx">'+txt+'</span></div>';
+      +orderMark(no)+(single?'':newBadge(rkey,no))+'<span class="ddtx">'+txt+'</span></div>';
   });
   /* この計画で新しく登録した素材。**まだ媒体に上がっていないので mediaID が無く、refs には入れない**
      (空の ID を入れると「登録済み」と誤判定され、CLI のアップロードが走らない)。
@@ -5608,8 +5663,8 @@ function renderDrawer(){
     /* 種類 (動画 / 画像) が行と違う素材は出さない */
     if(lm && fmt && ((fmt.apiMediaKind==='VIDEO') !== !!lm.video)) return;
     const thumb=lm ? (lm.thumb||lm.image) : '';
-    html+='<div class="ddrow'+(String(no)===curNo?' cur':'')+'" data-no="'+esc(no)+'">'
-      +(thumb?'<img class="ddthumb" data-localthumb="'+esc(thumb)+'" alt="">':'')
+    html+='<div class="ddrow'+(curList.indexOf(String(no))>=0?' cur':'')+'" data-no="'+esc(no)+'">'
+      +(thumb?'<img class="ddthumb" data-localthumb="'+esc(thumb)+'" alt="">':'')+orderMark(no)
       +'<span class="ddno">'+esc(no)+'</span>'
       +'<span class="idpill warn">🆕未登録</span>'
       +'<span class="ddtx">'+(lm&&lm.file?esc(lm.file)+'　':'')+'この計画で追加（入稿時にアップロードします）</span></div>';
@@ -5746,8 +5801,35 @@ function closeThumbZoom(){
 
 function thumbZoomKey(ev){ if(ev.key==='Escape') closeThumbZoom(); }
 
+/** 複数選択の列で番号を ON/OFF する。範囲選択中は、押したセルの状態に揃えて選択範囲の同じ列へ。
+    閉じずに描き直す（続けて2本目・3本目を選べるように） */
+function drawerToggleMulti(col, no){
+  const ci=colIndex(col.field,'ads'), fa=findAd(drawerTarget.u); if(!fa||ci<0) return;
+  const self={kind:'a',a:fa.a,g:fa.g,c:fa.c};
+  const adding = splitNos(getVar(self,ci,'ads')).indexOf(String(no))<0;
+  const rg=selRange(), items=[];
+  if(rg && rg.c0<=ci && rg.c1>=ci){ const vis=flatVisible(); for(let r=rg.r0;r<=rg.r1;r++){ const it=vis[r]; if(it&&it.kind==='a') items.push(it); } }
+  if(!items.some(it=>it.a===fa.a)) items.splice(0, items.length, self);
+  let applied=0, full=0;
+  mutate(()=>items.forEach(it=>{
+    const max=col.multiMax(it.a), l=splitNos(getVar(it,ci,'ads')), i=l.indexOf(String(no));
+    if(!max) return;
+    if(adding && i<0){ if(l.length>=max){ full++; return; } l.push(String(no)); }
+    else if(!adding && i>=0) l.splice(i,1);
+    else return;
+    const wasFirst=String(it.a.imageNo==null?'':it.a.imageNo);
+    setVar(it,ci,l.join(', '),'ads');
+    /* 代表が新規登録の素材に変わったら、その素材のパスも入れる */
+    if(String(it.a.imageNo)!==wasFirst) applyLocalMediaPaths(it, it.a.imageNo);
+    applied++;
+  }));
+  toast('番号 '+no+' を'+applied+'セルで'+(adding?'追加':'解除')+(full?('（'+full+'セルは上限のため追加せず）'):''));
+  renderDrawer();
+}
 function drawerPick(no){
   if(!drawerTarget) return;
+  const mcol=colDefs('ads').find(c=>c.field===drawerTarget.f), mfa=findAd(drawerTarget.u);
+  if(mcol && mcol.multiMax && mfa && mcol.multiMax(mfa.a)){ drawerToggleMulti(mcol, no); return; }
   const f=drawerTarget.f, num=/^\d+$/.test(no)?Number(no):no;
   // S3: 旧 [1] / [2,3] リテラルを撤去。同じ▼ドロワー表示モードを持つ refcombo 列を記述子から算出する
   const compat = compatColsFor(drawerTarget.type, sheetTab);

package/skills/ad-ops/scripts/adops.sh

@@ -8,13 +8,22 @@
 #                                               --wait は入稿ボタンが押されるまで待ってから処理する
 #   adops.sh open <platform> <accountId> [resource]  管理画面を開く (URLを手で組み立てない)
 #   adops.sh refs-import <platform> <accountId> [--write]  実アカウントから参照表を取り込む
+#   adops.sh assets-sync <platform> <accountId> [--write]  媒体の素材を参照表(refs.media)へ取り込む
 #   adops.sh refs-import google <accountId> --from-plan <入稿計画.json> [--write]
 #                                                        入稿で作ったロゴを取り込む（実APIを叩かない）
 #
 # 覚えるコマンドを1本に畳むためのラッパー。個別の python3 -c / curl / ls -t を書かない。
 set -uo pipefail
+# Windows の既定コンソール (cp932) だと Python の ✓ や日本語の出力で UnicodeEncodeError になる
+export PYTHONUTF8=1 PYTHONIOENCODING=utf-8
+# Windows の Python (subprocess) は npx を見つけられない (実体が npx.cmd で WinError 2 になる)。
+# refs_import.py / thumbs_download.py は ADOPS_CLI で CLI を呼ぶので、既定をここで合わせる
+case "${OSTYPE:-}" in
+  msys*|cygwin*) export ADOPS_CLI="${ADOPS_CLI:-npx.cmd -y addashboard-cli@latest}" ;;
+esac
 
-SKILL_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+# Windows ではネイティブ形式のパスで持つ (Python に渡すため)。pwd -W が無い Mac は pwd
+SKILL_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && { pwd -W 2>/dev/null || pwd; })"
 # 配信ポート。既定 8799 は cli/playwright.config.ts の webServer と共用する。
 # **worktree を分けて並行作業していると別 worktree のサーバを再利用してしまう**
 # (curl が応答すれば「起動済み」と判断するので、別ブランチのプランナーが開く)。
@@ -29,6 +38,20 @@ CLI="${WEBGRAM_CLI:-npx -y addashboard-cli@latest}"
 
 die() { echo "✗ $*" >&2; exit 1; }
 
+# URL をブラウザで開く。Mac は従来どおり open に渡す (`open -a ...` の引数もそのまま通す)。
+# Git Bash (Windows) には open が無いので Chrome を直接起動し、無ければ既定ブラウザで開く。
+# rundll32 は shell を経由しないので、& を含む URL (Google 管理画面など) でも欠けない。
+open_url() {
+  if command -v open >/dev/null 2>&1; then open "$@"; return; fi
+  local url="${!#}" c
+  for c in "/c/Program Files/Google/Chrome/Application/chrome.exe" \
+           "/c/Program Files (x86)/Google/Chrome/Application/chrome.exe" \
+           "${LOCALAPPDATA:-}/Google/Chrome/Application/chrome.exe"; do
+    [ -x "$c" ] && { "$c" "$url" >/dev/null 2>&1 & return; }
+  done
+  rundll32 url.dll,FileProtocolHandler "$url"
+}
+
 # ------------------------------------------------------------- ensure_login
 # 未ログインなら auth login を起動して完了まで待ち、そのまま処理を続ける。
 # 以前は「ターミナルで auth login を実行してください」と案内して止めていたため、
@@ -150,6 +173,17 @@ with open(os.environ["OUT"], "w", encoding="utf-8") as f:
 PY
 }
 
+# 配信サーバーを止める。Mac は従来どおり pkill。
+# Git Bash (Windows) には pkill が無いので、ポートを LISTEN している python だけを taskkill で止める
+# (/PID 形式は Git Bash がパスに変換してしまうので - 形式で渡す)。
+stop_server() {
+  if command -v pkill >/dev/null 2>&1; then pkill -f "http.server ${PORT}"; return; fi
+  local pid
+  pid="$(netstat -ano | awk -v p=":${PORT}" '$1 == "TCP" && $2 ~ p"$" && $4 == "LISTENING" { print $5; exit }')"
+  [ -n "$pid" ] && tasklist -FI "PID eq ${pid}" -NH | grep -qi python \
+    && taskkill -PID "$pid" -F >/dev/null 2>&1
+}
+
 # file:// で開くと fetch('サンプルプラン.json') がブロックされ、
 # エラーも出ないまま空のプランナーが表示される。必ずHTTPで開く。
 cmd_planner() {
@@ -157,7 +191,7 @@ cmd_planner() {
   while [ $# -gt 0 ]; do
     case "$1" in
       --stop)
-        pkill -f "http.server ${PORT}" && echo "✓ プランナーの配信を停止しました" \
+        stop_server && echo "✓ プランナーの配信を停止しました" \
           || echo "（起動中のサーバーはありませんでした）"
         return 0 ;;
       --platform) platform="${2:-}"; shift 2 ;;
@@ -173,7 +207,7 @@ cmd_planner() {
   fi
   write_planner_env
 
-  if curl -sf -o /dev/null "$URL"; then
+  if curl -sf "$URL" >/dev/null; then
     echo "✓ 配信は起動済み（再利用）"
     echo "  ⚠ 別の作業ディレクトリ (worktree) が起動したサーバの可能性があります。" >&2
     echo "    プランナーの内容が想定と違うときは ADOPS_PORT=8801 adops.sh planner ... で専用ポートに切り替えてください。" >&2
@@ -183,10 +217,10 @@ cmd_planner() {
     nohup python3 -m http.server "$PORT" --directory "$SKILL_DIR" \
       >/tmp/adops-planner.log 2>&1 &
     for _ in $(seq 1 20); do
-      curl -sf -o /dev/null "$URL" && break
+      curl -sf "$URL" >/dev/null && break
       sleep 0.3
     done
-    curl -sf -o /dev/null "$URL" || die "配信を起動できませんでした（/tmp/adops-planner.log を確認）"
+    curl -sf "$URL" >/dev/null || die "配信を起動できませんでした（/tmp/adops-planner.log を確認）"
     echo "✓ 起動しました"
   fi
 
@@ -196,8 +230,10 @@ cmd_planner() {
   if [ -d "/Applications/Google Chrome.app" ] || [ -d "$HOME/Applications/Google Chrome.app" ]; then
     open -a "Google Chrome" "$URL"
   else
-    open "$URL"
-    echo "  ⚠ Google Chrome が見つかりません。素材の登録と入稿計画の保存は Chrome 系ブラウザでしか動きません" >&2
+    open_url "$URL"
+    # Windows は open_url が Chrome を直接探して起動するので、Mac (open がある) のときだけ警告する
+    command -v open >/dev/null 2>&1 \
+      && echo "  ⚠ Google Chrome が見つかりません。素材の登録と入稿計画の保存は Chrome 系ブラウザでしか動きません" >&2
   fi
   echo "  $URL"
   echo "  停止: adops.sh planner --stop"
@@ -312,7 +348,7 @@ PY
   esac
 
   echo "$url"
-  [ -n "$dry" ] || open "$url"
+  [ -n "$dry" ] || open_url "$url"
 }
 
 # --------------------------------------------------------------- refs-import
@@ -322,6 +358,13 @@ cmd_refs_import() {
   python3 "${SKILL_DIR}/scripts/refs_import.py" "$@"
 }
 
+# 媒体に登録済みの素材を参照表（refs.media）へ取り込む。
+# refs-import は見出し/説明文/オーディエンス/配置面だけで media を扱わないため分けてある。
+# --write なしは差分表示のみ（dry-run 既定）。
+cmd_assets_sync() {
+  python3 "${SKILL_DIR}/scripts/assets_sync.py" "$@"
+}
+
 # 素材のサムネイルを落として アカウント/<媒体>/サムネ/<accountId>/ に置く。
 # プランナーの素材選択でサムネを出すために使う。保存先は .gitignore 済み。
 cmd_thumbs() {
@@ -334,6 +377,7 @@ case "${1:-}" in
   plan)        shift; cmd_plan "$@" ;;
   open)        shift; cmd_open "$@" ;;
   refs-import) shift; cmd_refs_import "$@" ;;
+  assets-sync) shift; cmd_assets_sync "$@" ;;
   thumbs)      shift; cmd_thumbs "$@" ;;
   *)
     cat >&2 <<EOF
@@ -351,6 +395,9 @@ usage:
   adops.sh refs-import <platform> <accountId> [--write] [--campaign-id <id>]
   adops.sh refs-import google <accountId> --from-plan <入稿計画.json> [--write]
                                               実アカウントから参照表を取り込む（既定 dry-run）
+  adops.sh assets-sync <platform> <accountId> [--write]
+                                              媒体の素材を参照表(refs.media)へ取り込む（既定 dry-run）
+                                              既存の番号・値は変更せず、足りない分だけ足す
   adops.sh thumbs <platform> <accountId> [--force] [--limit N]
                                               素材のサムネイルを落として素材選択で見られるようにする
                                               （保存先は アカウント/<媒体>/サムネ/。追跡・公開しない）

package/skills/ad-ops/scripts/assets_sync.py

@@ -0,0 +1,277 @@
+#!/usr/bin/env python3
+"""媒体に登録済みの素材を参照表（refs.media）へ取り込む。
+
+`adops.sh assets-sync <platform> <accountId> [--write]` から呼ばれる。単体でも動く:
+
+    python3 assets_sync.py yda <accountId> [--write]
+
+refs_import.py が見出し・説明文・オーディエンス・配置面を扱うのに対し、
+こちらは **media 専用**。両者は番号空間も取得元も違うので分けてある。
+
+━━ なぜ要るか ━━
+参照表は「初回に作る」手順（プランナーの ❓使い方 → アカウント取込プロンプト）はあるが、
+**後から追記する手段が無かった**。媒体に素材を足してもプランナーの選択肢に出ないため、
+「媒体にはあるのに入稿できない」という状態になる（#325）。
+
+━━ 振り分けはファイル名ではなく実寸で行う ━━
+mediaName の `-1080` / `-1200` は実サイズとズレている（実測: `-1080` の 96% が 600x600、
+`-1200` で 2400x1256 のものもある）。アップロード時に `元ファイル名 + contentHash` へ
+加工される経路もあるので、名前は振り分けの根拠にしない。
+
+  aspectRatio が 1.91:1 系 → card
+  aspectRatio が 1:1 系    → sq
+  それ以外                 → 取り込まない（件数だけ報告）
+
+━━ 既存は絶対に触らない ━━
+画像番号は広告名（`957c-jv_Cac_148`）と計測パラメータ（`creative=`）に焼き込まれている。
+番号がずれると過去の実績と突き合わせられなくなるので、
+
+  * 既存の番号は振り直さない
+  * 既存の値は上書きしない（違う mediaId を見つけても報告だけ）
+  * 媒体から消えたものは削除しない
+
+━━ 取りきれていないときは書かない ━━
+backend の MediaService 取得は 500 件固定でページング未対応。全件取れていない状態で
+書き込むと「媒体に無い」と誤認した欠落データを正にしてしまう。取得が怪しいときは
+書き込まずに報告して終わる（呼び出し側は既存の参照表のまま先へ進める）。
+"""
+import argparse
+import glob
+import json
+import os
+import re
+import shutil
+import subprocess
+import sys
+from datetime import datetime
+
+SKILL_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+CLI = os.environ.get("ADOPS_CLI", "npx -y addashboard-cli@latest")
+
+# backend の MediaService 取得が 1 回で返す上限。ここに達していたら全件取れていない
+# 可能性があるので書き込まない（connector 側が thumbnailFlg 等を間引くため、
+# 見える件数が上限未満でも取りこぼしはありうる。あくまで「明らかに怪しい」の検知）。
+FETCH_LIMIT = 500
+
+# 取り込んでよい審査状態。
+#   APPROVED               … 承認済み
+#   PENDING_UNSPECIFIED_AD … まだ広告に使われていないだけ。否認ではない
+# PRE_DISAPPROVED / POST_DISAPPROVED を入れると「選べるのに入稿で落ちる」状態になる。
+USABLE_APPROVAL = {"APPROVED", "PENDING_UNSPECIFIED_AD"}
+
+# aspectRatio → 参照表のスロット。媒体の表記ゆれ（AR_191_100 / AR_1200_628）を吸収する。
+SLOT_BY_ASPECT = {
+    "AR_191_100": "card",
+    "AR_1200_628": "card",
+    "AR_1_1": "sq",
+}
+
+
+def fetch_media(platform: str, account_id: str) -> list | None:
+    """登録済み素材の一覧を取る。取れなければ None（空配列と区別する）。
+
+    「取得失敗」を「素材が0件」と取り違えると、参照表を空にしかねない。
+    """
+    cmd = [*CLI.split(), "list", "--platform", platform,
+           "--resource", "media", "--account-id", account_id]
+    print("▸ 媒体の素材一覧を取得中...", file=sys.stderr)
+    try:
+        proc = subprocess.run(cmd, capture_output=True, text=True, timeout=600)
+    except Exception as e:  # noqa: BLE001
+        print(f"  ✗ 取得に失敗: {e}", file=sys.stderr)
+        return None
+    if proc.returncode != 0:
+        print(f"  ✗ 取得に失敗 (exit {proc.returncode}): {proc.stderr.strip()[:400]}",
+              file=sys.stderr)
+        return None
+    try:
+        data = json.loads(proc.stdout)
+    except Exception as e:  # noqa: BLE001
+        print(f"  ✗ 応答を解釈できません: {e}", file=sys.stderr)
+        return None
+    media = data.get("media")
+    if not isinstance(media, list):
+        print("  ✗ 応答に media がありません", file=sys.stderr)
+        return None
+    return media
+
+
+def find_account(platform: str, account_id: str) -> tuple[str | None, dict]:
+    """accountId から参照表のパスと内容を引く（sample_account は最後に回す）。"""
+    paths = [p for p in glob.glob(os.path.join(SKILL_DIR, "アカウント", platform, "*.json"))
+             if os.path.basename(p) != "index.json"]
+    paths.sort(key=lambda p: os.path.basename(p) == "sample_account.json")
+    for path in paths:
+        try:
+            data = json.load(open(path, encoding="utf-8"))
+        except Exception:  # noqa: BLE001
+            continue
+        if str(data.get("accountId", "")) == str(account_id):
+            return path, data
+    return None, {}
+
+
+def image_no(media_name: object) -> str | None:
+    """素材名の先頭の数字を画像番号として取る（`183-1200.jpg` → `183`）。
+
+    先頭が数字でないものは番号を決められないので取り込まない。推測で番号を振ると
+    既存の番号体系を壊すため、ここは厳格にする。
+    """
+    m = re.match(r"(\d+)", str(media_name or ""))
+    return m.group(1) if m else None
+
+
+def classify(media: list) -> dict:
+    """素材一覧を (番号, スロット) → mediaId の候補表に畳む。
+
+    同じ組み合わせに複数の素材が当たったら、どれを採るか機械的に決められないので
+    候補をすべて残して呼び出し側に判断させる（自動採用しない）。
+    """
+    out = {
+        "candidates": {},      # (no, slot) -> [mediaId, ...]
+        "skipped_approval": 0,  # 否認済み
+        "skipped_aspect": 0,    # card/sq に当てはまらない比率
+        "skipped_name": 0,      # 番号を取れない
+    }
+    for m in media:
+        mid = str(m.get("mediaId") or "")
+        if not mid:
+            continue
+        if (m.get("approvalStatus") or "") not in USABLE_APPROVAL:
+            out["skipped_approval"] += 1
+            continue
+        slot = SLOT_BY_ASPECT.get(m.get("aspectRatio") or "")
+        if not slot:
+            out["skipped_aspect"] += 1
+            continue
+        no = image_no(m.get("mediaName"))
+        if not no:
+            out["skipped_name"] += 1
+            continue
+        out["candidates"].setdefault((no, slot), []).append(mid)
+    return out
+
+
+def merge(refs_media: dict, classified: dict) -> tuple[dict, list[str], dict]:
+    """既存を保ったまま不足分だけ足す。
+
+    returns (merged, report, stats)
+    """
+    merged = {k: dict(v) if isinstance(v, dict) else v for k, v in (refs_media or {}).items()}
+    added, ambiguous, conflicts = [], [], []
+
+    for (no, slot), ids in sorted(classified["candidates"].items(), key=lambda x: (int(x[0][0]), x[0][1])):
+        cur = merged.get(no)
+        if cur is not None and not isinstance(cur, dict):
+            continue  # 想定外の形。触らない
+        if len(ids) > 1:
+            # どれが正か決められない。既に値があるならそのまま、無ければ空けておく
+            ambiguous.append((no, slot, ids))
+            continue
+        mid = ids[0]
+        if cur is None:
+            merged[no] = {slot: mid}
+            added.append((no, slot, mid, "新規番号"))
+        elif slot not in cur:
+            cur[slot] = mid
+            added.append((no, slot, mid, "枠を追加"))
+        elif str(cur[slot]) != mid:
+            # 既存の値は上書きしない。媒体側で差し替わっている可能性を報告だけする
+            conflicts.append((no, slot, str(cur[slot]), mid))
+
+    report = []
+    report.append(f"追加: {len(added)} 件"
+                  f"（card {sum(1 for a in added if a[1] == 'card')} / "
+                  f"sq {sum(1 for a in added if a[1] == 'sq')}）")
+    if ambiguous:
+        report.append(f"⚠ 同じ番号・同じ形式に候補が複数あるため取り込みませんでした: {len(ambiguous)} 件")
+        for no, slot, ids in ambiguous[:5]:
+            report.append(f"    番号 {no} / {slot}: {', '.join(ids)}")
+    if conflicts:
+        report.append(f"⚠ 既存と違う mediaId が媒体にあります（上書きしていません）: {len(conflicts)} 件")
+        for no, slot, old, new in conflicts[:5]:
+            report.append(f"    番号 {no} / {slot}: 参照表 {old} / 媒体 {new}")
+    for key, label in (("skipped_approval", "審査で否認された素材"),
+                       ("skipped_aspect", "card/sq に当てはまらない比率の素材"),
+                       ("skipped_name", "名前から番号を取れない素材")):
+        if classified[key]:
+            report.append(f"除外: {label} {classified[key]} 件")
+
+    stats = {"added": len(added), "ambiguous": len(ambiguous), "conflicts": len(conflicts)}
+    return merged, report, stats
+
+
+def main() -> int:
+    ap = argparse.ArgumentParser(description="媒体の素材を参照表（refs.media）へ取り込む")
+    ap.add_argument("platform", choices=["yda"],
+                    help="現在は yda のみ。媒体ごとに番号の付け方が違うため横展開はしない")
+    ap.add_argument("account_id")
+    ap.add_argument("--write", action="store_true", help="参照表へ書き込む（既定は差分表示のみ）")
+    args = ap.parse_args()
+
+    path, account = find_account(args.platform, args.account_id)
+    if not path:
+        print(f"✗ accountId {args.account_id} の参照表が見つかりません", file=sys.stderr)
+        print("  初めて使うアカウントは、先にアカウント取込プロンプトで作成してください",
+              file=sys.stderr)
+        return 1
+
+    media = fetch_media(args.platform, args.account_id)
+    if media is None:
+        print("✗ 素材一覧を取得できなかったため、参照表は変更していません")
+        return 1
+
+    print(f"  媒体の素材: {len(media)} 件")
+
+    # 取得上限に達している = 全件取れていない可能性がある。欠落したまま書くと危険なので止める。
+    truncated = len(media) >= FETCH_LIMIT
+    classified = classify(media)
+    refs = (account.get("refs") or {}).get("media") or {}
+    merged, report, stats = merge(refs, classified)
+
+    print(f"\n── {os.path.basename(path)} ──")
+    before_card = sum(1 for v in refs.values() if isinstance(v, dict) and v.get("card"))
+    before_sq = sum(1 for v in refs.values() if isinstance(v, dict) and v.get("sq"))
+    after_card = sum(1 for v in merged.values() if isinstance(v, dict) and v.get("card"))
+    after_sq = sum(1 for v in merged.values() if isinstance(v, dict) and v.get("sq"))
+    print(f"  画像番号  {len(refs)} → {len(merged)}")
+    print(f"  card      {before_card} → {after_card}")
+    print(f"  sq        {before_sq} → {after_sq}")
+    for line in report:
+        print(f"  {line}")
+
+    if truncated:
+        print(f"\n✗ 取得件数が上限（{FETCH_LIMIT}）に達しています。全件取れていない可能性が"
+              "あるため書き込みません。")
+        print("  ページング対応が入るまで、このアカウントは手動で参照表を整えてください。")
+        return 2
+
+    if stats["added"] == 0:
+        print("\n（参照表は最新です）")
+        return 0
+
+    if not args.write:
+        print("\n（dry-run: 書き込んでいません。反映するには --write を付けてください）")
+        return 0
+
+    # 書き込み前に必ず退避する。固定名だと2回目の write で最初の退避が消えるので世代を残す。
+    stamp = datetime.now().strftime("%Y%m%d-%H%M%S")
+    backup, n = f"{path}.{stamp}.bak", 1
+    while os.path.exists(backup):
+        backup, n = f"{path}.{stamp}-{n}.bak", n + 1
+    shutil.copy2(path, backup)
+
+    account.setdefault("refs", {})["media"] = merged
+    # 一時ファイルへ書いてから rename する。途中で落ちても元が壊れない
+    tmp = f"{path}.tmp"
+    with open(tmp, "w", encoding="utf-8") as f:
+        json.dump(account, f, indent=1, ensure_ascii=False)
+        f.write("\n")
+    os.replace(tmp, path)
+    print(f"\n✓ 書き込みました: {path}")
+    print(f"  退避: {os.path.basename(backup)}（元に戻すならこれを上書きコピー）")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())