Pounce Docs

Overview

Pounce runs on your Windows PC and uses your saved Facebook session to browse Marketplace on a schedule. The dashboard is local. Pounce Cloud handles license checks, AI verification, AI rule generation, eBay-based pricing, and alert-quality analytics.

1. You create searches. Choose a query, mode, assigned accounts, optional auto-messaging, and AI rules.
2. Pounce scans locally. It loads Marketplace results through your account, scrolls a controlled amount, filters location, and skips duplicates.
3. AI and pricing qualify listings. Candidates are checked against your rules, pricing mode, location, condition logic, carrier-lock logic, and seller-risk checks when needed.
4. You get an alert. Discord, Telegram, and Windows notifications can include price, location, listing link, search, condition notes, and profit context.
5. Pounce can send an opener. If auto-message is enabled for the search and the listing is close enough, Pounce sends one opener during the scan and tracks replies in Messages.

Requirements

• Windows 10 or 11. Pounce is a packaged Windows desktop app.
• A valid Pounce license. Licenses are managed through Whop.
• A Facebook account with Marketplace access. A dedicated or backup account is recommended if you care about risk isolation.
• A notification destination. Discord is recommended. Telegram and Windows toast notifications are also supported.

Install

1. Download the latest Pounce installer from Whop.
2. Run the installer and launch Pounce.
3. Enter your Pounce license when prompted. License keys start with P-.
4. Complete the setup checklist in the dashboard.

App data, logs, sessions, and the listings database are stored under your Windows user profile so normal app updates do not wipe your setup.

Quick Start

1. Open Settings and set your ZIP code, scan radius, scan interval, quiet hours, notification channels, and Auto-message settings.
2. Open Accounts, add an account, and click Login to sign in through the Facebook login window.
3. Open Searches and create your first search. Pick Auto for exact comparable products, Manual when you want to set the buy range yourself, or Flexible for broader rules-driven searches.
4. Assign at least one account to the search. Each enabled search/account pairing counts as one Search Instance. Turn on auto-message only for searches where you want Pounce to send an opener after an alert.
5. Wait for Auto pricing to prepare if the search uses eBay pricing.
6. Click Start Monitor after all enabled searches are ready.

Modes

Every search uses one mode. Pick the mode based on whether Pounce should calculate a buy target from sold comps, use your own buy range, or handle a broader rules-driven search.

Pounce uses gross ROI, not margin. A 30% ROI target means a listing needs about $30 of gross profit on a $100 buy. In Auto, the rough formula is buy target = expected resale / (1 + ROI).

Flexible Mode

Flexible is for broader searches where price is easy to define but value depends on specs, contents, or category details. It still needs concrete rules; it is not meant for vague searches.

Search Instances & Limits

Pounce limits usage by Search Instance, not just by saved search name. A Search Instance is one enabled search running on one Facebook account.

The standard plan includes 50 Standard Search Instances and 3 Flexible Search Instances. Higher limits are available through support.

AI Filter Rules

AI Filter Rules are the most important search-specific instructions. They tell Pounce what should count as a match and what should be rejected before any alert is sent.

Good rules are concrete. Tell Pounce what to reject and what must be true.

• Good: Reject iPhone listings with iCloud lock, financing/payment plans, water damage, parts-only, or non-working phones.
• Good: Accept Gaming PCs only if the listing includes RTX 3070 or better, 32GB RAM or better, and a working complete tower.
• Weak: Must be a good deal.

Pounce can generate rules from your search name, but you should always review them before saving.

Pricing Prep

Auto searches need cloud pricing before they can safely alert. When you create or edit an enabled Auto search, Pounce asks Pounce Cloud to prepare pricing data.

• The search may show Preparing Pricing until the cloud job finishes.
• Pounce prepares pricing one search at a time to keep the eBay sold-price process stable.
• The Start button is blocked while enabled Auto searches are missing required initial pricing.
• Pricing refreshes in the background after it ages, without blocking normal scans unless the data becomes too stale to trust.
• If cloud pricing fails, the search stays blocked instead of sending alerts without a target.

Price Drop Re-Alerts

Pounce tracks prices for seen listings. A price-drop alert only fires when the new price now qualifies for the search.

• In Auto, the dropped price must be at or below the calculated buy target.
• In Manual or Flexible, the dropped price must be inside your min/max range.
• Drops that are still too expensive are recorded silently and can qualify later.

Seller Profile Checks

If an otherwise approved listing looks unusually profitable, Pounce can do a quick seller-profile risk check before alerting. This is meant to catch obvious scam patterns, such as one seller posting many high-demand products at prices that are all too good to be true.

• The check is only for high-ROI candidates that are about to alert.
• Pounce looks at a small snapshot of the seller's visible Marketplace activity.
• If the seller profile looks clearly suspicious, the listing is rejected and shown as rejected in the dashboard.
• If Facebook does not expose enough profile context, Pounce is conservative and avoids pretending it knows more than it does.

Notifications

Pounce supports Discord, Telegram, and Windows toast notifications. Discord is recommended because it is fast, searchable, and easy to keep open while you work.

Discord Notifications

1. Open your Discord server settings.
2. Go to Integrations, then Webhooks.
3. Create a webhook for the alert channel.
4. Paste the webhook URL into Pounce Settings.

Telegram Notifications

1. Message @BotFather on Telegram and create a bot.
2. Copy the bot token into Pounce Settings.
3. Send the bot a message, get your chat ID, and paste it into Pounce.
4. Use Send Test Message to confirm the channel is connected.

Windows Toasts

Windows toast notifications can be enabled in Settings. If they do not appear, check Windows notification permissions for Pounce and confirm Focus Assist or Do Not Disturb is not hiding them.

Messages & Auto-Messaging

Auto-messaging is optional and controlled per search. When it is enabled, Pounce can send one opener after an approved alert while it is already on the listing during the scan.

• Per-search toggle: turn on Auto-message approved listings only for searches where you want Pounce to contact sellers.
• Message radius: alerts can use your full search radius, while auto-messages only send inside the smaller auto-message radius from Settings.
• Auto-message section: messaging hours, auto-message radius, Seller Reply Notifications, and Message Templates all live together in Settings.
• Messaging hours: Pounce only sends openers during the hours you choose. Deal alerts still send normally outside those hours.
• Templates: keep at least 20 unique opener templates. Pounce rotates them so every seller does not receive the exact same wording.
• Seller Reply Notifications: turn these on if you want Discord/Telegram alerts when sellers reply or when auto-message needs manual help.
• Replies: unreplied sent openers are checked at the start of scans for a limited recent window. Replies appear in the Messages tab and can trigger seller reply notifications.

The Messages tab shows openers Pounce sent, captured seller replies, listing images, and any messages that need your attention. It is an activity view for Pounce-sent openers, not a full Messenger replacement. Open Conversation launches the correct account browser so you can continue manually from the same Facebook session.

Location

Set your ZIP code and radius in Settings. Pounce is built around local pickup, so Marketplace searches are treated as local pickup searches. Pounce geocodes listing locations and drops listings outside your radius before AI verification runs.

If geocoding cannot confidently identify a listing location, Pounce is conservative and does not alert on that listing until distance can be verified.

Marketplace Location Override

Some accounts, proxies, or server setups can cause Facebook to return listings from the wrong area. In the Accounts tab, you can optionally enter the raw Marketplace location segment from a Facebook Marketplace search URL.

Example: from /marketplace/104120026289717/search/, enter only 104120026289717.

Accounts

Accounts hold Facebook session state, optional saved login details, optional proxy settings, assigned searches, and the optional Marketplace location override. Each account uses its own browser profile/session file, and each search must be assigned to at least one account.

1. Open the Accounts tab.
2. Add one account, or use Bulk Add Accounts if you are setting up several accounts at once.
3. Click Login and sign into Facebook normally.
4. Wait for Pounce to detect the logged-in session.
5. Assign searches to that account.

Assigning Multiple Accounts

You can assign more than one account to the same search. This can increase coverage for that search while each individual account keeps normal pacing.

• One account on one search: the search follows your normal scan interval.
• Two accounts on one search: Pounce can check that search up to about twice as often.
• Five accounts on one search: Pounce can check that search up to about five times as often.

This applies only when multiple accounts are assigned to the same search. If each account has different searches, those searches still follow the normal interval for their assigned account.

Multiple account assignment also affects plan usage. One search assigned to three accounts uses three Search Instances, because Pounce is effectively running that search through three separate account sessions.

Account Health

If Facebook shows a checkpoint, CAPTCHA, suspension, or block during a scan, Pounce stops scanning the affected account and sends a notification naming that account. Re-login or resolve the Facebook prompt before using that account again.

Proxies

Proxies are optional for a single local account, but are highly recommended if you run multiple accounts.

• Use stable, high-quality residential or ISP proxies.
• We strongly recommend using static proxies.
• Avoid rapidly rotating IPs on the same Facebook account.
• Keep an account's IP behavior realistic over time.
• Use the Marketplace Location Override if Facebook returns the wrong local area.

Quiet Hours

Quiet hours pause scanning during the hours you choose. They are enabled by default and recommended, especially overnight. Continuous scanning at odd hours can look less natural and can create alerts you will not act on anyway.

The default quiet-hours window is 12:00 AM to 9:00 AM for new installs. Use normal clock times in Settings; overnight ranges are supported.

Messaging hours are separate. They limit only auto-message openers, while deal alerts still send normally.

Dashboard Tabs

Support

The Support tab is the first place to go when something is unclear or broken.

• Status cards show license, cloud, monitor, setup, and service status.
• Docs link opens this guide.
• Discord Support opens the support Discord.
• Report a Bug sends the description and app context to Pounce support.
• Save Support Bundle saves local diagnostics when support asks for them. Support bundles do not include Facebook cookies, saved browser sessions, browser profile folders, saved account credentials, webhook secrets, or proxy passwords.

Data & Privacy

Your Facebook session cookies, saved browser sessions, browser profile folders, saved account credentials, webhook secrets, and proxy passwords stay on your machine and are not included in support bundles. Pounce Cloud receives data needed to operate cloud-backed features:

• License checks through Whop.
• AI verification and AI rule generation requests.
• eBay pricing preparation and refreshes.
• Alert-quality analytics so the operator can see what listings are reaching users.
• Auto-message and seller-reply notification events when those features are enabled.
• Bug reports submitted through the Support tab.

Pounce is not affiliated with Facebook, Meta, eBay, Whop, Discord, or Telegram.

No Profitable Listings Found Yet

This usually means Pounce has scanned but nothing has passed all filters yet. Check:

• The search is enabled and assigned to a logged-in account.
• The ZIP code and radius are correct.
• The price range or ROI target is not too strict.
• AI Filter Rules are not rejecting good listings.
• Facebook Marketplace itself is returning relevant results for the account.

Cloud Unavailable or Pricing Failed

Cloud features require internet access and Pounce Cloud availability. If pricing fails, Auto searches wait instead of alerting without a price target.

• Check the Support tab status cards.
• Try again after a few minutes if eBay pricing is preparing or temporarily blocked.
• Use Manual or Flexible if you want to run a search without eBay pricing.
• Report the issue from the Support tab if it persists.

Session Expired

If an account shows a login problem, open Accounts and click Login. Pounce will not scan that account until the session is healthy again.

Sessions can expire after downtime, Facebook security checks, password changes, or account checkpoint prompts.

CAPTCHA or Facebook Pushback

If Pounce detects CAPTCHA, checkpoint, or block behavior, it pauses the affected account and alerts you. Re-login if needed, then consider reducing scan aggressiveness or reviewing proxy/account setup.

Known Limitations

• Facebook Marketplace can change its layout or behavior without warning. When this happens, Pounce can temporarily stop working.
• AI can make mistakes, especially with vague listings, missing details, or misleading photos.
• eBay pricing is a conservative estimate, not a guaranteed resale value.
• No automation tool can guarantee zero account risk.

When in doubt, treat Pounce as a strong assistant, not a replacement for judgment.