- name
- supermarket-sales
- description
- Fetch weekly sale details from Australian supermarkets (Woolworths and Coles). Use when the user wants to check current specials, compare prices, or get sale information from Woolworths or Coles.
Supermarket Sales Fetcher
Fetch weekly specials and sale details from Woolworths and Coles Australia.
Overview
This skill retrieves current supermarket specials from Australia's two major grocery chains:
- Coles - Direct fetch via Puppeteer browser automation
- Woolworths - Via trusted third-party aggregators (official site blocks automated access)
Works well for Melbourne metro area (postcode 3000-3008).
Installation
# Clone and install dependencies
npm installThis will install:
- puppeteer (^22.0.0) - Browser automation
Requires: Node.js 18+, npm
Usage
Common Commands
| Task | Command |
|---|---|
| Fetch all deals | npm start or node scripts/fetch_daily.js |
| Coles only | npm run coles or node scripts/fetch_with_puppeteer.js |
| Bash (basic) | bash scripts/fetch_sales.sh |
Alternative: Web Fetch
For Woolworths deals without running code:
web_fetch: { "url": "https://www.catalogueau.com/sales/?stores=Woolworths" }
web_fetch: { "url": "https://currentspecials.com.au/woolworths-weekly-catalogue/" }Alternative: Search
web_search_plus: { "query": "Woolworths Coles specials this week Melbourne" }How It Works
Coles
Uses Puppeteer to launch a headless browser, navigate to coles.com.au/on-special, and extract product cards with prices and savings.
Woolworths
Uses trusted aggregators (catalogueau.com, currentspecials.com.au) since woolworths.com.au blocks automated access.
Output
Sample output:
=== COLES SPECIALS - 11 Apr 2026 ===
| # | Product | Price | Deal |
|---|---|---|
| 1 | Coles Strawberries 250g | $4.00 | Was $16/kg |
| 2 | Staminade Powder 585g | $8.00 | Save $3.50 |Sources
| Store | Method | URL |
|---|---|---|
| Coles | Puppeteer | coles.com.au/on-special |
| Woolworths | Aggregator | catalogueau.com/woolworths/ |
| Both | Search | web_search_plus |
Troubleshooting
Puppeteer not found
Install Chromium:
npx puppeteer browsers install chromeNo deals found
- Site may have changed selectors - check for updates
- Try alternative methods (web_fetch or search)
Errors
Check Node.js version: node --version (need 18+)