共有カードの下端が切れていた OGP 画像を、宣言ではなくピクセルで検査して止めるまで

#!/usr/bin/env python3
"""public/og 以下の画像を実寸で検査します。宣言ではなくピクセルを読みます。"""
import sys
from pathlib import Path
from PIL import Image
 
TARGET = (1200, 630)          # 共有カードに使う画像の実寸
EXEMPT = {"stripe.png"}       # 正方形が必要な別用途のファイル名（og 配下に置く場合）
 
 
def check(root: Path):
    bad, total = [], 0
    for p in sorted(root.rglob("*")):
        if p.suffix.lower() not in {".png", ".jpg", ".jpeg", ".webp"}:
            continue
        total += 1
        if p.name in EXEMPT:
            continue
        with Image.open(p) as im:      # ヘッダーだけ読むので速い
            size = im.size
        if size != TARGET:
            bad.append((p, size))
    return total, bad
 
 
if __name__ == "__main__":
    root = Path(sys.argv[1] if len(sys.argv) > 1 else "public/og")
    if not root.is_dir():
        sys.exit(f"NG: {root} がありません")      # 無音で通さない
    total, bad = check(root)
    if total == 0:
        sys.exit(f"NG: {root} に画像が 1 枚もありません")
    for p, (w, h) in bad:
        print(f"NG {p}  {w}x{h}  (期待 {TARGET[0]}x{TARGET[1]})")
    print(f"検査 {total} 枚 / 違反 {len(bad)} 枚")
    sys.exit(1 if bad else 0)

#!/usr/bin/env python3
"""横長に中央切り取りされたとき、失われる帯に文字らしい変化があるかを調べます。"""
import sys
from PIL import Image
 
CARD_RATIO = 1.91        # 横長カードの目安（幅 / 高さ）
ROW_STD_THRESHOLD = 12   # 1 行の輝度の標準偏差。背景のグラデだけならこれを超えない
 
 
def lost_rows(h: int, w: int, ratio: float = CARD_RATIO):
    keep = round(w / ratio)
    if keep >= h:
        return []
    top = (h - keep) // 2
    return list(range(0, top)) + list(range(top + keep, h))
 
 
def rows_with_content(im: Image.Image, rows):
    g = im.convert("L")
    w = g.width
    hit = []
    for y in rows:
        line = list(g.crop((0, y, w, y + 1)).tobytes())
        mean = sum(line) / w
        std = (sum((v - mean) ** 2 for v in line) / w) ** 0.5
        if std > ROW_STD_THRESHOLD:
            hit.append(y)
    return hit
 
 
if __name__ == "__main__":
    with Image.open(sys.argv[1]) as im:
        im.load()
    lost = lost_rows(im.height, im.width)
    hit = rows_with_content(im, lost)
    print(f"{im.width}x{im.height}: 切り取りで失う {len(lost)} 行 / うち文字らしい行 {len(hit)}")
    if hit:
        print(f"  最初 y={hit[0]} 最後 y={hit[-1]}")
        sys.exit(1)

#!/usr/bin/env python3
"""HTML の og:image の宣言と、指す先の実ファイルの寸法を突き合わせます。"""
import sys
from html.parser import HTMLParser
from pathlib import Path
from urllib.parse import urlparse
from PIL import Image
 
 
class Meta(HTMLParser):
    def __init__(self):
        super().__init__()
        self.m = {}
 
    def handle_starttag(self, tag, attrs):
        if tag != "meta":
            return
        a = dict(attrs)
        key = a.get("property") or a.get("name")
        if key and "content" in a:
            self.m.setdefault(key, a["content"])
 
 
def check(html_path: Path, public_dir: Path):
    p = Meta()
    p.feed(html_path.read_text(encoding="utf-8"))
    m, errs = p.m, []
    if m.get("twitter:card") != "summary_large_image":
        errs.append(f"twitter:card={m.get('twitter:card')!r}")
    url = m.get("og:image")
    if not url:
        return errs + ["og:image がありません"]
    f = public_dir / urlparse(url).path.lstrip("/")
    if not f.is_file():
        return errs + [f"実ファイルがありません: {f}"]
    with Image.open(f) as im:
        real = im.size
    decl = (int(m.get("og:image:width", 0)), int(m.get("og:image:height", 0)))
    if decl != real:
        errs.append(f"宣言 {decl} と実寸 {real} が違います")
    if real != (1200, 630):
        errs.append(f"実寸 {real} は 1200x630 ではありません")
    return errs
 
 
if __name__ == "__main__":
    html, public = Path(sys.argv[1]), Path(sys.argv[2])
    errs = check(html, public)
    for e in errs:
        print("NG", e)
    print("OK" if not errs else f"違反 {len(errs)} 件")
    sys.exit(1 if errs else 0)

{
  "scripts": {
    "check:og": "python3 scripts/og_size_check.py public/og && python3 scripts/og_lost_band.py public/og/site-ja.png && python3 scripts/og_lost_band.py public/og/site-en.png",
    "prebuild": "npm run check:og"
  }
}

# 英語のクローラーを真似て、トップページの応答コードだけ見ます
curl -s -o /dev/null -I -w "%{http_code}\n" -H "Accept-Language: en-US,en;q=0.9" https://example.com/