Coles Scraper

E-commerce & Marketplaces

Operated by Sourcelane✓ verified

Scrapes Coles Australia (coles.com.au) for grocery product data, prices and specials by crawling search results, category pages, the weekly specials page and individual product pages; extracts comprehensive per-product records including current and previous pricing, savings and promotion labels, multibuy offers and unit pricing, availability and stock information, product identity and brand, images and category hierarchy (department/category/aisle/merchandise categories), and optional detailed product page data such as barcode (GTIN), ingredients, allergens, dietary claims, country of origin, storage instructions and nutrition panels (per 100g and per serve).

Verified Sep 28, 12:10 AM

$0.0012

per product

Up to 100 per call. Only pay for results returned; failed calls are refunded.

What people use it for

Price monitoring: track daily price changes and weekly specials for targeted products
Grocery price comparison: compare Coles pricing side‑by‑side with other supermarket results
Specials and catalogue tracking: scrape the entire on‑specials page or full categories on a schedule
Product data enrichment: collect barcodes, ingredients, allergens and nutrition panels for food apps and retail analytics
Market research: analyze brand share, price positioning and unit‑price comparisons across categories

Trust & reliability

7d uptime trend

Window	Uptime	Success rate	p50	p95
24h	—	—	—	—
7d	—	—	—	—
30d	—	—	—	—

Calling contract

Call it through Sourcelane's gateway or MCP server. We run the connector, apply your agent's spend guardrails, and bill only the results returned.

Call it via Sourcelane

curl -X POST https://cool-puffin-608.convex.site/v1/call \
  -H "Authorization: Bearer sl_live_your_agent_key" \
  -H "Content-Type: application/json" \
  -d '{"listing":"coles-scraper","params":{"searchTerms":["milk"],"maxResultsPerQuery":5},"maxResults":10}'

Request params

Field	Type	Required	Description
`searchTerms`	array	optional	Product searches to run on coles.com.au, one per line (e.g. 'milk', 'coffee beans', 'nappies'). Each term is searched separately.
`startUrls`	array	optional	Optional coles.com.au links to scrape: category pages (https://www.coles.com.au/browse/dairy-eggs-fridge), the specials page (https://www.coles.com.au/on-special), search pages, or individual product pages.
`specialsOnly`	boolean	optional	Only keep products that are currently on special. With no search terms or URLs this scrapes the whole Coles on-special catalogue.
`sortBy`	string	optional	Order of results within each search or category.
`includeDetails`	boolean	optional	Fetch each product's page for barcode (GTIN), ingredients, allergens, nutrition panel, country of origin and storage instructions. One extra request per product.
`inStockOnly`	boolean	optional	Skip products that are currently unavailable online.
`maxResultsPerQuery`	integer	optional	Cap on products returned for each search term or URL. Set 0 for all matching products (the connector pages through the full result set). Capped at 100 per call.

Each result contains

Field	Type	Description
`query`	string	Query
`queryType`	string	Query Type
`id`	string	Id
`name`	string	Name
`brand`	string	Brand
`size`	string	Size
`description`	string	Description
`url`	string	Url
`imageUrl`	string	Image Url
`images`	array	Images
`price`	number	Price
`wasPrice`	number	Was Price
`savings`	number	—
`onSale`	boolean	—
`isHalfPrice`	boolean	—
`promotionType`	string	—
`promotionLabel`	string	—
`multibuyQuantity`	null	—
`multibuyPrice`	null	—
`unitPrice`	number	—
`unitPriceLabel`	string	—
`unitMeasure`	string	—
`isAvailable`	boolean	—
`availabilityType`	string	—
`stockQuantity`	integer	—
`isSponsored`	boolean	—
`retailLimit`	integer	—
`department`	string	—
`category`	string	—
`subcategory`	string	—
`aisle`	string	—
`merchandiseCategory`	string	—
`merchandiseSubcategory`	string	—
`ageRestricted`	boolean	—
`gtin`	string	—
`ingredients`	string	—
`allergens`	string	—
`dietaryClaims`	array	—
`countryOfOrigin`	string	—
`storageInstructions`	string	—

Use Coles Scraper from Claude, ChatGPT or Cursor

Pick your tool and connect in under a minute. Then just ask — for example: “Track the price of these 20 grocery items at Woolworths and Coles every week.”

Connect Claude

Web, desktop and mobile. Paste one URL.

1Copy your personal connector URL
2In Claude open Settings → Connectors → Add custom connector
3Paste the URL and click Add — done

Manual setup (config files, REST, Python) +

Claude Code

Adds the Sourcelane MCP server with your key as a header.

terminal

claude mcp add --transport http sourcelane https://cool-puffin-608.convex.site/mcp \
  --header "Authorization: Bearer sl_live_your_agent_key"

Claude Desktop (config file)

Alternative to the connector URL: add to claude_desktop_config.json, then restart Claude.

claude_desktop_config.json

{
  "mcpServers": {
    "sourcelane": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://cool-puffin-608.convex.site/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer sl_live_your_agent_key"
      }
    }
  }
}

Cursor & Windsurf

Add to ~/.cursor/mcp.json (or Windsurf's mcp_config.json).

mcp.json

{
  "mcpServers": {
    "sourcelane": {
      "url": "https://cool-puffin-608.convex.site/mcp",
      "headers": {
        "Authorization": "Bearer sl_live_your_agent_key"
      }
    }
  }
}

VS Code

Save as .vscode/mcp.json. VS Code prompts for your key once.

.vscode/mcp.json

{
  "servers": {
    "sourcelane": {
      "type": "http",
      "url": "https://cool-puffin-608.convex.site/mcp",
      "headers": {
        "Authorization": "Bearer ${input:sourcelane-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "sourcelane-key",
      "description": "Sourcelane agent key",
      "password": true
    }
  ]
}

ChatGPT Custom GPT (Actions)

Create a GPT → Actions → Import from URL, then Authentication: API Key, Bearer.

OpenAPI schema URL

https://sourcelane-amber.vercel.app/openapi.json

REST

One POST. Pass maxResults to cap cost.

curl

curl -X POST https://cool-puffin-608.convex.site/v1/call \
  -H "Authorization: Bearer sl_live_your_agent_key" \
  -H "Content-Type: application/json" \
  -d '{"listing":"coles-scraper","params":{"searchTerms":["milk"],"maxResultsPerQuery":5},"maxResults":10}'

Python, LangChain, CrewAI, OpenAI Agents SDK…

Wrap the REST call as a tool, or point an MCP client at the endpoint.

python

import requests

res = requests.post(
    "https://cool-puffin-608.convex.site/v1/call",
    headers={"Authorization": "Bearer sl_live_your_agent_key"},
    json={
        "listing": "coles-scraper",
        "params": {"searchTerms":["milk"],"maxResultsPerQuery":5},
        "maxResults": 10,
    },
    timeout=300,
)
body = res.json()
print(body["receipt"]["chargedMicros"], "micro-USD for", body["receipt"]["results"], "results")
print(body["data"])

Reviews

—

0 reviews

Leave a review

Loading reviews…