Tesco scraper for UK and Ireland groceries by search term, category or product URL. Get shelf and Clubcard prices with unit price and GTIN barcode, plus optional nutrition, ingredients and allergens. Incremental runs flag which products changed price since your last run.
In incremental runs, the "saved" amount in the end-of-run summary now uses
the actual price per result instead of an outdated one.
Two incremental runs started at the same time on the same tracked search can
no longer both deliver (and charge for) the same products.
0.1.27 — 2026-10-28 — exact matches only
New opt-in input Exact matches only (strictMatch, off by default).
Keeps only products whose brand or name contains every word of your search
term, so a brand search no longer returns unrelated products.
Dropped products are never charged, and a search stops once a results page
holds no match.
Applies to search terms only; categories and URLs are unchanged.
A run now stops cleanly at your maximum cost per run instead of fetching
products it cannot deliver.
2026-10-21 — nutrition, ingredients & allergens
New opt-in input Include Nutrition, Ingredients & Allergens
(includeDetails, off by default).
Adds ingredients, allergens (declared, plus the ones Tesco bolds in the
ingredients list), the full nutrition table, flat per-100g columns (energy
kcal/kJ, fat, saturates, carbohydrate, sugars, fibre, protein, salt),
storage advice, net contents, servings and recycling info.
Fetches details in batches of 10 products per request, paced to stay under
Tesco's rate limit (100 products take about 15 s extra). No extra charge.
Fields are null when the option is off or Tesco publishes nothing for a
product; detailsStatus says ok or failed when it is on.
Incremental mode: products reported unchanged are not fetched, and details
never make a product count as changed.
0.1 — 2026-08-06
First release.
Products are read from Tesco's own catalogue service, so every record carries
the fields the retailer publishes rather than what a page happens to show:
brand, barcode (GTIN), the full aisle taxonomy, product description, stock
status, and promotions with their start and end dates.
Scrapes Tesco Groceries products by search term or by category / search URL.
Every product carries shelf price, unit price with its unit, Clubcard offer
text, star rating, review count, stock status, image URL and product URL.
Incremental mode reports which products are new and which changed price,
unit price, offer or availability since the previous run.
Notifications to Telegram, Slack, Discord, WhatsApp or a generic webhook,
optionally only for products that changed.
Compact output mode and MCP connector export for agent pipelines.