# ArbitrageIQ

> Automated real estate lead sourcing, AI categorization, and multi-channel arbitrage engine for **Nomadic Crucial** and **Reservation Resources**.

ArbitrageIQ scrapes listing data from third-party rental sources (Facebook Marketplace, SpareRoom, Furnished Finder, etc.) using residential proxies, processes and categorizes properties via AI, and recommends targeted monetization pathways.

---

## 🚀 Monetization Channels

1. **Nomadic Crucial:** Aggregated room feed and lead data for budget NYC renters.
2. **Reservation Resources (Direct Management):** Master lease / rent-to-own acquisitions for direct operations.
3. **Reservation Resources (Marketplace):** Host-onboarding outreach to act as an listing partner.

---

## 🛠 Tech Stack

- **Runtime:** Node.js (v20+)
- **Language:** TypeScript (via `tsx`)
- **CLI Framework:** `commander`
- **CLI UI Rendering:** `@b9g/termdom`
- **Database & Storage:** Google Firebase (Firestore & Firebase Storage)
- **Proxy & Evasion:** BrightData Residential Proxies
- **Testing:** Vitest

---

## 📋 Prerequisites

- Node.js >= v20.0.0
- npm >= 10.0.0
- Google Firebase Account & Service Account credentials
- BrightData Account API credentials

---

## ⚡ Quick Start

### 1. Installation

```bash
npm install
```