# Catalogue Management

Catalogues are saved search configurations that make it easy to reuse your common searches. Instead of entering the same search terms repeatedly, create catalogues and run them with one click.

### You’ll learn

* How to create and run catalogues.
* How endless mode cycles through them.
* How to name and organize catalogues.

## What is a Catalogue?

A catalogue is a saved search configuration that includes:

* Search term
* Maximum listings to collect
* Blacklist terms (optional)
* Break settings (optional)
* Other scraping parameters

Benefits:

* Save time by reusing configurations
* Organize your searches
* Enable endless mode for multiple searches
* Track which searches you've run

## Creating a Catalogue

{% stepper %}
{% step %}

### Open Catalogue Manager

* Click "📋 Catalogues" in the sidebar
* Catalogue manager modal opens

{% hint style="info" %}
**Screenshot placeholder:** Catalogue list/modal opened from the sidebar.
{% endhint %}
{% endstep %}

{% step %}

### Create New Catalogue

* Click "Create New Catalogue" button
* Fill in the form
  {% endstep %}

{% step %}

### Required Fields

* Title: Name for this catalogue (e.g., "Honda Civics", "Trucks Under 10k")
* Search Term: What to search for (e.g., "honda civic", "truck")
  {% endstep %}

{% step %}

### Optional Fields

* Max Listings: How many listings to collect (default: 500)
* Blacklist: Terms to exclude, one per line
  * Example: "parts", "wrecked", "salvage"
* Break Settings: Configure automatic breaks
  * Micro breaks: Short pauses
  * Normal breaks: Medium pauses
  * Sleep breaks: Long pauses

{% hint style="info" %}
**Screenshot placeholder:** “Create New Catalogue” form showing required + optional fields.
{% endhint %}
{% endstep %}

{% step %}

### Save

* Click "Save" button
* Catalogue appears in your list
* Ready to use immediately
  {% endstep %}
  {% endstepper %}

### Catalogue Examples

Example 1: Specific Vehicle

* Title: "2018 Honda Civics"
* Search Term: "honda civic 2018"
* Max Listings: 200
* Blacklist: "parts", "wrecked"

Example 2: Price Range

* Title: "Trucks Under 10k"
* Search Term: "truck"
* Max Listings: 500
* Blacklist: (none)

Example 3: Multiple Terms

* Title: "SUVs and Crossovers"
* Search Term: "suv"
* Max Listings: 300
* Note: Create separate catalogues for different terms

## Using Catalogues

### Single Run

{% stepper %}
{% step %}

### Select Catalogue

* Click on a catalogue in the list
* Or use the "Run" button
  {% endstep %}

{% step %}

### Start Scraping

* Click "Run Catalogue"
* Scraping begins with saved settings
* Stops when complete
  {% endstep %}

{% step %}

### Monitor Progress

* Watch Console tab for progress
* Results saved automatically
  {% endstep %}
  {% endstepper %}

### Endless Mode

{% stepper %}
{% step %}

### Select Catalogues

* Check boxes next to catalogues you want
* Select 2-10 catalogues (recommended)
  {% endstep %}

{% step %}

### Start Endless Mode

* Click "Start Endless Mode"
* Configure cycle settings:
  * Max cycles (or unlimited)
  * Break between cycles

{% hint style="info" %}
**Screenshot placeholder:** Endless mode selection UI with multiple catalogues checked.
{% endhint %}
{% endstep %}

{% step %}

### Continuous Operation

* Cycles through selected catalogues
* Never stops automatically
* Manually stop when done
  {% endstep %}
  {% endstepper %}

Endless Mode Benefits:

* Never miss new listings
* Continuous deal hunting
* Automatic cycling
* Perfect for overnight runs

## Managing Catalogues

### Editing a Catalogue

{% stepper %}
{% step %}

### Find the Catalogue

* Locate in your catalogue list
* Click the edit icon (pencil)

{% hint style="info" %}
**Screenshot placeholder:** Edit/clone/delete icons shown on a catalogue row.
{% endhint %}
{% endstep %}

{% step %}

### Modify Settings

* Change any field
* Update search term, max listings, etc.
  {% endstep %}

{% step %}

### Save Changes

* Click "Save"
* Changes applied immediately
  {% endstep %}
  {% endstepper %}

### Cloning a Catalogue

{% stepper %}
{% step %}

### Select Catalogue

* Click the clone icon
* Or use "Clone" option
  {% endstep %}

{% step %}

### Modify Copy

* Edit the cloned catalogue
* Change search term or settings
  {% endstep %}

{% step %}

### Save as New

* Saves as separate catalogue
* Original unchanged

Use Case:

* Create "Honda Civics" catalogue
* Clone it to "Honda Civics Under 5k"
* Modify search term and settings
  {% endstep %}
  {% endstepper %}

### Deleting a Catalogue

{% stepper %}
{% step %}

### Select Catalogue

* Click delete icon
* Or use "Delete" option
  {% endstep %}

{% step %}

### Confirm Deletion

* Confirm you want to delete
* Cannot be undone

Note: Deleting a catalogue does NOT delete scraped data. Only removes the catalogue configuration.
{% endstep %}
{% endstepper %}

## Break Settings

Configure automatic breaks during scraping to prevent rate limiting and mimic human behavior.

### Break Types

Micro Breaks:

* Duration: 1-5 seconds
* Frequency: Every few listings
* Purpose: Small pauses

Normal Breaks:

* Duration: 5-30 seconds
* Frequency: Every 10-20 listings
* Purpose: Medium pauses

Sleep Breaks:

* Duration: 30+ seconds
* Frequency: Every 50+ listings
* Purpose: Longer pauses

### Configuring Breaks

{% stepper %}
{% step %}

### Open Break Settings

* Available when creating/editing catalogue
* Or in main settings
  {% endstep %}

{% step %}

### Set Parameters

* Max Continuous Time: How long before break
* Break Duration: How long to pause
* Frequency: How often breaks occur
  {% endstep %}

{% step %}

### Save Settings

* Breaks apply during scraping
* Can be skipped manually if needed
  {% endstep %}
  {% endstepper %}

### Break Benefits

* Prevents Rate Limiting: Facebook less likely to throttle
* Reduces Detection: More natural browsing pattern
* Account Safety: Less risk of account issues
* Better Results: More reliable scraping

## Catalogue Organization

### Naming Conventions

Good Names:

* "Honda Civics 2018-2020"
* "Trucks Under 10k"
* "SUVs and Crossovers"
* "Motorcycles - Sport"

Avoid:

* "test", "new", "catalogue 1"
* Unclear or generic names
* Special characters that cause issues

### Organizing by Purpose

By Vehicle Type:

* "Cars - Sedans"
* "Cars - SUVs"
* "Trucks - Full Size"
* "Motorcycles"

By Price Range:

* "Under 5k"
* "5k to 10k"
* "10k to 20k"
* "Over 20k"

By Make/Model:

* "Honda - Civic"
* "Honda - Accord"
* "Toyota - Camry"
* "Ford - F150"

## Tips for Effective Catalogues

1. Be Specific: More specific search terms yield better results
2. Use Blacklists: Filter out unwanted listings automatically
3. Set Realistic Limits: Don't set max listings too high
4. Test First: Run with small max listings to test
5. Organize Well: Use clear, descriptive names
6. Enable Breaks: Configure breaks for safety
7. Update Regularly: Edit catalogues as your needs change

***

### Next pages

* Understand deal scoring: [Hot Deals](/core-workflow/hot-deals.md)
* Spot trends: [Analytics](/web-dashboard/analytics.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/catalogue-management.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.