+"""
+
+import re
+import logging
+from bs4 import BeautifulSoup
+
+log = logging.getLogger(__name__)
+
+
+def count_pages(soup: BeautifulSoup, per_page: int) -> int:
+ """Определить количество страниц в пагинации phpBB.
+
+ Алгоритм:
+ 1. Ищем ul.pagination (или ul.page-nav).
+ 2. Собираем все start=N из href.
+ 3. Находим max_start.
+ 4. Вычисляем: pages = max_start / per_page + 1.
+
+ Args:
+ soup: BeautifulSoup страницы раздела или темы.
+ per_page: Количество элементов на странице (темы=25, посты=10).
+
+ Returns:
+ int: количество страниц (минимум 1).
+ """
+ # Ищем контейнер пагинации (два варианта класса)
+ nav = soup.find("ul", class_="pagination")
+ if nav is None:
+ nav = soup.find("ul", class_="page-nav")
+ if nav is None:
+ return 1
+
+ # Собираем все start=N из ссылок
+ starts = set()
+ for link in nav.select("a"):
+ href = link.get("href", "")
+ match = re.search(r"[?&]start=(\d+)", href)
+ if match:
+ starts.add(int(match.group(1)))
+
+ if not starts:
+ return 1
+
+ max_start = max(starts)
+ pages = (max_start // per_page) + 1
+ return pages
+
+
+def page_url(base_url: str, page_num: int, per_page: int) -> str:
+ """Сформировать URL страницы раздела phpBB.
+
+ Формат:
+ page=1 → base_url (без ?start=)
+ page>1 → base_url + &start=N
+
+ Args:
+ base_url: URL страницы без параметра start (напр. viewforum.php?f=22).
+ page_num: Номер страницы (1-based).
+ per_page: Количество элементов на страницу.
+
+ Returns:
+ str: URL страницы с ?start= (если page>1).
+ """
+ if page_num <= 1:
+ return base_url
+
+ start = (page_num - 1) * per_page
+ separator = "&" if "?" in base_url else "?"
+ return f"{base_url}{separator}start={start}"
+
+
+def topic_page_url(topic_url: str, page_num: int, per_page: int) -> str:
+ """Сформировать URL страницы темы phpBB.
+
+ Args:
+ topic_url: Полный URL темы.
+ page_num: Номер страницы (1-based, начиная с 2).
+ per_page: Количество постов на страницу.
+
+ Returns:
+ str: URL страницы темы с ?start=.
+ """
+ if page_num <= 1:
+ return topic_url
+
+ start = (page_num - 1) * per_page
+ separator = "&" if "?" in topic_url else "?"
+ return f"{topic_url}{separator}start={start}"
diff --git a/scraper/forums/phpbb/parse.py b/scraper/forums/phpbb/parse.py
new file mode 100644
index 0000000..5241a6e
--- /dev/null
+++ b/scraper/forums/phpbb/parse.py
@@ -0,0 +1,142 @@
+"""Парсинг HTML форума phpBB (subsilver2, нива-лада.рф).
+
+Структуры:
+
+Список тем в разделе (subsilver2):
+ Заголовок
+
+Пост в теме (табличная вёрстка subsilver2):
+
← строка: автор + дата
+
Автор
+
+
+ Добавлено: 12 авг 2025, 20:00
+
+
+
+
← строка: аватар + текст
+
...
+
текст поста
+
+"""
+
+import re
+import logging
+from bs4 import BeautifulSoup
+
+log = logging.getLogger(__name__)
+
+
+def parse_topics(soup: BeautifulSoup) -> list[dict]:
+ """Распарсить список тем со страницы раздела phpBB.
+
+ Ищем все a.topictitle → из href вытаскиваем t=ID.
+
+ Args:
+ soup: BeautifulSoup страницы раздела.
+
+ Returns:
+ list[dict]: [{id, title, url}].
+ url может быть None (будет сформирован адаптером).
+ """
+ items = []
+
+ for link in soup.select("a.topictitle"):
+ href = link.get("href", "")
+
+ # Из href вытаскиваем t=ID
+ match = re.search(r"[?&]t=(\d+)", href)
+ if match is None:
+ continue
+
+ topic_id = int(match.group(1))
+ title = link.text.strip()
+
+ items.append({
+ "id": topic_id,
+ "title": title,
+ "url": None, # адаптер сформирует сам
+ })
+
+ return items
+
+
+def parse_posts(soup: BeautifulSoup) -> list[dict]:
+ """Распарсить посты со страницы темы phpBB (subsilver2).
+
+ Каждый пост — это 3
в таблице. Ищем b.postauthor
+ как маркер начала поста, затем:
+ - Тот же
: дата из "Добавлено:"
+ - Следующий
: текст из div.postbody
+
+ Args:
+ soup: BeautifulSoup страницы темы.
+
+ Returns:
+ list[dict]: [{author, date, num, text}, ...].
+ """
+ posts = []
+ post_num = 0
+
+ for author_tag in soup.select("b.postauthor"):
+ post_num += 1
+ author = author_tag.text.strip()
+
+ # ── Дата: ищем "Добавлено:" в том же
───────────────────────
+ date = ""
+ header_row = author_tag.find_parent("tr")
+ if header_row is not None:
+ date_cell = header_row.select_one("td[width='100%']")
+ if date_cell is not None:
+ date_text = date_cell.get_text(" ", strip=True)
+ date_match = re.search(r"Добавлено:\s*(.+)", date_text)
+ if date_match:
+ date = date_match.group(1).strip()
+
+ # ── Текст: ищем div.postbody в следующем
───────────────────
+ text = ""
+ if header_row is not None:
+ body_row = header_row.find_next_sibling("tr")
+ if body_row is not None:
+ body_div = body_row.select_one("div.postbody")
+ if body_div is not None:
+ text = body_div.get_text("\n", strip=True)
+
+ posts.append({
+ "author": author,
+ "date": date,
+ "num": f"#{post_num}",
+ "text": text,
+ })
+
+ return posts
+
+
+def parse_section_name(soup: BeautifulSoup) -> str | None:
+ """Извлечь название раздела из заголовка phpBB.
+
+ phpBB обычно показывает название в h2 или в breadcrumbs.
+
+ Args:
+ soup: BeautifulSoup страницы раздела.
+
+ Returns:
+ str | None: название раздела.
+ """
+ # Пробуем h2 (основной заголовок страницы)
+ h2 = soup.select_one("h2")
+ if h2 is not None:
+ text = h2.text.strip()
+ if text:
+ return text
+
+ # Пробуем title страницы
+ title_tag = soup.select_one("title")
+ if title_tag is not None:
+ text = title_tag.text.strip()
+ # Чистим от названия сайта
+ text = re.sub(r"\s*–\s*.*$", "", text).strip()
+ if text:
+ return text
+
+ return None
diff --git a/scraper/forums/xenforo/__init__.py b/scraper/forums/xenforo/__init__.py
new file mode 100644
index 0000000..c7e672a
--- /dev/null
+++ b/scraper/forums/xenforo/__init__.py
@@ -0,0 +1 @@
+# scraper.forums.xenforo — адаптер для форумов на XenForo (vwts.ru)
diff --git a/scraper/forums/xenforo/adapter.py b/scraper/forums/xenforo/adapter.py
new file mode 100644
index 0000000..bea18b9
--- /dev/null
+++ b/scraper/forums/xenforo/adapter.py
@@ -0,0 +1,146 @@
+"""Адаптер для форумов на XenForo (vwts.ru).
+
+Настройки:
+ data_dir: куда сохранять данные (по умолчанию ./vwts_data).
+ delay: 1.5 сек между запросами.
+ ban_test: 5 быстрых запросов для проверки бана.
+ topics_file: 100 тем на один JSONL-файл.
+"""
+
+from pathlib import Path
+
+from ..base import BaseAdapter
+from . import paginate, parse
+
+
+class XenForoAdapter(BaseAdapter):
+ """Адаптер для форума XenForo (vwts.ru).
+
+ Использует модули paginate.py и parse.py из этого пакета.
+ """
+
+ def __init__(self, data_dir: str | Path = "vwts_data"):
+ """Инициализация.
+
+ Args:
+ data_dir: Путь к папке с данными (строка или Path).
+ """
+ self._data_dir = Path(data_dir)
+
+ # ─── Атрибуты конфигурации ──────────────────────────────────────────
+
+ @property
+ def data_dir(self) -> Path:
+ return self._data_dir
+
+ @property
+ def delay(self) -> float:
+ return 1.5
+
+ @property
+ def ban_test_count(self) -> int:
+ return 5
+
+ @property
+ def topics_per_file(self) -> int:
+ return 100
+
+ # ─── Пагинация ──────────────────────────────────────────────────────
+
+ def count_pages(self, soup) -> int:
+ """Количество страниц в разделе/теме XenForo.
+
+ Args:
+ soup: BeautifulSoup первой страницы.
+
+ Returns:
+ int: количество страниц.
+ """
+ return paginate.count_pages(soup)
+
+ def page_url(self, section_url: str, page_num: int) -> str:
+ """URL страницы раздела XenForo.
+
+ Args:
+ section_url: URL раздела (первая страница).
+ page_num: Номер страницы.
+
+ Returns:
+ str: URL страницы.
+ """
+ return paginate.page_url(section_url, page_num)
+
+ def topic_url(self, section_url: str, topic: dict) -> str:
+ """Полный URL темы XenForo.
+
+ Приоритет: topic['url'] (если есть),
+ иначе формируем из ID.
+
+ Args:
+ section_url: URL раздела (не используется в XenForo).
+ topic: Словарь темы.
+
+ Returns:
+ str: полный URL темы.
+ """
+ if topic.get("url"):
+ return topic["url"]
+ return f"https://vwts.ru/forum/topic/{topic['id']}/"
+
+ def topic_page_url(self, topic_url: str, page_num: int) -> str:
+ """URL страницы внутри темы XenForo.
+
+ Args:
+ topic_url: Полный URL темы.
+ page_num: Номер страницы.
+
+ Returns:
+ str: URL страницы темы.
+ """
+ return paginate.topic_page_url(topic_url, page_num)
+
+ # ─── Парсинг ────────────────────────────────────────────────────────
+
+ def parse_section_name(self, soup) -> str | None:
+ """Название раздела из h1.
+
+ Args:
+ soup: BeautifulSoup страницы раздела.
+
+ Returns:
+ str | None: название раздела.
+ """
+ return parse.parse_section_name(soup)
+
+ def parse_topics(self, soup) -> list[dict]:
+ """Список тем со страницы раздела.
+
+ Args:
+ soup: BeautifulSoup страницы раздела.
+
+ Returns:
+ list[dict]: [{id, title, url}].
+ """
+ return parse.parse_topics(soup)
+
+ def parse_posts(self, soup) -> list[dict]:
+ """Список постов со страницы темы.
+
+ Args:
+ soup: BeautifulSoup страницы темы.
+
+ Returns:
+ list[dict]: [{author, date, num, text}].
+ """
+ return parse.parse_posts(soup)
+
+ def parse_tags(self, soup) -> list[str]:
+ """Теги темы XenForo.
+
+ Args:
+ soup: BeautifulSoup страницы темы.
+
+ Returns:
+ list[str]: теги (может быть пусто).
+ """
+ return parse.parse_tags(soup)
diff --git a/scraper/forums/xenforo/paginate.py b/scraper/forums/xenforo/paginate.py
new file mode 100644
index 0000000..0ce366f
--- /dev/null
+++ b/scraper/forums/xenforo/paginate.py
@@ -0,0 +1,109 @@
+"""Пагинация XenForo (vwts.ru и другие форумы на XenForo).
+
+Страницы раздела: /forum/vag/benzinovye-dvigateli/page-2
+Страницы темы: /forum/topic/12345/page-2
+
+HTML-структура пагинации:
+