Skip to content

zan-keith/cherry-pick

Repository files navigation

Cherry-Pick Scraper Extension

A Chrome extension for quick scraping of common elements from web pages.

This is just part of a hobby project of mine. I found this made my life easier and hopefully this will help someone else.

Features

  • Automatic Identifier Detection: Finds common classes, attributes, or tags among selected elements.
  • JavaScript Snippet Generation: Creates a JS snippet to select and scrape the elements.
  • One-Click Scraping: Press the "Scrape" button to copy the data from all matched elements.

Chrome Installation

  1. Download the ZIP file from the Releases section.
  2. Goto chrome://extensions/ and Enable "Developer Mode" on top right corner
  3. Drag and drop the ZIP file onto the Chrome Extensions page (chrome://extensions) to install the extension.

Firefox Installation

  1. Install Directly From Firefox Addons

How It Works

  1. Activate the Extension: Click the Cherry-Pick icon in your browser.

  2. Select Elements: Use the mouse to highlight and select elements you want to scrape.

    • Often different elements might come in the way when selecting. You can use the spacebar key to cycle between the selectable elements.
    • Try to pinpoint the exact element you need to scrape and click!
    • Select atleast two similar elements for best results..
  3. Scrape Elements: Click the "Scrape Elements" button in the popup. The extension will:

    • Find common identifiers.
    • Generate a JS selector snippet.
    • Copy the scraped data to your clipboard.
Example Use Case

Scrape all product names, prices, or links from a listing page by simply selecting a few examples.

Cherrypick.Demo.mp4

Developer Installation

  1. Clone repo git clone https://github.com/zan-keith/cherry-pick.git.
  2. Run pnpm install to install dependencies.
  3. Run pnpm dev to build the extension.
  4. Load the build/chrome-mv3-dev folder as an unpacked extension in Chrome.

Build Instruction

  • plasmo build --zip
  • plasmo build --target=firefox-mv2 --zip
Development

Contributing

Pull requests and suggestions are welcome!

License

MIT