Quick Start Guide

Get Miata Maestro running in under 2 minutes

Before You Start

📦

Node.js 16+

Download from nodejs.org

node --version
📘

Facebook Account

Active account with Marketplace access

Credentials stored in session only
🤖

Ollama (Optional)

For AI evaluation features

Skip for basic scraping

Installation

1

Clone Repository

bash 
git clone https://github.com/Jasminestrone/MiataMaestro.git
cd Miata Maestro
2

Install Dependencies

bash 
npm install
Note: This installs Express, Puppeteer, Axios, and other required packages.
3

Start Server

bash 
node main.js
Success! You should see: 🚀 Miata Finder server running on http://localhost:3000

Your First Search

🌐

1. Open Browser

Navigate to http://localhost:3000

🔐

2. Login to Facebook

Enter your credentials (stored in session only)

Security: Disable 2FA temporarily if login fails
⚙️

3. Configure Search

Location: ZIP code + radius
Years: 1989-1997 (NA Miata)
Filters: Max mileage & price
Results: How many to process
🚗

4. Start Hunting

Click "🚗 Find My Miata" and watch the magic happen!

AI Setup (Optional)

Enable AI evaluation for detailed listing analysis and lowball message generation.

🤖 Ollama (Recommended)

Local & Private

Run AI models locally on your machine for privacy and speed.

bash 
# Install Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# Download model
ollama pull llama3.1:8b

# Start service
ollama serve
Windows users: Download installer from ollama.ai/download

🌐 Custom LLM

Advanced

Use any OpenAI-compatible API endpoint.

Example endpoints:
  • Local GPT4All server
  • Self-hosted models
  • Custom API services

What's Next?

📖

Complete Guide

Deep dive into advanced features, debugging, and customization

Read Full Guide
🔧

Troubleshooting

Common issues, debug mode, and performance tips

Get Help
🚀

API Reference

Endpoints, parameters, and response formats

View API Docs

Quick Commands

One-Line Install

git clone https://github.com/Jasminestrone/MiataMaestro.git && cd Miata Maestro && npm install && node main.js

With AI Setup

# Terminal 1: Start Ollama
ollama serve

# Terminal 2: Start Miata Maestro  
node main.js