# Search entire web (default - no domain filter)
python scripts/deal_hunt.py "Dyson V15"

# Multi-query search (max 3, runs in parallel, deduplicates results)
python scripts/deal_hunt.py "AirPods Pro" --queries "AirPods Pro deal,AirPods Pro coupon,AirPods Pro discount"

# Limit to specific sites
python scripts/deal_hunt.py "MacBook Air" --domains amazon.com,walmart.com,bestbuy.com

# Custom single query
python scripts/deal_hunt.py "Nintendo Switch" --query "Nintendo Switch OLED bundle deal"

# Fresh deals only
python scripts/deal_hunt.py "PS5" --time-range day

CLI Parameters

Option	Short	Default	Description
`product`	-	Required	Product name
`--query`	`-q`	`{product} deal price`	Single custom search query
`--queries`		None	Comma-separated queries (max 3), runs in parallel with dedup
`--domains`	`-d`	None (search all)	Optionally limit to specific domains
`--max-results`	`-n`	10	Number of results per query
`--time-range`	`-t`	week	day, week, month, year, none
`--search-depth`	`-s`	advanced	basic, advanced, fast, ultrafast

Output

Returns JSON with results:

{
  "meta": {
    "product": "AirPods Pro",
    "queries": ["AirPods Pro deal", "AirPods Pro coupon"],
    "domains": null,
    "time_range": "week",
    "search_time": "2026-01-13T...",
    "total_results": 15
  },
  "results": [
    {
      "title": "...",
      "url": "https://...",
      "content": "...",
      "score": 0.95
    }
  ]
}

When using --queries, results are deduplicated by URL (highest score kept, content merged).

Output Schema for Analysis

After running the search, Claude should analyze results and structure findings as:

{
  "product": "Sony WH-1000XM5",
  "best_deal": {
    "price": 279.99,
    "original_price": 399.99,
    "discount": "30% off",
    "retailer": "Amazon",
    "url": "https://amazon.com/...",
    "condition": "new",
    "in_stock": true
  },
  "all_deals": [
    {
      "price": 279.99,
      "retailer": "Amazon",
      "url": "https://...",
      "notes": "Prime shipping"
    },
    {
      "price": 169.99,
      "retailer": "eBay via Slickdeals",
      "url": "https://...",
      "notes": "Refurbished"
    }
  ],
  "coupons": [
    {
      "code": "AUDIO10",
      "discount": "10% off",
      "retailer": "Best Buy",
      "expires": "2026-01-31"
    }
  ],
  "summary": "Best new price is $279.99 at Amazon (30% off). Refurbished available for $169.99."
}

Claude extracts prices from content, compares deals, and presents the best options with purchase links.

deal-hunt

Deal Hunt

Prerequisites

Usage