سئوی فنی سایت؛ ممیزی عنوان و نشانی اصلی

این فایل را با همین نام و بدون حذف سطرها کنار بقیهٔ فایل‌ها ذخیره کنید.

from html.parser import HTMLParser
from urllib.parse import urlparse


class Audit(HTMLParser):
    def __init__(self):
        super().__init__()
        self.h1 = 0; self.canonicals = []; self.descriptions = []; self.languages = set(); self.robots = []

    def handle_starttag(self, tag, attrs):
        attrs = dict(attrs)
        if tag == 'h1': self.h1 += 1
        if tag == 'link' and attrs.get('rel') == 'canonical': self.canonicals.append(attrs.get('href', ''))
        if tag == 'link' and attrs.get('rel') == 'alternate' and attrs.get('href'): self.languages.add(attrs.get('hreflang'))
        if tag == 'meta' and attrs.get('name') == 'description': self.descriptions.append(attrs.get('content', ''))
        if tag == 'meta' and attrs.get('name') == 'robots': self.robots.append(attrs.get('content', '').lower())


def audit(source):
    parser = Audit(); parser.feed(source)
    errors = []
    if parser.h1 != 1: errors.append('expected-one-h1')
    if len(parser.descriptions) != 1 or not parser.descriptions[0].strip(): errors.append('missing-or-duplicate-description')
    if len(parser.canonicals) != 1: errors.append('expected-one-canonical')
    elif urlparse(parser.canonicals[0]).scheme != 'https' or not urlparse(parser.canonicals[0]).netloc: errors.append('canonical-must-be-absolute-https')
    if not {'fa', 'en', 'x-default'} <= parser.languages: errors.append('missing-language-alternates')
    if any('noindex' in value for value in parser.robots): errors.append('page-is-noindex')
    return errors

دستور اجرا، نتیجهٔ مورد انتظار و محدودیت این فایل در بخش اجرای مقاله توضیح داده شده است.

این فایل را با همین نام و بدون حذف سطرها کنار بقیهٔ فایل‌ها ذخیره کنید.

<!doctype html>
<html lang="fa" dir="rtl"><head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>نمونهٔ ممیزی سئوی فنی</title>
<meta name="description" content="صفحهٔ آزمایشی برای بررسی سئوی فنی؛ نشانی‌ها فقط مثال هستند.">
<meta name="robots" content="index,follow">
<link rel="canonical" href="https://example.test/article.html">
<link rel="alternate" hreflang="fa" href="https://example.test/article.html">
<link rel="alternate" hreflang="en" href="https://example.test/article-en.html">
<link rel="alternate" hreflang="x-default" href="https://example.test/article.html">
</head><body><main><h1>یک عنوان اصلی روشن</h1><p>این صفحه روی دامنهٔ نمونه منتشر نشده است.</p></main></body></html>

دستور اجرا، نتیجهٔ مورد انتظار و محدودیت این فایل در بخش اجرای مقاله توضیح داده شده است.

این فایل را با همین نام و بدون حذف سطرها کنار بقیهٔ فایل‌ها ذخیره کنید.

import json
from pathlib import Path
import sys
from audit_seo import audit

if __name__ == '__main__':
    paths = [Path(name) for name in sys.argv[1:]] or [Path(__file__).with_name('demo.html')]
    failed = False
    for path in paths:
        errors = audit(path.read_text(encoding='utf-8'))
        print(json.dumps({'file': str(path), 'errors': errors}))
        failed |= bool(errors)
    raise SystemExit(1 if failed else 0)

دستور اجرا، نتیجهٔ مورد انتظار و محدودیت این فایل در بخش اجرای مقاله توضیح داده شده است.

این فایل را با همین نام و بدون حذف سطرها کنار بقیهٔ فایل‌ها ذخیره کنید.

from pathlib import Path
import unittest
from audit_seo import audit


class AuditTests(unittest.TestCase):
    def setUp(self):
        self.page = Path(__file__).with_name('demo.html').read_text(encoding='utf-8')

    def test_valid_and_duplicate_titles(self):
        self.assertEqual(audit(self.page), [])
        self.assertIn('expected-one-h1', audit(self.page.replace('</main>', '<h1>Duplicate</h1></main>')))

    def test_accidental_noindex_and_relative_canonical(self):
        self.assertIn('page-is-noindex', audit(self.page.replace('index,follow', 'noindex,follow')))
        broken = self.page.replace('rel="canonical" href="https://example.test/article.html"', 'rel="canonical" href="article.html"')
        self.assertIn('canonical-must-be-absolute-https', audit(broken))


if __name__ == '__main__': unittest.main()

دستور اجرا، نتیجهٔ مورد انتظار و محدودیت این فایل در بخش اجرای مقاله توضیح داده شده است.