mirror of
https://github.com/primedigitaltech/azon_seeker.git
synced 2026-10-05 07:13:06 +08:00
* feat: add Amazon collection metadata and reliable sync * fix: route extension sync through configured server * chore: release extension v0.7.13 * fix: handle extension ports across BFCache navigation * fix: classify bottom Sponsored Brands video placements * fix: exclude hidden Amazon ad cards * fix: derive Amazon result page from URL * fix: ignore hidden Amazon sponsored products * fix: preserve base Amazon product collection * fix: bind Amazon results to visible page * fix: classify visible Amazon ad formats * fix: wait for lazy Amazon ad modules * perf: reduce Amazon lazy-load scroll stops * fix: classify Amazon sponsored brand and video search ads Co-authored-by: Cursor <cursoragent@cursor.com> * fix: collect Shop by type thematic SP ads via redirect chains without data-asin Co-authored-by: Cursor <cursoragent@cursor.com> * fix: classify sponsored ads across new Amazon templates --------- Co-authored-by: Cursor <cursoragent@cursor.com> Co-authored-by: PetrichorFun <127877748+PetrichorFun@users.noreply.github.com>
Azon Seeker
Introduction
Azon Seeker is a browser extension designed to collect and manage product information from Amazon and other platforms. It supports importing, exporting, and previewing product and review data, making it a powerful tool for e-commerce research and data analysis.
Features
- 🛒 Collect Product Data: Easily gather product details and reviews from Amazon and other websites.
- 📦 Import/Export: Supports importing and exporting data in Excel format for further analysis.
- ☁️ Cloud Export: Export your data to the cloud for backup or sharing.
- 🔄 Reliable Server Sync: Collected Amazon data is durably queued, retried in the background, and removed from the queue only after the server confirms persistence.
- 📊 Data Table: View, filter, and manage collected data in a user-friendly table.
- 🖼️ Image Preview: Hover to preview product images.
- 🌐 Multi-browser Support: Works with Chromium-based browsers and Firefox.
- 🧩 Modern UI: Built with Vue 3 and Naive UI for a clean, responsive experience.
Get Started
1. Prepare Requirements
Make sure the following software is installed:
2. Clone this Repository
git clone https://github.com/primedigitaltech/azon_seeker.git
cd ./azon_seeker/
3. Setup the Webext-bridge
cd ./webext-bridge
pnpm i
pnpm build
cd ../
3. Install the Project's Dependencies
pnpm i
4. Run in Development Mode
pnpm dev
5. Load Extension on Browser
- Open the browser extension page.
- Toggle on development mode.
- Load the extension using the
extension/folder.
Build
1. Make Sure Setup Successfully
Following the step of Get Started to make sure setup successfully.
2. Build Project
pnpm run build # For Chromium Browser (Microsoft Edge .etc)
pnpm run build-firefox # For Firefox
3. Pack Extension
pnpm run pack:7z
After the build is completed, the Chromium package will be generated in
build/extension-v<version>.7z.
Amazon Server Synchronization
- Development builds use
127.0.0.1:8001by default. - Production builds use
amzplugin.rekeymed.comover HTTPS/WSS by default. - Override either target at build time with
VITE_REMOTE_HOST=host:port. - The extension persists unsent batches in
browser.storage.localand retries once per minute. - Search and detail records include a client-generated
syncId; the server uses it as a unique idempotency key. - The side panel displays pending, syncing, synchronized, and failed states and provides a manual retry action.
Before publishing a production package, deploy the backend migrations and verify that the
production /openapi.json contains syncId, adType, and strikethroughPrice.
Languages
TypeScript
68%
Vue
31.4%
SCSS
0.4%
HTML
0.2%