🖥️Main App

The HiveFB main application is your control center for scraping Facebook Marketplace listings. This guide covers the interface and key features.

You’ll learn

• Where each feature lives in the UI.

• What Phase 1 vs Phase 2 means.

• How to monitor progress and errors.

Interface Overview

Sidebar Navigation

The sidebar provides quick access to all major features:

• 🚀 Start Scraping: Begin a new scraping session

• 📋 Catalogues: Manage your search catalogues

• 🔔 Alerts: View hot deals and alerts

• 👤 Account Manager: Manage Facebook login credentials

• ⚙️ Settings: Configure app preferences

• 📊 View Data: Open the web dashboard

Screenshot placeholder: Main app sidebar navigation with all items visible.

Main Content Area

The main area has two tabs:

Console Tab

• Real-time logs and status updates

• Shows scraping progress

• Displays errors and warnings

• Phase information (Phase 1 or Phase 2)

Browser Tab

Screenshot placeholder: Console tab showing normal logs (no sensitive info).

Screenshot placeholder: Browser tab showing the live automation browser view.

Status Indicators

Connection Status:

• 🟢 Green Light: Automation connected and ready

• 🔴 Red Light: Connection lost or error occurred

• ⏳ Spinner: Connecting or processing

Progress Indicators:

• Progress Bar: Shows scraping completion percentage

• Status Text: Describes current operation

• Phase Indicator: Shows which phase is active

Screenshot placeholder: Top-right connection indicator (🟢/🔴) and an active scrape progress bar.

Key Features

Two-Phase Scraping System

HiveFB uses an intelligent two-phase approach to maximize efficiency:

1

Phase 1: Discovery

Purpose: Rapidly discover unique listings

Process:

• Scrolls through Facebook Marketplace search results

• Identifies unique listing URLs

• Filters out duplicates automatically

• Collects basic information (title, price, image)

Duration: Typically 5-15 minutes depending on results

Output: List of unique listing URLs ready for inspection

2

Phase 2: Deep Inspection

Purpose: Extract comprehensive listing details

Process:

• Visits each listing page individually

• Extracts detailed information:

  • Full vehicle specifications (mileage, transmission, color, fuel type, etc.)

  • Complete seller information

  • Full descriptions

  • Multiple images

  • Location details

  • Posted time information

Duration: Typically 2-5 minutes per listing

Output: Complete listing data saved to database

Smart Filtering

HiveFB includes several intelligent filtering mechanisms:

Relevance Detection

• Automatically filters irrelevant listings

• Uses search term correlation to determine relevance

• Configurable threshold (default: 60%)

• Saves time by skipping unrelated results

Blacklist Filtering

• Exclude listings containing specific terms

• Useful for filtering out unwanted items

• Example: Blacklist "parts" to exclude part-out listings

• Applied during Phase 1 discovery

Duplicate Prevention

• Never processes the same listing twice

• URL-based deduplication

• Works across multiple scraping sessions

• Prevents wasted time on already-seen listings

Intelligent Scrolling

• Optimized scroll timing to avoid rate limiting

• Configurable delays between actions

• Mimics human browsing patterns

• Reduces risk of detection

Using the Application

Starting a Scrape

1

Click "🚀 Start Scraping" in sidebar

2

Select scraping mode (Vehicle or Item)

3

Configure search parameters

4

Click "Start Scraping"

5

Monitor progress in Console tab

Stopping a Scrape

• Click the "✕" stop button (appears when scraping is active)

• Or close the application (data is saved automatically)

• Partial results are preserved

Viewing Results

1

Click "📊 View Data" in sidebar

2

Dashboard opens in your browser

3

Browse, filter, and analyze your findings

Managing Account

1

Click "👤 Account Manager" in sidebar

2

Add, edit, or remove Facebook accounts

3

Credentials are encrypted and stored locally

Tips for Best Results

1

Use Specific Search Terms: More specific terms yield better results

2

Adjust Scroll Speed: Slower speeds are safer but take longer

3

Monitor Console: Watch for errors or warnings

4

Use Catalogues: Save common searches for reuse

5

Enable Breaks: Configure automatic breaks to prevent rate limiting

---

Next pages

• Run scrapes: Scraping Guide

• View results: Web Dashboard