🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Supermarket Sales

by @nicowu07

Fetch weekly sale details from Australian supermarkets (Woolworths and Coles). Use when the user wants to check current specials, compare prices, or get sale...

Versionv1.2.0
Downloads380
TERMINAL
clawhub install supermarket-sales

πŸ“– About This Skill


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 install
    

    This 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 chrome
    

    No 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+)

    πŸ’‘ Examples

    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" }
    

    πŸ“‹ Tips & Best Practices

    Puppeteer not found

    Install Chromium:
    npx puppeteer browsers install chrome
    

    No 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+)