Deal Hunt

Search for deals on any product. Returns raw Tavily search results - Claude analyzes them to find the best prices.

Prerequisites

Tavily API Key Required - Get your key at https://tavily.com

Add to ~/.claude/settings.json:

{
  "env": {
    "TAVILY_API_KEY": "tvly-your-api-key-here"
  }
}

Usage

# 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.