A complete Yad2 rental listing monitoring system with both automated tracking and web-based administration.

This repository contains two main components:

yad2-tracker/
├── tracker-service/          # Node.js/TypeScript tracker service
│   ├── src/                  # Tracker source code
│   ├── dist/                 # Compiled JavaScript
│   ├── package.json          # Tracker dependencies
│   ├── tsconfig.json         # TypeScript configuration
│   └── README.md             # Tracker documentation
├── admin-web/                # Next.js admin panel
│   ├── app/                  # Next.js App Router pages
│   ├── components/           # React components
│   ├── lib/                  # Database and auth utilities
│   ├── package.json          # Admin panel dependencies
│   └── README.md             # Admin panel documentation
├── .github/workflows/        # GitHub Actions for tracker
└── README.md                 # This file

The tracker service runs automatically via GitHub Actions every hour, monitoring Yad2 listings and sending email notifications.

Setup:

cd tracker-service
npm install
# Configure .env file with your credentials
npm run dev

Features:

• Automated Yad2 API monitoring
• Email notifications for new listings
• Database storage with Supabase
• GitHub Actions scheduling

The admin panel provides a web interface for managing the tracker system.

Setup:

cd admin-web
npm install
# Configure .env.local file
npm run dev

Features:

• Dashboard with statistics
• URL management
• Ads history and search
• Settings and controls

• Purpose: Automated monitoring of Yad2 listings
• Technology: Node.js, TypeScript, PostgreSQL
• Deployment: GitHub Actions (free)
• Schedule: Runs every hour automatically

• Purpose: Web interface for system management
• Technology: Next.js 14, React, Tailwind CSS
• Deployment: Vercel (free)
• Access: Web-based admin interface

cd tracker-service
npm run dev          # One-time run
npm run dev:schedule # Continuous monitoring

cd admin-web
npm run dev         # Start development server

• Automatic: GitHub Actions runs every hour
• Manual: Trigger via GitHub Actions UI
• Cost: Free

• Platform: Vercel
• Setup: Connect GitHub repository
• Cost: Free (hobby plan)

• Tracker Service: See tracker-service/README.md
• Admin Panel: See admin-web/README.md
• Database Setup: See tracker-service/DATABASE_SETUP.md
• Admin Deployment: See ADMIN_DEPLOYMENT.md

Tracker Service (.env in tracker-service/):

GMAIL_USER=[email protected]
GMAIL_APP_PASSWORD=your-app-password
DATABASE_URL=postgresql://...
SEND_EMAILS=true

Admin Panel (.env.local in admin-web/):

DATABASE_URL=postgresql://...
ADMIN_PASSWORD=your-admin-password

1. Real Estate Monitoring: Track rental listings in specific areas
2. Price Alerts: Get notified of new listings matching criteria
3. Market Analysis: Historical data and statistics
4. Automated Workflows: Set-and-forget monitoring

• GitHub Actions: Free (2,000 minutes/month)
• Vercel: Free (hobby plan)
• Supabase: Free (500MB database)
• Total: $0/month

• Password-protected admin panel
• Environment variable secrets
• Database connection security
• HTTPS for all web interfaces

For issues or questions:

1. Check component-specific README files
2. Review deployment documentation
3. Check GitHub Actions logs
4. Verify environment variables

Ready to get started? Choose your component:

• Tracker Service Setup
• Admin Panel Setup