Shopping Copilot

Shopping Copilot is a Chromium MV3 extension MVP for one focused comparison flow:

Right-click an Amazon product → extract the product → search Mercado Libre Colombia → show the top 3 matching offers in the side panel.

Features

• Chrome/Chromium Manifest V3 extension.
• Context menu entry: Shopping Copilot.
• Native side panel UI.
• Amazon product page and Amazon listing-card extraction.
• Local product-title cleanup.
• Mercado Libre Colombia API search.
• Mercado Libre page-scrape fallback when the public API returns 403.
• Top 3 ranked offers only.

Install

npm install
npm run build

Then open chrome://extensions, enable Developer mode, choose Load unpacked, and select the dist folder.

Usage

1. Open an Amazon product page or Amazon search listing.
2. Right-click the exact product title, image, or card.
3. Choose Shopping Copilot.
4. Review the 3 Mercado Libre offers in the side panel.

Commands

npm run typecheck
npm run lint
npm run test
npm run build

Project Structure

• src/background: extension events and search orchestration.
• src/content: DOM extraction and Mercado Libre fallback scraping.
• src/core: pure utilities and shared types.
• src/providers: Mercado Libre integration.
• src/panel: side panel UI.
• tests: unit and component coverage.