Agent skill · marketing growth · sundial-org

shopping-expert

Find and compare products online (Google Shopping) and locally (stores near you). Auto-selects best products based on price, ratings, availability, and preferences. Generates shopping list with buy links and store locations. Use when asked to shop for products, find best deals, compare prices, or locate items locally. Supports budget constraints (low/medium/high or "$X"), preference filtering (brand, features, color), and dual-mode search (online + local stores).

Why this skill is useful

Adds a complex product comparison algorithm and executable scripts for hybrid online and local searches that the AI wouldn't generate on its own.

What it needs

Requires uv installed locally. Requires google_places, serpapi account access. About 2k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.

What this skill does

Shopping Expert Find and compare products online and locally with smart recommendations. Quick Start Find products online: Search with budget constraint: Find local stores: Hybrid search (online + local): Search US stores: Search Modes online: E-commerce sites (Amazon, Walmart, etc.) via Google Shopping local: Nearby stores via Google Places API hybrid: Both online and local results merged and ranked auto: Intelligent mode selection based on query (default) Parameters query: Product search query (required) --mode: Search mode (online local hybrid auto, default: auto) --budget: "low/medium/high" or "€X"/"$X" amount (default: medium) --location: Location for local/hybrid searches --preferences: Comma-separated (e.g., "brand:Sony, wireless, black") --max-results: Maximum products to return (default: 5, max: 20) --sort-by: Sort order (relevance price-low price-high rating) --output: text json (default: text) --country: Country code for search (default: de). Use "us" for US, "uk" for UK, etc. Budget Levels low: Under €50 medium: €50-€150 high: Over €150 exact: "€75", "€250" (or "$X" for US searches) Output Format Default (text): Markdown table with product details, ratings, availability, and buy links JSON: Structured data with all product metadata, scores, and links Scoring Algorithm Products are ranked using weighted scoring: Price match (30%): Within budget range gets full points Rating (25%): Higher ratings score better Availability (20%): In stock > limited > out of stock Review count (15%): More reviews = more trustworthy Shipping/Distance (10%): Free shipping or nearby stores score higher Preference match (bonus): Keywords in product description API Keys Required SERPAPIAPIKEY: Required for online shopping (all modes except local-only) GOOGLEPLACESAPIKEY: Only required for local and hybrid modes Limitations API limits: SerpAPI and Google Places have usage quotas Real-time data: Prices and availability may change Stock accuracy: Online availability reflects last AP …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills sundial-org/shopping-expert

View the source on GitHub

Browse the @skills marketplace