Claude Codeで入稿規定のバナーサイズをチェックする手順

{
  "gdn-image": {
    "source": "https://support.google.com/google-ads/answer/1722096",
    "formats": ["GIF", "JPEG", "PNG"],
    "max_kb": 150,
    "sizes": ["300x250", "336x280", "728x90", "970x250",
              "160x600", "300x600", "320x50", "320x100"],
    "gif_max_seconds": 30,
    "gif_max_fps": 5
  }
}

banners/ 以下の画像を specs.json の "gdn-image" の規定で検査する
Pythonスクリプト check_creatives.py を作ってください。
- 画像の読み取りには Pillow を使う
- 検査項目: 形式、幅x高さ、容量(KB)、GIFの尺と平均FPS
- 拡張子で対象を絞らず、フォルダ内の全ファイルを見る
  (規定外の形式や壊れたファイルも不適合として出す)
- 不適合は「NG パス: 理由 / 理由」の1行で出力し、最後に件数を出す
- 不適合があれば終了コード1で終わる
- 規定の数字はスクリプトに書かず specs.json から読む

#!/usr/bin/env python3
"""banners/ 以下の画像を specs.json の規定で検査し、不適合を一覧にする。"""
import json, sys
from pathlib import Path
from PIL import Image
 
def check(path, spec):
    problems = []
    kb = path.stat().st_size / 1024
    if kb > spec["max_kb"]:
        problems.append(f"容量超過 {kb:.0f}KB > {spec['max_kb']}KB")
    try:
        with Image.open(path) as im:
            fmt, size = im.format, f"{im.width}x{im.height}"
            if fmt not in spec["formats"]:
                problems.append(f"形式 {fmt} は対象外")
            if size not in spec["sizes"]:
                problems.append(f"サイズ {size} は規定外")
            if fmt == "GIF" and getattr(im, "n_frames", 1) > 1:
                total_ms = 0
                for i in range(im.n_frames):
                    im.seek(i)
                    total_ms += im.info.get("duration", 100)
                sec = total_ms / 1000
                fps = im.n_frames / sec if sec else 0
                if sec > spec["gif_max_seconds"]:
                    problems.append(f"GIFの尺 {sec:.1f}秒 > {spec['gif_max_seconds']}秒")
                if fps >= spec["gif_max_fps"]:
                    problems.append(f"GIFのFPS {fps:.1f} は {spec['gif_max_fps']} 未満が条件")
    except OSError as e:
        problems.append(f"画像として開けない: {e}")
    return problems
 
def main(folder, spec_name):
    spec = json.load(open("specs.json"))[spec_name]
    ng = 0
    for p in sorted(Path(folder).rglob("*")):
        if not p.is_file() or p.name.startswith("."):
            continue
        probs = check(p, spec)
        if probs:
            ng += 1
            print(f"NG {p}: " + " / ".join(probs))
    print(f"不適合 {ng} 件")
    sys.exit(1 if ng else 0)
 
if __name__ == "__main__":
    main(sys.argv[1], sys.argv[2])

NG banners/anim.gif: GIFのFPS 8.2 は 5 未満が条件
NG banners/bad.webp: 形式 WEBP は対象外
NG banners/bad_300x251.png: サイズ 300x251 は規定外
NG banners/big_970x250.png: 容量超過 496KB > 150KB
不適合 4 件

import json, subprocess
 
def video_info(path):
    out = subprocess.run(
        ["ffprobe", "-v", "error", "-show_entries", "format=duration,size",
         "-of", "json", str(path)],
        capture_output=True, text=True, check=True,
    ).stdout
    fmt = json.loads(out)["format"]
    return float(fmt["duration"]), int(fmt["size"]) / 1024  # 秒, KB

## 入稿前チェック
- 入稿用の画像は `banners/` に置く。規定は `specs.json` が正で、数字をスクリプトに直書きしない
- 検査は `python3 check_creatives.py banners <規定名>` で行い、NGが出たら一覧を貼って原因別に直す
- 規定を足すときは、出典URLと確認日を `specs.json` の `source` に残す

{
  "permissions": {
    "allow": [
      "Bash(python3 check_creatives.py *)",
      "Bash(ffprobe *)"
    ]
  }
}

ng.txt のうち「容量超過」だけを対象に、banners/ の画像を
fixed/ へ書き出してください。
- JPEGは quality を85から5ずつ下げ、150KB以下になった最初の値で止める
- 70未満まで下げないと収まらないものは書き出さず、ファイル名を報告する
- サイズずれは自動で拡縮せず、報告だけにする
- 書き出した後、fixed/ に check_creatives.py を実行して結果を貼る