Skip to content

README.md

Latest commit

 

History

History
135 lines (75 loc) · 5.51 KB

README.md

File metadata and controls

135 lines (75 loc) · 5.51 KB
Raw

FreeShip Watch

The free-shipping alert bot for Amazon.

freeship-promo.mp4

Watch any Amazon product and get pinged the moment it's eligible for free shipping to Israel again (the $49-cart-minimum AmazonGlobal deal). On your desktop, and on your phone.


Download for Firefox


License MIT Firefox add-on Signed by Mozilla No account Runs locally

Amazon turns free international shipping on and off for products all the time. A charger that costs $12 to ship in the morning can ship free by the afternoon, and Amazon never says a word when it changes. FreeShip Watch keeps an eye on it for you.

It's a small Firefox add-on. Paste a product link, or open any Amazon page and click This tab, and it starts watching that product. When it's eligible for free shipping again, you get a notification. It all runs in your own browser.


One dot tells the whole story.

Green means it ships free to Israel now, amber means shipping still costs money, red means it can't ship here

Buzz your phone, too.

Free shipping push notification on a phone lock screen via ntfy.sh

Set it and forget it.

FreeShip Watch re-checks every watched product automatically, about every 30 minutes, in the background

Two clicks to install.

Download the signed file, drag it into Firefox, click Add

Install

The add-on is signed by Mozilla, so it installs for good. No developer mode, no re-adding it every week.

  1. Download freeship-watch.xpi from the latest release.
  2. Open Firefox and drag the file onto the window. (Or go to about:addons, click the gear ⚙, and choose Install Add-on From File….)
  3. Click Add when Firefox asks.
  4. Pin the parcel icon to your toolbar.

Then open any Amazon product page, click the icon, and hit This tab to start watching it.

One setup step: stay signed in to amazon.com with your delivery address set to Israel. FreeShip Watch reads each page the same way you would, so the free or paid status matches what you'd actually pay.

Run it unpacked (from source)

No build step. The extension is plain JavaScript.

  1. Clone this repo.
  2. Open about:debugging#/runtime/this-firefox.
  3. Click Load Temporary Add-on… and pick manifest.json.

It stays loaded until you restart Firefox. The signed .xpi above is the permanent option.

Phone and email alerts

Desktop notifications work right away. To also get alerts on your phone:

  1. Install the free ntfy app and pick any topic name, like ntfy.sh/my-freeship-abc123.
  2. In FreeShip Watch, open Settings ⚙ and paste that URL into Push webhook.
  3. Subscribe to the same topic in the ntfy app, or forward it to email.

Living outside Israel?

FreeShip Watch comes set up for free shipping to Israel, because that's what I built it for. The rule that decides whether something is free is just a couple of text patterns, so if you're on a different Amazon marketplace you can ask Claude (or any LLM) to switch it to your locale in about a minute:

"Here's the FreeShip Watch extension. Change the free-shipping detection and the labels to match Amazon.[your-country] and my local free-shipping threshold."

The status colors, background checks, and phone alerts all work the same anywhere.

How it works

FreeShip Watch is a Manifest V2 add-on with three parts:

  • detect.js reads an Amazon product page the way you'd see it and marks it as free, paid, or unavailable using a few text patterns you can edit under Settings.
  • background.js re-checks every watched product about every 30 minutes, compares the result to last time, and fires a notification (plus an optional ntfy push) when something turns free.
  • popup.* is the list you see, where you add products, watch the dots, and change settings.

FAQ

Does this cost anything? No. It's free and open source (MIT), and it never asks for an account.

Does it collect my data? No. It runs entirely in your browser. The only network requests go to Amazon, to check your products, and to your own ntfy topic if you set one up.

Which Amazon? amazon.com out of the box. Other marketplaces need the quick retarget above.

Will it get me a better price? It watches shipping, not price. It tells you when an order clears the ~$49 free-shipping threshold so you stop paying for international shipping.

Amazon free shipping alert · Amazon free shipping notifier · AmazonGlobal $49 minimum tracker · free shipping to Israel bot · Firefox extension