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:

json
1{
2  "env": {
3    "TAVILY_API_KEY": "tvly-your-api-key-here"
4  }
5}

Usage

bash
1# Search entire web (default - no domain filter)
2python scripts/deal_hunt.py "Dyson V15"
3
4# Multi-query search (max 3, runs in parallel, deduplicates results)
5python scripts/deal_hunt.py "AirPods Pro" --queries "AirPods Pro deal,AirPods Pro coupon,AirPods Pro discount"
6
7# Limit to specific sites
8python scripts/deal_hunt.py "MacBook Air" --domains amazon.com,walmart.com,bestbuy.com
9
10# Custom single query
11python scripts/deal_hunt.py "Nintendo Switch" --query "Nintendo Switch OLED bundle deal"
12
13# Fresh deals only
14python scripts/deal_hunt.py "PS5" --time-range day

CLI Parameters

Output

Returns JSON with results:

json
1{
2  "meta": {
3    "product": "AirPods Pro",
4    "queries": ["AirPods Pro deal", "AirPods Pro coupon"],
5    "domains": null,
6    "time_range": "week",
7    "search_time": "2026-01-13T...",
8    "total_results": 15
9  },
10  "results": [
11    {
12      "title": "...",
13      "url": "https://...",
14      "content": "...",
15      "score": 0.95
16    }
17  ]
18}

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:

json
1{
2  "product": "Sony WH-1000XM5",
3  "best_deal": {
4    "price": 279.99,
5    "original_price": 399.99,
6    "discount": "30% off",
7    "retailer": "Amazon",
8    "url": "https://amazon.com/...",
9    "condition": "new",
10    "in_stock": true
11  },
12  "all_deals": [
13    {
14      "price": 279.99,
15      "retailer": "Amazon",
16      "url": "https://...",
17      "notes": "Prime shipping"
18    },
19    {
20      "price": 169.99,
21      "retailer": "eBay via Slickdeals",
22      "url": "https://...",
23      "notes": "Refurbished"
24    }
25  ],
26  "coupons": [
27    {
28      "code": "AUDIO10",
29      "discount": "10% off",
30      "retailer": "Best Buy",
31      "expires": "2026-01-31"
32    }
33  ],
34  "summary": "Best new price is $279.99 at Amazon (30% off). Refurbished available for $169.99."
35}

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