Web и API

Проверить структуру заголовков

Показывает h1-h6 по порядку и находит пропуски уровней и пустые заголовки.

Python Windows macOS Linux Средний
Скачать heading_audit.py
Описание

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

Скрипт собирает заголовки в порядке появления и строит древовидный outline. Он проверяет наличие единственного h1, пропуски уровней, пустые заголовки и слишком длинный текст. Это базовая проверка структуры страницы для SEO и доступности.

Запуск

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

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

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

Примеры

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

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

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

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
Исходник

heading_audit.py

#!/usr/bin/env python3
"""Проверка иерархии заголовков страницы."""
from __future__ import annotations

import argparse
import json
from pathlib import Path

import requests
from bs4 import BeautifulSoup


def main() -> int:
    parser = argparse.ArgumentParser(description="Проверить заголовки")
    parser.add_argument("url", nargs="?", default="https://example.com/")
    parser.add_argument("--max-length", type=int, default=90)
    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")
    headings = []
    for tag in soup.find_all(["h1", "h2", "h3", "h4", "h5", "h6"]):
        text = " ".join(tag.get_text(" ", strip=True).split())
        headings.append({"level": int(tag.name[1]), "text": text, "id": tag.get("id")})

    problems = []
    h1_count = sum(1 for item in headings if item["level"] == 1)
    if h1_count == 0:
        problems.append("нет ни одного h1")
    elif h1_count > 1:
        problems.append(f"несколько h1: {h1_count}")

    previous = 0
    for item in headings:
        level = item["level"]
        if previous and level > previous + 1:
            problems.append(f"пропуск уровня: h{previous} -> h{level} ({item['text'][:40]})")
        if not item["text"]:
            problems.append(f"пустой h{level}")
        elif len(item["text"]) > args.max_length:
            problems.append(f"длинный h{level}: {len(item['text'])} символов")
        previous = level

    for item in headings:
        print(f"{'  ' * (item['level'] - 1)}h{item['level']}: {item['text'][:80]}")
    print(f"Всего заголовков: {len(headings)}, h1: {h1_count}")
    if problems:
        print("Замечания:")
        for problem in problems:
            print(f"  - {problem}")

    if args.json:
        report = {"url": args.url, "headings": headings, "problems": problems}
        args.json.write_text(json.dumps(report, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
        print(f"Отчёт: {args.json}")
    return 0 if h1_count == 1 and not any("пропуск" in item or "пустой" in item for item in problems) else 1


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

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

CLI 1.0.0

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

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

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

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

Категория

Web и API

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