# 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

{% hint style="info" %}
**Screenshot placeholder:** Main app sidebar navigation with all items visible.
{% endhint %}

### Main Content Area

The main area has two tabs:

{% tabs %}
{% tab title="Console Tab" %}

* Real-time logs and status updates
* Shows scraping progress
* Displays errors and warnings
* Phase information (Phase 1 or Phase 2)
  {% endtab %}

{% tab title="Browser Tab" %}

* Live view of the automation browser
* See exactly what HiveFB is doing
* Useful for debugging issues
* Watch the scraping process in real-time
  {% endtab %}
  {% endtabs %}

{% hint style="info" %}
**Screenshot placeholder:** Console tab showing normal logs (no sensitive info).
{% endhint %}

{% hint style="info" %}
**Screenshot placeholder:** Browser tab showing the live automation browser view.
{% endhint %}

### 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

{% hint style="info" %}
**Screenshot placeholder:** Top-right connection indicator (🟢/🔴) and an active scrape progress bar.
{% endhint %}

## Key Features

### Two-Phase Scraping System

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

{% stepper %}
{% step %}

### 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
{% endstep %}

{% step %}

### 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
{% endstep %}
{% endstepper %}

### 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

{% stepper %}
{% step %}
Click "🚀 Start Scraping" in sidebar
{% endstep %}

{% step %}
Select scraping mode (Vehicle or Item)
{% endstep %}

{% step %}
Configure search parameters
{% endstep %}

{% step %}
Click "Start Scraping"
{% endstep %}

{% step %}
Monitor progress in Console tab
{% endstep %}
{% endstepper %}

### 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

{% stepper %}
{% step %}
Click "📊 View Data" in sidebar
{% endstep %}

{% step %}
Dashboard opens in your browser
{% endstep %}

{% step %}
Browse, filter, and analyze your findings
{% endstep %}
{% endstepper %}

### Managing Account

{% stepper %}
{% step %}
Click "👤 Account Manager" in sidebar
{% endstep %}

{% step %}
Add, edit, or remove Facebook accounts
{% endstep %}

{% step %}
Credentials are encrypted and stored locally
{% endstep %}
{% endstepper %}

## Tips for Best Results

{% stepper %}
{% step %}
Use Specific Search Terms: More specific terms yield better results
{% endstep %}

{% step %}
Adjust Scroll Speed: Slower speeds are safer but take longer
{% endstep %}

{% step %}
Monitor Console: Watch for errors or warnings
{% endstep %}

{% step %}
Use Catalogues: Save common searches for reuse
{% endstep %}

{% step %}
Enable Breaks: Configure automatic breaks to prevent rate limiting
{% endstep %}
{% endstepper %}

***

### Next pages

* Run scrapes: [Scraping Guide](/core-workflow/scraping-guide.md)
* View results: [Web Dashboard](/web-dashboard/web-dashboard.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hivefb.app/core-workflow/main-app.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.