大好きなカーズのキャラクター125体以上の画像をAPIで一括収集してみた

#!/usr/bin/env python3
"""
カーズ シリーズ キャラクター画像URL収集・ダウンロードスクリプト
 
使い方:
  python collect_images.py              # 画像URLの収集のみ（CSV出力）
  python collect_images.py --download   # 画像URLの収集 + ダウンロード
"""
 
import csv
import json
import os
import time
import urllib.error
import urllib.parse
import urllib.request
from pathlib import Path
 
# 設定
WIKI_API_URL = "https://pixarcars.fandom.com/api.php"
OUTPUT_CSV = "characters_images.csv"
REQUEST_DELAY = 1.0  # リクエスト間のスリープ（秒）
USER_AGENT = "CarsCharacterImageCollector/1.0 (Personal Research)"

CHARACTERS = [
    # --- カーズ（2006年）---
    ("ライトニング・マックィーン", "Lightning McQueen", "カーズ"),
    ("マック", "Mack", "カーズ"),
    ("メーター", "Mater", "カーズ"),
    ("サリー・カレラ", "Sally Carrera", "カーズ"),
    ("ドック・ハドソン", "Doc Hudson", "カーズ"),
    # ... 以下省略（全125体以上）
 
    # --- カーズ2（2011年）---
    ("フィン・マックミサイル", "Finn McMissile", "カーズ2"),
    ("ホリー・シフトウェル", "Holley Shiftwell", "カーズ2"),
    # ...
 
    # --- カーズ/クロスロード（2017年）---
    ("クルーズ・ラミレス", "Cruz Ramirez", "カーズ3"),
    ("ジャクソン・ストーム", "Jackson Storm", "カーズ3"),
    # ...
]

def make_api_request(params: dict) -> dict:
    """Fandom MediaWiki APIにリクエストを送信する"""
    params["format"] = "json"
    url = f"{WIKI_API_URL}?{urllib.parse.urlencode(params)}"
    req = urllib.request.Request(url, headers={"User-Agent": USER_AGENT})
    try:
        with urllib.request.urlopen(req, timeout=15) as response:
            return json.loads(response.read().decode("utf-8"))
    except (urllib.error.URLError, urllib.error.HTTPError) as e:
        print(f"  [エラー] APIリクエスト失敗: {e}")
        return {}

def get_page_image_url(page_title: str) -> tuple[str, str]:
    """Wikiページのメイン画像URLを取得する"""
 
    # 1. pageimagesプロパティでサムネイル画像を取得
    data = make_api_request({
        "action": "query",
        "titles": page_title,
        "prop": "pageimages|info",
        "piprop": "original",
        "inprop": "url",
        "redirects": "1",
    })
 
    # ページが見つかった場合 → 画像URLを返す
    # ページが見つからない場合 → 検索APIにフォールバック
    # 画像がない場合 → ページ内画像一覧から探す

def search_and_get_image(search_term: str) -> tuple[str, str]:
    """検索APIでページを探してから画像を取得する"""
    data = make_api_request({
        "action": "query",
        "list": "search",
        "srsearch": search_term,
        "srlimit": "1",
    })
    # 見つかったページの画像を取得...

def get_first_image_from_page(page_title: str, page_url: str):
    data = make_api_request({
        "action": "query",
        "titles": page_title,
        "prop": "images",
        "imlimit": "10",
    })
 
    for img in images:
        # ユーティリティ画像を除外
        skip_keywords = [
            "Wiki", "Logo", "Icon", "Favicon",
            "Banner", "Placeholder", "Template",
        ]
        if any(kw.lower() in img_title.lower() for kw in skip_keywords):
            continue
        # 画像のURLを取得して返す

REQUEST_DELAY = 1.0
 
# メインループ内
for i, (ja_name, en_name, movie) in enumerate(CHARACTERS, 1):
    image_url, wiki_url = get_page_image_url(en_name)
    # ... 処理 ...
    if i < total:
        time.sleep(REQUEST_DELAY)  # サーバーへの負荷軽減

$ python collect_images.py --download
 
=== カーズ キャラクター画像URL収集 ===
対象キャラクター数: 125
APIエンドポイント: https://pixarcars.fandom.com/api.php
出力CSV: characters_images.csv
 
[1/125] ライトニング・マックィーン (Lightning McQueen) ... OK
  -> ダウンロード完了: images/Lightning McQueen.png
[2/125] マック (Mack) ... OK
  -> ダウンロード完了: images/Mack.png
[3/125] ストリップ・ウェザーズ（キング） (Strip Weathers) ... OK
  -> ダウンロード完了: images/Strip Weathers.png
...
 
=== 結果サマリー ===
  取得成功:         125/125
  画像なし:         0/125
  ページなし:       0/125
  ダウンロード完了: 125/125
 
完了しました。

skip_keywords = [
    "Wiki", "Logo", "Icon", "Favicon",
    "Banner", "Placeholder", "Template",
]

USER_AGENT = "CarsCharacterImageCollector/1.0 (Personal Research)"

# URLの収集のみ（CSV出力）
python collect_images.py
 
# URL収集 + 画像ダウンロード
python collect_images.py --download