ZUREQ Shopper

ZUREQ Shopper is a small, zero-build extension for Chrome and Edge, with a generated Firefox version, for finding products, watching prices, and creating checkout links through the ZUREQ MCP API.

Featured integration on zureq.io.

Install

1. Connect with your ZUREQ account in Options, or get an API key at zureq.io.
2. In Chrome or Edge, open chrome://extensions or edge://extensions, enable Developer mode, and choose Load unpacked.
3. Select this repository directory, open the extension's Options, and connect your account or save your API key.

API keys are stored in browser sync storage; sign-in tokens stay in this browser's local storage. MCP requests go to api.zureq.io; chat.zureq.io is contacted only for sign-in, token refresh, and disconnect. Search history and 24-hour market-list and shop-info caches are stored locally. There is no tracking or analytics.

Features

• Search products by country, price, stock, and result limit.
• Inspect product details and variants, including stock and freshness; expand long descriptions and visit shops already in cache.
• Create checkout links for supported shops; List splits carts to each shop's line limit and falls back to per-item links when a cart fails.
• Search selected page text from the context menu.
• View current API usage and this session's estimated credit spend.
• Save product and search watches for scheduled price-drop, target-price and back-in-stock alerts, with a local 30-day price history.

New shopping tools

• List searches up to 10 products, shows up to five candidates per item, and groups selected products by shop with item totals and checkout links.
• Shop pages on Allegro.pl, Amazon, Ceneo, eBay, x-kom.pl, and MediaExpert.pl get a “Find on Zureq network” button; optionally enable a cached inline “Cheaper on Zureq” check in Options.

Ideas implemented

• Relevance-ranked product search with country, price, stock, and result-limit filters.
• Product detail cards with variant selection and checkout-link creation.
• Context-menu search for selected text.
• Credit usage badge, recent searches, market caching, and an options page for local API-key management.

Credit costs

Tool	Credits
search_products	3 credits (1 if nothing is found)
get_product	1
create_checkout_link	1
get_shop	1 (cached per shop for 24 hours)
list_shops, list_categories	1
list_markets, get_usage	Free

Each List search costs up to 3 credits per item. Checkout checks shop support with get_shop before creating links; shop metadata is cached per shop for 24 hours. Each checkout-link request costs 1 credit, and cart links respect each shop's line limit.

Development

This is plain JavaScript, HTML, and CSS with no bundler or dependencies.

Run the unit tests with:

npm test

To try the extension in Chrome or Edge, open chrome://extensions or edge://extensions, enable Developer mode, and choose Load unpacked, selecting this repository directory.

Firefox

Build the Firefox version with npm run build:firefox. Open about:debugging → This Firefox → Load Temporary Add-on… and select dist/firefox/manifest.json. Re-run the build after edits before reloading the temporary add-on. The toolbar icon toggles the ZUREQ Shopper sidebar.

Release

1. Run scripts/bump-version.sh X.Y.Z to update manifest.json and package.json.
2. Add a matching ## [X.Y.Z] section to CHANGELOG.md.
3. Commit the changes, create tag vX.Y.Z, and push the tag.
4. The release workflow runs tests, packages the Chrome and Firefox extensions, and attaches both zips to the GitHub Release. It publishes to the Chrome Web Store when its secrets are configured, Edge Add-ons only when all EDGE_* secrets are set, and AMO only when AMO_* secrets are set.

Chrome Web Store copy is in store-assets/listing.md, Edge Add-ons copy is in store-assets/edge/listing.md, and Firefox Add-ons copy is in store-assets/firefox/listing.md. Regenerate the listing PNGs with bash store-assets/render.sh.