Web и API

Проверить alt у изображений

Находит картинки без alt, пустые и подозрительные описания.

Python Windows macOS Linux Новичок
Скачать alt_audit.py
Описание

Что делает скрипт

Скрипт разбирает HTML и проверяет атрибут alt у каждого изображения. Отдельно отмечаются отсутствие alt, пустой alt для декоративных картинок, слишком длинный текст и описания, похожие на имя файла. Дубликаты alt помогают заметить копипаст в контенте.

Запуск

Быстрый старт

python alt_audit.py https://example.com/

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python alt_audit.py http://127.0.0.1:8000/ --json alt.json
  • python alt_audit.py https://example.com/ --max-length 100
Зависимости

Что понадобится

Python 3.10+ Интерпретатор Python
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
Python-пакет requests HTTP-клиент для Python
Windows py -m pip install requests
macOS python3 -m pip install requests
Linux python3 -m pip install requests
Python-пакет beautifulsoup4 Разбор HTML
Windows py -m pip install beautifulsoup4
macOS python3 -m pip install beautifulsoup4
Linux python3 -m pip install beautifulsoup4
Исходник

alt_audit.py

#!/usr/bin/env python3
"""Проверка alt-текстов изображений."""
from __future__ import annotations

import argparse
import json
import re
from collections import Counter
from pathlib import Path

import requests
from bs4 import BeautifulSoup

FILE_LIKE = re.compile(r"\.(png|jpe?g|gif|webp|svg|avif)$", re.IGNORECASE)


def main() -> int:
    parser = argparse.ArgumentParser(description="Проверить alt изображений")
    parser.add_argument("url", nargs="?", default="https://example.com/")
    parser.add_argument("--max-length", type=int, default=125)
    parser.add_argument("--timeout", type=float, default=15.0)
    parser.add_argument("--json", type=Path, help="Сохранить отчёт")
    args = parser.parse_args()

    try:
        response = requests.get(args.url, timeout=args.timeout, headers={"User-Agent": "popovdev-scriptdock/1.0"})
        response.raise_for_status()
    except requests.RequestException as error:
        print(f"Не удалось загрузить страницу: {error}")
        return 2

    soup = BeautifulSoup(response.content, "html.parser")
    images = soup.find_all("img")
    missing = []
    empty = []
    long_text = []
    file_like = []
    values = []
    for image in images:
        src = image.get("src", "")
        if "alt" not in image.attrs:
            missing.append(src)
            continue
        alt = (image.get("alt") or "").strip()
        if not alt:
            empty.append(src)
            continue
        values.append(alt)
        if len(alt) > args.max_length:
            long_text.append({"src": src, "alt": alt})
        if FILE_LIKE.search(alt):
            file_like.append({"src": src, "alt": alt})

    duplicates = {text: count for text, count in Counter(values).items() if count > 1}
    print(f"Изображений: {len(images)}")
    print(f"Без alt: {len(missing)}")
    print(f"Пустой alt: {len(empty)}")
    print(f"Слишком длинный alt: {len(long_text)}")
    print(f"Похоже на имя файла: {len(file_like)}")
    print(f"Повторяющихся alt: {len(duplicates)}")
    for src in missing[:10]:
        print(f"  нет alt: {src}")
    for item in long_text[:10]:
        print(f"  длинный alt ({len(item['alt'])}): {item['src']}")

    report = {
        "images": len(images),
        "missing": missing,
        "empty": empty,
        "long": long_text,
        "file_like": file_like,
        "duplicates": duplicates,
    }
    if args.json:
        args.json.write_text(json.dumps(report, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
        print(f"Отчёт: {args.json}")
    return 0 if not missing else 1


if __name__ == "__main__":
    raise SystemExit(main())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get web-alt-audit
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Web и API

HTTP, API, сайты, заголовки, SSL и проверка веб-сервисов.