Pegasus Hunter extension documentation
Everything you need to install the extension, generate the API key, run your first scan, and understand what the server does with the data. Updated for v0.9.0.
// Index
What you'll find on this page
// 01 · Installation
Install the extension in Chrome
The extension isn't on the Chrome Web Store yet. You load it manually as an "unpacked extension" in two minutes.
- 01Download and unzip the .zip
Click the "Download the extension" button at the top of this page. It's a .zip file of about 1 MB.
- Save the file in a permanent folder (e.g. ~/Documents/pegasus-extension). Don't unzip it inside Downloads: if you empty that folder, the extension stops working.
- Unzip the file with a double click. You'll get a folder with manifest.json, background.js, content scripts and icons.
- 02Open chrome://extensions
Paste chrome://extensions into the address bar and press Enter. Alternative: Chrome Menu → Extensions → Manage extensions.
- chrome:// URLs can't be opened from external links — you have to type (or paste) it into the address bar yourself.
- It also works on Chromium derivatives (Brave, Edge, Arc): the path may differ, but the extensions panel exists everywhere.
- 03Enable developer mode
In the top right of the extensions panel there's a "Developer mode" toggle. Turn it on.
- Three new buttons will appear under the title: Load unpacked, Pack extension, Update.
- Developer mode carries no risk: it only enables loading extensions that don't come from the Chrome Web Store.
- 04Load the unpacked folder
Click "Load unpacked" and pick the folder you unzipped in step 1.
- Select the folder itself, NOT the manifest.json file inside it.
- The Pegasus icon will show up in the extension toolbar next to the address bar. Click it once and pin it so it's always visible.
// 02 · API key setup
Generate and paste the API key
The extension runs on your computer but sends results to the Pegasus server. The API key is your pass: without it, the extension won't start.
- 01Open the API keys dashboard
Sign into your Pegasus account and go to API keys. Click "Create key" and give it a recognizable name (e.g. "Chrome — personal laptop").
- 02Copy the key ONCE
The server shows you the full key (format wsk_…) only once. Copy it immediately with the copy button. If you close the dialog without copying, you'll have to create a new one.
- 03Paste it into the extension
Open the extension by clicking its icon, go to Settings and paste the key into the "API key" field. Save. A green check appears if the key is valid.
"Invalid wsk_" error
If you see an invalid key error, check in order: the key starts with wsk_, you didn't add spaces at the start or end during copy-paste, and the key hasn't been revoked. If in doubt, revoke it from the dashboard and create a new one — it's free.
Open the dashboard// 03 · Run a scan
Launch your first scan
Once the API key is set, you're ready to scan. Pegasus runs on top of Facebook Ads Library: open the FB page and the extension does the rest.
One or more keywords describing the product or niche. Examples: "posture corrector", "led mask", "crystal earrings". The more specific the keyword, the more targeted the results.
FB Ads Library geographic filter. Defaults to Italy. Change it according to the market you want to analyze (United States, Germany, France, etc.).
Maximum number of results to scrape per scan. Default 100. Higher = more time, more tokens consumed server-side.
What to expect
An average scan (limit 100) takes 1 to 3 minutes. The extension opens FB Ads Library, auto-scrolls the ad list, extracts linked Shopify URLs and sends them to the server. Results appear in real time both in the overlay and on your Scanner dashboard.
// 04 · Live overlay
The in-browser overlay during a scan
While the extension runs you see a fixed widget in the top-right corner of the Facebook page. It shows in real time what's being scraped, without covering the page content.
Number of cards processed, Shopify URLs found, transient errors, and progress percentage toward your set limit.
Interrupt the scan at any time. Results collected up to that point stay saved on the server: you don't lose anything.
Opens the Scanner dashboard page in a new tab with the full detail of the current scan.
// 05 · What the server does
What happens after the extension has scraped
The extension sends the server only the public Shopify URLs found in the ads. The server handles the rest, without you having to keep the browser open.
The Scanner dashboard page collects all your past scans: keyword, country, number of results, linked stores. From here you can promote a product to the tracker.
Open ScannerWhen a product enters the Tracker, the server monitors it 24/7 at regular intervals: price, availability, variants, sells counter. Full history server-side, accessible even with your browser closed.
Open Tracker// 06 · Troubleshooting
Common issues and fixes
Six FAQs based on the most frequent cases reported by early users.
// 07 · Privacy and security
What the extension doesn't do
Pegasus Hunter is designed to be as transparent as possible. Three technical guarantees.
The extension does not access Facebook session cookies. Stay logged into your browser without any risk of suspensions linked to Pegasus.
Scraping the FB page happens in the browser, on your machine. The server only receives already-extracted Shopify URLs — never a raw page dump.
The extension is open source on GitHub. You can read the content script, background worker and manifest before installing. Issues and PRs welcome.
// 08 · Versioning
Updates and changelog
The extension updates manually: when a new version ships we notify you by email, and you just download the updated .zip from the download page, unzip it over the existing folder, and click "Update" on chrome://extensions.
Full changelog on GitHub Release →// Ready to start?
You've got everything you need
Download the extension, generate the key from the dashboard, launch your first scan. If you get stuck, email support@pegasushunter.com.