Snoop is a modern, full-featured platform for property search, management, and analytics.
Inspired by Fredy, it takes real estate automation to the next level — powered by a cutting-edge tech stack, refined UI, and extended functionality.
Snoop scrapes multiple property services (Immonet, Immowelt, etc.) and sends new listings as soon as they appear.
The list of providers is easily extendable, and a clean web UI allows you to configure and manage your search jobs effortlessly.
When matching listings are found, Snoop sends them via Slack, Email, or Telegram (more adapters can be added).
All listings are tracked to prevent duplicates — even across platforms — while enabling analytics and insights.
- Revamped User Interface: Built with React, TypeScript, and TailwindCSS for a clean, responsive, and modern experience.
- Improved Database Layer: Enhanced data management using MongoDB and Mongoose for scalability and reliability.
- Modular Provider System: Add or customize real estate providers with structured integration and automated testing.
- Full-Stack Architecture: RESTful API powered by Node.js and Express for smooth frontend-backend communication.
- Analytics Dashboard: Real-time visualizations and insights built with Recharts.
Whether you're searching for properties or managing listings as an admin — Snoop delivers a secure, performant, and user-friendly platform for modern real estate workflows.
- Property Search: Advanced filters and map integration
- Dashboard: Real-time analytics and insights
- User Management: Secure authentication & role-based access
- API Integration: RESTful backend for all operations
- Responsive Design: Works seamlessly across devices
- Unlimited Jobs: Create as many search jobs as you want, each with its own configuration and provider selection
- Multi-Provider Support: Use any supported real estate platforms within your jobs (e.g., Immonet, Immowelt, etc.)
- Flexible Notifications: Send new listings through a variety of notifiers such as Slack, Telegram, Pushover, Email, and more
- Job Controls: Jobs can be easily activated or deactivated at any time
- Job Statistics: Every job includes detailed insights and activity statistics
- Listing Management: Mark listings as favorites or seen to keep track of your search
- Multiple Views: Switch between list view, grid view, and map view for optimal browsing
- Registration Options: Either admin-managed user accounts or user self-registration with email confirmation
- Frontend: React, TypeScript, TailwindCSS
- Backend: Node.js, Express
- Database: MongoDB + Mongoose ODM
- Authentication: JWT-based security
- Testing: Mocha + Chai
- React 18
- TypeScript
- TailwindCSS
- Vite
- React Router
- Axios
- Recharts
- Node.js
- Express
- Mongoose
- JWT
- Winston
- Puppeteer
- ESLint
- Prettier
- Nodemon
- Mocha
- Chai
If you want to get Snoop running instantly, the easiest way is via Docker Compose.
- Docker ≥ 24
- Docker Compose ≥ 2.20
-
Clone the repository:
git clone https://github.com/code-by-fh/snoop.git cd snoop -
Copy the environment configuration:
cp .env.example .env
Adjust your credentials and environment variables as needed (e.g., API keys, ports, notification adapters).
-
Start the full stack with Docker Compose:
docker-compose up -d
-
Access the application:
- 🌐 Frontend: http://localhost:3000
- ⚙️ Backend: http://localhost:5000
- 🗄️ MongoDB: mongodb://localhost:27017
-
(Optional) View logs:
docker-compose logs -f
That’s it — your local Snoop instance is live 🎉
If you prefer a manual setup for development or debugging:
- Node.js ≥ 18
- npm ≥ 9
- MongoDB ≥ 6
-
Clone the repository:
git clone https://github.com/code-by-fh/snoop.git cd snoop -
Install dependencies:
npm install cd client npm install cd .. cd server npm install cd ..
-
Copy and configure environment variables:
cp .env.example .env
-
Run the application:
npm run dev
Access:
- Frontend: http://localhost:3000
- Backend: http://localhost:5000
When Snoop starts for the first time, it automatically creates a default administrator account for initial access:
- Username: admin
- Password: Password123!
- You must log in with these credentials after the first start.
- Immediately change the password in the user settings for security reasons.
- Once changed, this default password cannot be restored automatically — please make sure to note the new one safely.
- The default credentials are created only if no admin user exists in the database.
Snoop supports two different user registration workflows, allowing you to choose the method that best fits your environment or security requirements.
An administrator can manually create new user accounts within the system.
After creation, the admin must activate the account.
This approach is ideal for closed environments or teams that require controlled access.
Snoop also provides an optional self-registration flow where users can create an account themselves and activate it via email confirmation.
To enable self-registration, the following environment variables must be configured:
# Email / SMTP configuration
SMTP_HOST=localhost
SMTP_PORT=1025
SMTP_USER=
SMTP_PASS=
# Enable self-registration
SELF_REGISTRATION_ENABLED=trueYou are responsible for providing and configuring your own SMTP service (e.g., Mailhog, Mailtrap, Postfix, or any external provider).
Self-registration will not work without a functioning mail server.
If SELF_REGISTRATION_ENABLED=false or not defined, only admin-created accounts are allowed.
Run the full test suite:
cd server
npm testDistributed under the MIT License.
See LICENSE for details.
Project Maintainer: Doublelayer
Project Repository: https://github.com/code-by-fh/snoop
![@github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=64&v=4){kind=small}