udzialy-bot 2.1.0__tar.gz

udzialy_bot-2.1.0/LICENSE

@@ -0,0 +1,13 @@
+Udzialy Bot - Wyszukiwarka Udzialow
+Copyright (c) 2024-2026 QA10 sp. z o.o.
+Wszelkie prawa zastrzezone / All rights reserved.
+
+To oprogramowanie jest licencjonowane wylacznie do uzytku osobistego.
+Redystrybucja, modyfikacja i wykorzystanie komercyjne bez pisemnej
+zgody QA10 sp. z o.o. jest zabronione.
+
+This software is licensed for personal use only.
+Redistribution, modification and commercial use without written
+permission from QA10 sp. z o.o. is prohibited.
+
+Kontakt / Contact: kontakt@qa10.pl

udzialy_bot-2.1.0/PKG-INFO

@@ -0,0 +1,169 @@
+Metadata-Version: 2.4
+Name: udzialy-bot
+Version: 2.1.0
+Summary: Bot do wyszukiwania ogłoszeń sprzedaży udziałów w nieruchomościach
+Author-email: "QA10 sp. z o.o." <hello@qa10.io>
+License: MIT
+Keywords: telegram,bot,real-estate,scraping,poland,udzialy
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Chat
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiogram>=3.10
+Requires-Dist: aiosqlite>=0.19.0
+Requires-Dist: httpx[http2,socks]>=0.27.0
+Requires-Dist: selectolax>=0.3.21
+Requires-Dist: curl_cffi>=0.7.0
+Requires-Dist: primp>=0.6.0
+Requires-Dist: nodriver>=0.35
+Requires-Dist: patchright>=1.43
+Requires-Dist: stem>=1.8.2
+Requires-Dist: PySocks>=1.7.1
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: pydantic>=2.7.0
+Requires-Dist: pydantic-settings>=2.3.0
+Requires-Dist: pyyaml>=6.0.1
+Dynamic: license-file
+
+# 🏠 Udziały Bot
+
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![aiogram 3.x](https://img.shields.io/badge/aiogram-3.x-green.svg)](https://docs.aiogram.dev/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Platform: Windows](https://img.shields.io/badge/platform-Windows-lightgrey.svg)]()
+
+**Telegram bot do wyszukiwania ogłoszeń sprzedaży udziałów w nieruchomościach** na 9 polskich portalach ogłoszeniowych.
+
+Bot automatycznie przeszukuje portale nieruchomości w poszukiwaniu ofert sprzedaży udziałów (ułamkowych części własności) i prezentuje wyniki bezpośrednio w Telegramie.
+
+---
+
+## ✨ Funkcje
+
+- 🔍 Przeszukiwanie 9 portali nieruchomości jednocześnie
+- 🗺️ Filtrowanie po województwie, mieście, promieniu i cenie
+- 📄 Paginacja wyników z klawiaturą inline
+- 💾 Zapisywanie interesujących ogłoszeń
+- 🛡️ Rotacja proxy przez Tor dla anonimowości
+- ⚡ Asynchroniczne scrapowanie (httpx, curl_cffi, nodriver)
+- 🧠 FSM do konfiguracji filtrów krok po kroku
+- 🚦 Anti-flood middleware
+
+## 📋 Wymagania
+
+- Python 3.11 lub nowszy
+- Windows 10/11 (skrypty .bat)
+- Konto Telegram + token bota z [@BotFather](https://t.me/BotFather)
+
+## 🚀 Instalacja (Windows)
+
+### Automatyczna (zalecana)
+
+1. Sklonuj repozytorium:
+   ```cmd
+   git clone https://github.com/your-user/udzialy-bot.git
+   cd udzialy-bot
+   ```
+
+2. Uruchom instalator:
+   ```cmd
+   install.bat
+   ```
+   Skrypt automatycznie:
+   - Sprawdzi wersję Pythona
+   - Utworzy środowisko wirtualne (venv)
+   - Zainstaluje zależności
+   - Pobierze Tor Expert Bundle
+   - Zainstaluje przeglądarki Playwright
+
+3. Skonfiguruj bota — edytuj `config.yaml`:
+   ```yaml
+   telegram:
+     token: "YOUR_BOT_TOKEN_HERE"
+     owner_id: 123456789
+   ```
+
+### Ręczna
+
+```cmd
+python -m venv .venv
+.venv\Scripts\activate
+pip install -r requirements.txt
+playwright install chromium
+```
+
+## ▶️ Uruchomienie
+
+```cmd
+start_bot.bat
+```
+
+Lub ręcznie:
+```cmd
+.venv\Scripts\activate
+python -m bot.main
+```
+
+## 🎮 Komendy bota
+
+| Komenda | Opis |
+|---------|------|
+| `/start` | Powitanie i menu główne |
+| `/search` | Rozpocznij nowe wyszukiwanie |
+| `/filters` | Ustaw filtry (województwo, miasto, cena) |
+| `/saved` | Pokaż zapisane ogłoszenia |
+| `/settings` | Ustawienia użytkownika |
+| `/help` | Pomoc |
+
+## 📁 Struktura projektu
+
+```
+udzialy-bot/
+├── bot/
+│   ├── __init__.py
+│   ├── main.py              # Entry point, dispatcher
+│   ├── config.py            # Pydantic Settings
+│   ├── routers/
+│   │   ├── __init__.py      # Router registration
+│   │   ├── search.py        # /search command
+│   │   ├── results.py       # Pagination
+│   │   ├── filters.py       # FSM filters
+│   │   ├── saved.py         # Saved listings
+│   │   └── settings.py      # User settings
+│   ├── keyboards/
+│   │   ├── __init__.py
+│   │   ├── inline.py        # Inline keyboards
+│   │   └── reply.py         # Reply keyboards
+│   └── middlewares/
+│       ├── __init__.py
+│       └── throttle.py      # Anti-flood
+├── config.yaml              # Configuration
+├── requirements.txt         # Dependencies
+├── pyproject.toml           # Project metadata
+├── install.bat              # Windows installer
+├── start_bot.bat            # Windows launcher
+├── .gitignore
+└── README.md
+```
+
+## ⚙️ Konfiguracja
+
+Plik `config.yaml` zawiera pełną konfigurację bota. Wartości można nadpisać zmiennymi środowiskowymi z prefiksem `UDZIALY_`.
+
+## 🔒 Bezpieczeństwo
+
+- Bot działa w trybie single-user (tylko owner_id)
+- Tor zapewnia anonimowość przy scrapowaniu
+- Rotacja User-Agent i fingerprint
+- Rate limiting na portalach
+
+## 📄 Licencja
+
+MIT License — do użytku osobistego.

udzialy_bot-2.1.0/README.md

@@ -0,0 +1,135 @@
+# 🏠 Udziały Bot
+
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![aiogram 3.x](https://img.shields.io/badge/aiogram-3.x-green.svg)](https://docs.aiogram.dev/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Platform: Windows](https://img.shields.io/badge/platform-Windows-lightgrey.svg)]()
+
+**Telegram bot do wyszukiwania ogłoszeń sprzedaży udziałów w nieruchomościach** na 9 polskich portalach ogłoszeniowych.
+
+Bot automatycznie przeszukuje portale nieruchomości w poszukiwaniu ofert sprzedaży udziałów (ułamkowych części własności) i prezentuje wyniki bezpośrednio w Telegramie.
+
+---
+
+## ✨ Funkcje
+
+- 🔍 Przeszukiwanie 9 portali nieruchomości jednocześnie
+- 🗺️ Filtrowanie po województwie, mieście, promieniu i cenie
+- 📄 Paginacja wyników z klawiaturą inline
+- 💾 Zapisywanie interesujących ogłoszeń
+- 🛡️ Rotacja proxy przez Tor dla anonimowości
+- ⚡ Asynchroniczne scrapowanie (httpx, curl_cffi, nodriver)
+- 🧠 FSM do konfiguracji filtrów krok po kroku
+- 🚦 Anti-flood middleware
+
+## 📋 Wymagania
+
+- Python 3.11 lub nowszy
+- Windows 10/11 (skrypty .bat)
+- Konto Telegram + token bota z [@BotFather](https://t.me/BotFather)
+
+## 🚀 Instalacja (Windows)
+
+### Automatyczna (zalecana)
+
+1. Sklonuj repozytorium:
+   ```cmd
+   git clone https://github.com/your-user/udzialy-bot.git
+   cd udzialy-bot
+   ```
+
+2. Uruchom instalator:
+   ```cmd
+   install.bat
+   ```
+   Skrypt automatycznie:
+   - Sprawdzi wersję Pythona
+   - Utworzy środowisko wirtualne (venv)
+   - Zainstaluje zależności
+   - Pobierze Tor Expert Bundle
+   - Zainstaluje przeglądarki Playwright
+
+3. Skonfiguruj bota — edytuj `config.yaml`:
+   ```yaml
+   telegram:
+     token: "YOUR_BOT_TOKEN_HERE"
+     owner_id: 123456789
+   ```
+
+### Ręczna
+
+```cmd
+python -m venv .venv
+.venv\Scripts\activate
+pip install -r requirements.txt
+playwright install chromium
+```
+
+## ▶️ Uruchomienie
+
+```cmd
+start_bot.bat
+```
+
+Lub ręcznie:
+```cmd
+.venv\Scripts\activate
+python -m bot.main
+```
+
+## 🎮 Komendy bota
+
+| Komenda | Opis |
+|---------|------|
+| `/start` | Powitanie i menu główne |
+| `/search` | Rozpocznij nowe wyszukiwanie |
+| `/filters` | Ustaw filtry (województwo, miasto, cena) |
+| `/saved` | Pokaż zapisane ogłoszenia |
+| `/settings` | Ustawienia użytkownika |
+| `/help` | Pomoc |
+
+## 📁 Struktura projektu
+
+```
+udzialy-bot/
+├── bot/
+│   ├── __init__.py
+│   ├── main.py              # Entry point, dispatcher
+│   ├── config.py            # Pydantic Settings
+│   ├── routers/
+│   │   ├── __init__.py      # Router registration
+│   │   ├── search.py        # /search command
+│   │   ├── results.py       # Pagination
+│   │   ├── filters.py       # FSM filters
+│   │   ├── saved.py         # Saved listings
+│   │   └── settings.py      # User settings
+│   ├── keyboards/
+│   │   ├── __init__.py
+│   │   ├── inline.py        # Inline keyboards
+│   │   └── reply.py         # Reply keyboards
+│   └── middlewares/
+│       ├── __init__.py
+│       └── throttle.py      # Anti-flood
+├── config.yaml              # Configuration
+├── requirements.txt         # Dependencies
+├── pyproject.toml           # Project metadata
+├── install.bat              # Windows installer
+├── start_bot.bat            # Windows launcher
+├── .gitignore
+└── README.md
+```
+
+## ⚙️ Konfiguracja
+
+Plik `config.yaml` zawiera pełną konfigurację bota. Wartości można nadpisać zmiennymi środowiskowymi z prefiksem `UDZIALY_`.
+
+## 🔒 Bezpieczeństwo
+
+- Bot działa w trybie single-user (tylko owner_id)
+- Tor zapewnia anonimowość przy scrapowaniu
+- Rotacja User-Agent i fingerprint
+- Rate limiting na portalach
+
+## 📄 Licencja
+
+MIT License — do użytku osobistego.

udzialy_bot-2.1.0/bot/__init__.py

@@ -0,0 +1,7 @@
+"""
+Udziały Bot — Telegram bot for scraping Polish real estate portals
+for property share (udział w nieruchomości) listings.
+"""
+
+__version__ = "0.1.0"
+__app_name__ = "udzialy-bot"

udzialy_bot-2.1.0/bot/__main__.py

@@ -0,0 +1,3 @@
+from bot.main import main
+
+main()

udzialy_bot-2.1.0/bot/config.py

@@ -0,0 +1,191 @@
+"""
+Bot configuration — loads config.yaml relative to project root.
+
+Exposes a Settings dataclass with: telegram_token, owner_id, portals dict,
+tor config, scraping timeouts. Uses pydantic-settings with YAML source.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any, Dict
+
+import yaml
+from pydantic import BaseModel, Field
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+
+# --- Project root detection ---
+
+def _find_project_root() -> Path:
+    """Find project root by looking for config.yaml upward from this file."""
+    current = Path(__file__).resolve().parent  # bot/
+    for parent in [current.parent, current.parent.parent, Path.cwd()]:
+        if (parent / "config.yaml").exists():
+            return parent
+    # Fallback: assume CWD is project root
+    return Path.cwd()
+
+
+PROJECT_ROOT = _find_project_root()
+
+
+# --- Sub-models ---
+
+class TelegramConfig(BaseModel):
+    """Telegram bot settings."""
+    token: str = "YOUR_BOT_TOKEN_HERE"
+    owner_id: int = 0
+
+
+class PortalEntry(BaseModel):
+    """Single portal configuration."""
+    enabled: bool = True
+    base_url: str = ""
+
+
+class PortalsConfig(BaseModel):
+    """All portal switches — dynamic dict of portal entries."""
+    model_config = {"extra": "allow"}
+
+    otodom: PortalEntry = PortalEntry()
+    olx: PortalEntry = PortalEntry()
+    gratka: PortalEntry = PortalEntry()
+    morizon: PortalEntry = PortalEntry()
+    nieruchomosci_online: PortalEntry = PortalEntry()
+    domiporta: PortalEntry = PortalEntry()
+    lento: PortalEntry = PortalEntry()
+    gethome: PortalEntry = PortalEntry()
+    ogloszenia24: PortalEntry = PortalEntry(enabled=False)
+
+    def enabled_portals(self) -> list[str]:
+        """Return list of enabled portal names."""
+        result = []
+        for name in self.model_fields:
+            entry = getattr(self, name, None)
+            if isinstance(entry, PortalEntry) and entry.enabled:
+                result.append(name)
+        return result
+
+    def as_dict(self) -> Dict[str, Dict[str, Any]]:
+        """Return portals as plain dict."""
+        result = {}
+        for name in self.model_fields:
+            entry = getattr(self, name, None)
+            if isinstance(entry, PortalEntry):
+                result[name] = {"enabled": entry.enabled, "base_url": entry.base_url}
+        return result
+
+
+class ScrapingConfig(BaseModel):
+    """Scraping behavior settings."""
+    timeout: int = 30
+    max_concurrent: int = 3
+    retry_count: int = 2
+    retry_delay: int = 5
+    delay_between: int = 2
+    user_agent_rotate: bool = True
+
+
+class TorConfig(BaseModel):
+    """Tor proxy settings."""
+    enabled: bool = True
+    socks_port: int = 9050
+    control_port: int = 9051
+    control_password: str = "udzialy2026"
+    circuit_rotate_interval: int = 300
+    binary_path: str = "tor/tor.exe"
+
+    @property
+    def proxy_url(self) -> str:
+        """SOCKS5 proxy URL for httpx."""
+        return f"socks5://127.0.0.1:{self.socks_port}"
+
+
+class DatabaseConfig(BaseModel):
+    """Database settings."""
+    path: str = "data/udzialy.db"
+
+
+class LLMConfig(BaseModel):
+    """LLM analysis settings (optional)."""
+    enabled: bool = False
+    provider: str = "openai"  # openai, anthropic, local
+    api_key: str = ""
+    model: str = "gpt-4o-mini"
+    base_url: str = "https://api.openai.com/v1"
+    max_concurrent: int = 5
+    timeout: int = 15
+
+
+class LoggingConfig(BaseModel):
+    """Logging settings."""
+    level: str = "INFO"
+    file: str = "data/bot.log"
+
+
+# --- Main Settings ---
+
+class Settings(BaseSettings):
+    """
+    Application settings loaded from config.yaml + environment variables.
+
+    Environment variables override YAML values with prefix UDZIALY_.
+    Example: UDZIALY_TELEGRAM__TOKEN=xxx overrides telegram.token.
+    """
+
+    model_config = SettingsConfigDict(
+        env_prefix="UDZIALY_",
+        env_nested_delimiter="__",
+        case_sensitive=False,
+    )
+
+    telegram: TelegramConfig = TelegramConfig()
+    portals: PortalsConfig = PortalsConfig()
+    scraping: ScrapingConfig = ScrapingConfig()
+    tor: TorConfig = TorConfig()
+    database: DatabaseConfig = DatabaseConfig()
+    llm: LLMConfig = LLMConfig()
+    logging: LoggingConfig = LoggingConfig()
+
+    # Convenience properties
+    @property
+    def telegram_token(self) -> str:
+        return self.telegram.token
+
+    @property
+    def owner_id(self) -> int:
+        return self.telegram.owner_id
+
+    @classmethod
+    def from_yaml(cls, path: str | Path | None = None) -> "Settings":
+        """Load settings from YAML file, then apply env var overrides."""
+        if path is None:
+            path = PROJECT_ROOT / "config.yaml"
+        config_path = Path(path)
+        yaml_data: dict[str, Any] = {}
+
+        if config_path.exists():
+            with open(config_path, "r", encoding="utf-8") as f:
+                yaml_data = yaml.safe_load(f) or {}
+
+        return cls(**yaml_data)
+
+
+# --- Singleton ---
+
+_settings: Settings | None = None
+
+
+def get_settings(config_path: str | Path | None = None) -> Settings:
+    """Get or create settings singleton."""
+    global _settings
+    if _settings is None:
+        _settings = Settings.from_yaml(config_path)
+    return _settings
+
+
+def reset_settings() -> None:
+    """Reset singleton (for testing)."""
+    global _settings
+    _settings = None

udzialy_bot-2.1.0/bot/keyboards/__init__.py

@@ -0,0 +1,27 @@
+"""
+Keyboards package — inline and reply keyboard builders.
+"""
+
+from bot.keyboards.inline import (
+    build_results_keyboard,
+    build_search_progress_keyboard,
+    build_listing_detail_keyboard,
+    build_voivodeship_keyboard,
+    build_radius_keyboard,
+    build_filter_summary_keyboard,
+    build_saved_keyboard,
+    build_settings_keyboard,
+)
+from bot.keyboards.reply import main_menu_keyboard
+
+__all__ = [
+    "build_results_keyboard",
+    "build_search_progress_keyboard",
+    "build_listing_detail_keyboard",
+    "build_voivodeship_keyboard",
+    "build_radius_keyboard",
+    "build_filter_summary_keyboard",
+    "build_saved_keyboard",
+    "build_settings_keyboard",
+    "main_menu_keyboard",
+]