PriceLister v2.1

Free price scraper - Upgrade to Pro for unlimited records and price monitoring.

1. Overview

Version 2.1 new features: Price monitoring with target alerts (↝/↯), image thumbnails, watchlist preview, floating scraper button, and unlimited records with Pro.

2. Installation & First Launch

1. Open Chrome and navigate to chrome://extensions.
2. Enable Developer mode (top-right toggle).
3. Click Load unpacked and select the PriceLister folder.
4. Pin the extension icon for easy access.

3. User Interface Overview

The popup has six tabs: Scrape (keywords + filters), Upgrade (Pro info), Sites (config management), Settings (scraping behavior), Preview (live results), and Logs (debug info). A status bar shows record count, steps, and current state.

4. Scrape Tab - Keywords & Filters

4.1 Keywords

One keyword per line. Each keyword is searched independently on every selected site.

iphone 17\nsamsung galaxy s25\nnike air max

4.2 Positive/Negative Keywords

Positive: Product title must contain ALL of these words. Negative: Skip products containing ANY of these words (e.g., "used", "refurbished").

4.3 Uploading Keyword Lists

Click Load Positive or Load Negative to upload .txt files (one keyword per line).

5. Managing Sites

Five built-in sites: Amazon, eBay, Etsy, Walmart, Daraz. Each has pre-configured CSS selectors, price formats, and currency settings.

5.1 Adding Custom Sites

1. Click Add Site, enter display name and domain.
2. Fill in Item selector, Title selector, Price selector, and Next selector.
3. Set Price format (Decimal, Integer, or Cents Last2) and Currency symbol.
4. Grant host permission when prompted.

5.2 Price Format Guide

6. Global Settings

7. Running a Scrape

1. Enter keywords, select sites, set optional filters.
2. Click Start. The extension opens tabs for each keyword/site pair.
3. Watch progress in the status bar. Pause or Stop anytime.
4. Results appear in Preview tab in real-time.
5. Export to CSV when done.

8. Previewing & Exporting Data

The Preview tab shows the latest 12 scraped products. Click Export CSV to download all records. Columns: Title, Site/Subtitle, Price, URL, Notes (image URL). Clear Data resets all records.

9. Debug Logs

The Logs tab shows the last 120 internal log entries with timestamps and scope. Use Copy to clipboard for sharing issues. Clear to reset.

10. Troubleshooting

10.1 No items found

Check that your Item/CSS selectors match the site's current layout. Use DevTools (F12) to inspect elements.

10.2 Incorrect prices

Try different Price formats. Selectors may need to be more specific (target the exact price element, not the entire card).

10.3 Permission prompts

Grant host permissions when prompted. If denied, open chrome://extensions, find PriceLister, click Details > Site access, and add domains manually.

11. Advanced Configuration

Create custom site configurations for any e-commerce website using CSS or XPath selectors. Export your configs as JSON to share with others.

11.1 Example: Adding "ShopX"

Search URL: https://www.shopx.com/search?q={keyword}
Item: div.product-card
Title: h3.product-title
Price: span.main-price (format: Decimal, currency: $)
URL: a.product-link (attr: href)
Next: a.next-page

12. SEO Best Practices

PriceLister v2.1 is SEO-optimized for market research:

• Exported CSV data is clean and structured for content analysis
• Title, price, and URL data helps identify keyword opportunities
• Competitive pricing analysis across multiple marketplaces
• Filter by positive keywords to find high-intent product terms
• Use negative keywords to exclude irrelevant results

13. Credits & Upgrade

Built by morkerr.com.

This is the free version of PriceLister (100 record limit). Upgrade to PriceLister Pro for unlimited records, price monitoring with alerts, and priority support.

Documentation v2.1 - June 2026