FB Marketplace Manager

A Chrome extension + server + web dashboard for capturing, organizing, and searching Facebook Marketplace listings.

Contents

1. Overview

FB Marketplace Manager is a three-part system that automatically captures Facebook Marketplace listings, stores them in a searchable database, and presents them through a filterable dashboard.

🧩

Chrome Extension

Captures listing data in real-time as you browse Facebook Marketplace. Also supports automated background searches.

âš¡

Server

Receives and stores your ad data, removes duplicates, and resolves locations for radius-based searching.

📊

Web Dashboard

Single-page app for browsing, filtering, saving, and managing your collected listings. Supports radius search, quick filters, and bulk actions.

2. Browser Extension Extension

The Chrome extension automatically captures listings as you browse Facebook Marketplace. Once installed, it works in the background — just browse Marketplace normally and ads are saved to your server.

Extension Popup

Click the extension icon in your browser toolbar to access these controls:

ControlPurpose
Server URLThe backend server address (default: https://thorium-powered.com)
API KeyAuthentication key for server requests
Enable/DisableToggle ad capture on or off
Refresh PageRe-scan the current page for ads
Toggle Auto-ScrollStart/stop automatic page scrolling to load more listings
Open DashboardOpen the web dashboard in a new tab

On-Page Overlay

A draggable overlay appears at the top-right of Marketplace pages showing:

Keyboard shortcut: Ctrl+Shift+S toggles auto-scroll.

3. Background Search Jobs Extension

The system can automatically run Facebook Marketplace searches without you manually browsing. The extension picks up your search jobs and fetches results in the background.

How to Trigger Background Searches

MethodHow
Single filterClick the orange search icon next to any quick filter in the sidebar
All filtersClick "Search All Filters" button in the sidebar

Search Template

Before background searches can run, the extension needs to learn your current Facebook session. This happens automatically the first time you perform a manual search on Marketplace. The session expires after 4 hours — just browse Marketplace again to refresh it.

Things to Know

4. Filters & Quick Filters

Filter Options

FilterFormatEffect
LocationCity, STCenter point for radius search
RadiusMiles (1-500)Distance from location center
Min/Max PriceNumberPrice range filter
Title KeywordTextSearch in ad titles
Show HiddenCheckboxInclude hidden ads in results
Show SimilarButtonDisplay ads detected as similar to others

Quick Filters

Quick filters are server-stored search presets that persist across sessions and devices.

To create a quick filter: set your desired filters in the filter bar, type a name in the Quick Filter input, and click + Add. The filter appears in the sidebar where you can click it to apply, click the search icon to run a background search, or click × to remove it.

Your last-used filter values are automatically restored when you reload the page.

5. Extension Settings Extension

These settings are configured through the extension popup.

SettingDescription
Server URLAddress of your server (synced across Chrome devices)
API KeyYour server authentication key (synced across Chrome devices)
EnabledToggle ad capture on or off
Search TemplateLearned automatically when you browse Marketplace; expires after 4 hours
Back to top