PL-Real-Estate-Developer-Price-Checker

# Automated PL Real Estate Developer Website Checker

![hippo](https://github.com/kamilstanuch/Automated-PL-Real-Estate-Developer-Website-Checker/blob/main/developer_watch_gif.gif)

## Project Context and Purpose

Starting September 11, 2025, following new regulations effective from July 2025, real estate developers in Poland will be legally required to publicly display apartment prices on their websites. This project serves as an automated tool to monitor developers' compliance with these transparency requirements.

### Core Functionality

The script automatically:
- Visits developer websites
- Analyzes content for specific apartment prices
- Distinguishes between actual prices and general price ranges
- Logs results with timestamps
- Generates clear responses: "Available apartment prices" or "No available apartment prices"

### Technology Stack

The project leverages:
- LLM (Large Language Model) for intelligent content analysis
- Browser-Use for browser automation
- Python for process orchestration

---

# Technical Setup Guide

This guide will help you set up the project using the `browser-use` package for web automation with Google's Gemini model.

## Prerequisites

- Python 3.11 or higher
- A Google API key for Gemini model access

## Step-by-Step Setup Guide

### 1. Create and Activate Virtual Environment

```bash
# Create a new virtual environment
python -m venv venv

# Activate the virtual environment
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate
```

### 2. Install Required Packages

```bash
# Install browser-use and other required packages
pip install browser-use google-generativeai python-dotenv

# Install Playwright package
pip install playwright

# Install Playwright browsers (IMPORTANT: use this exact command)
python -m playwright install chromium --with-deps
```

⚠️ Common Mistake: Don't use `playwright install` directly - it won't work. Always use `python -m playwright install`.

### 3. Set Up Environment Variables