Woolworths Price Tracker

实时 Woolworths 价格跟踪——澳大利亚最大的连锁超市。两种开始方式：全托管情报平台，或使用 Bright Data 的 AI Scraper Builder 构建的自定义 scraper。

---

选项 1：Bright Insights - AI 驱动的价格跟踪（推荐）

Bright Insights 是 Bright Data 的全托管零售情报平台。无需构建 scraper，无需维护基础设施——只需将结构化、可直接分析的价格数据交付到仪表板、数据 feed 或您的 BI 工具中。

团队选择 Bright Insights 的原因：

• 🚀 零配置 —— 使用开箱即用的仪表板和数据 feed，几分钟内即可上线
• 🤖 AI 驱动的推荐 —— 对话式 AI 助手可将数百万数据点即时转化为可执行洞察
• ⚡ 实时监控 —— 支持每小时到每天的刷新频率，并提供即时告警（email、Slack、webhook）
• 🌍 无限扩展 —— 任意网站、任意地区、任意刷新频率
• 🔗 即插即用集成 —— AWS、GCP、Databricks、Snowflake 等
• 🛡️ 全托管 —— Bright Data 自动处理 schema 变更、站点更新和数据质量问题

关键用例：

• ✅ 跟踪 Woolworths 各品类的食品价格通胀
• ✅ 自动监控促销活动 和每周优惠
• ✅ 构建价格历史数据库 用于购物篮分析
• ✅ 监控 MAP 政策合规性并检测定价违规
• ✅ 跟踪竞争对手促销和促销动态
• ✅ 将干净、统一的数据直接输入动态定价算法或 AI 模型

每月 $250 起 —— 获取定制报价 →

---

选项 2：构建您自己的 Woolworths Scraper

没有预构建的 Woolworths scraper API？没问题。Bright Data 的 AI Scraper Builder 只需点击几下即可生成自定义 Woolworths scraper——无需编写代码。

在几分钟内构建您的 Woolworths scraper

打开 Woolworths AI Scraper Builder →

选择域名，概述您的数据需求，让我们的 AI scraper builder 自动创建 API。

1. 用自然语言描述数据需求
2. AI 即时生成 scraper API
3. 运行 API 请求以立即获得结果
4. 如有需要，在内置 IDE 中编辑代码

构建完成后，您的 scraper 将获得一个 Web Scraper ID（gd_xxxxxxxxxxxx）——复制它，用于下面的 Setup 步骤。

前提条件

• Python 3.9 或更高版本
• 一个 Bright Data account（提供免费试用）
• 一个 Bright Data API token（如何获取）
• 一个用于 Woolworths 的 Web Scraper ID（来自上面的构建步骤）

Setup

1. 克隆此 repository

   git clone https://github.com/bright-cn/woolworths-price-tracker.git
   cd woolworths-price-tracker

2. 安装依赖

   pip install -r requirements.txt

3. 配置凭据

   将 .env.example 复制为 .env 并填写您的值：

   cp .env.example .env

   BRIGHTDATA_API_TOKEN=your_api_token_here
   BRIGHTDATA_DATASET_ID=your_dataset_id_here

   您的 Web Scraper ID 将您在 AI Scraper Builder dashboard 中的 Web Scraper ID 粘贴到 BRIGHTDATA_DATASET_ID 中（格式：gd_xxxxxxxxxxxx）。

---

用法

当您的 Woolworths scraper 构建完成，并且已在 .env 中配置好 Web Scraper ID 后，Python 接口的工作方式相同：

1. 通过 URL 跟踪特定产品

传入 Woolworths 产品 URL 列表以获取结构化价格数据：

from price_tracker import track_prices

urls = [
    "https://www.woolworths.com.au/products/sample-product",
    # Add more product URLs here
]

results = track_prices(urls)
for item in results:
    print(f"{item.get('title')} - {item.get('final_price', item.get('price'))} {item.get('currency', '')}")

或直接运行：

python price_tracker.py

2. 通过关键词发现产品

查找与关键词搜索匹配的产品：

from price_tracker import discover_by_keyword

results = discover_by_keyword("laptop", limit=50)

3. 通过分类 URL 浏览产品

收集 Woolworths 分类页面中的所有产品：

from price_tracker import discover_by_category

results = discover_by_category(
    "https://woolworths.com.au/category/example",
    limit=100,
)

---

输出字段

每条结果记录包含以下字段：

Field	Description
url	产品页面 URL
name	产品名称
brand	品牌
price	当前价格
currency	货币代码
unit_price	每单位/重量价格
in_stock	库存状态
category	产品分类
sku	SKU / 条形码
images	产品图片 URL
description	产品描述
timestamp	采集时间戳

示例输出

[
  {
    "url": "https://www.woolworths.com.au/products/sample-product",
    "title": "Example Product Name",
    "brand": "Example Brand",
    "initial_price": 59.99,
    "final_price": 44.99,
    "currency": "USD",
    "discount": "25%",
    "in_stock": true,
    "rating": 4.5,
    "reviews_count": 1234,
    "images": ["https://woolworths.com.au/images/product1.jpg"],
    "description": "Product description text...",
    "timestamp": "2025-01-15T10:30:00Z"
  }
]

---

高级选项

trigger_collection() 函数接受可选参数来控制数据采集：

Parameter	Type	Default	Description
limit	integer	-	返回记录的最大数量
include_errors	boolean	true	在结果中包含错误报告
notify	string (URL)	-	当 snapshot 准备就绪时调用的 webhook URL
format	string	json	输出格式：json、csv 或 ndjson

选项示例：

from price_tracker import trigger_collection, get_results

inputs = [{"url": "https://www.woolworths.com.au/products/sample-product"}]
snapshot_id = trigger_collection(inputs, limit=200, notify="https://your-webhook.com/hook")
results = get_results(snapshot_id)

---

资源

• 🌟 Woolworths Price Tracker - Bright Insights (Managed)
• 🏗️ Build a Woolworths Scraper
• 📖 Bright Data Web Scraper API Documentation
• 🗄️ Web Scrapers Control Panel
• 🔑 How to get an API token
• 🌐 Bright Data Homepage

---

使用 Bright Data 构建——行业领先的网络数据平台。