Проверить структуру заголовков
Показывает h1-h6 по порядку и находит пропуски уровней и пустые заголовки.
Что делает скрипт
Скрипт собирает заголовки в порядке появления и строит древовидный 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.jsonpython heading_audit.py https://example.com/ --max-length 90
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
py -m pip install requests
python3 -m pip install requests
python3 -m pip install requests
py -m pip install beautifulsoup4
python3 -m pip install beautifulsoup4
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.