Name: Shopping Expert
Author: udiedrichsen

據 AlphaMoat 統計,截至 2026-09,Shopping Expert 累計下載 4,715 次、獲 7 個星標,在全部 5,078 個 AI 技能中排名第 2,012 位,在「生活服務」分類(246 個)中排名第 68 位。

累計安裝

374

累計下載

4715

星標

全站排名

#2,012

全站前 40% · 「生活服務」前 28%

平台	累計安裝	累計下載	星標	評論
ClawHub ↗	150	4452	7	-
SkillHub ↗	374	4715	7	—

各平台的計數口徑不同,統計時間不一致。

這個技能是做什麼的

支援線上、本地、混合及自動模式，可按預算、品牌或功能偏好篩選，並按價格、評分或相關性排序。使用 uv；線上搜尋需 SerpAPI key，本地與混合搜尋需 Google Places key。結果包含商品資訊和連結，但價格可能變化，Places 結果不保證門店庫存。搜尋詞傳送給 SerpAPI，本地位置傳送給 Google Places；可用近似位置，購買或出行前核對連結、賣家和庫存。

資料釋出於 2026-10-27

可以用來做什麼

比較線上與附近來源的商品選項

什麼時候用

商品搜尋需要預算、偏好和地點篩選時

示例提示詞

以下是根據技能文件生成的示例,不代表實際執行結果。

整理預算、偏好與地點，選擇搜尋模式，並在展示選項時說明庫存限制。

月度資料趨勢

累計下載4715

星標7

2026-09 起統計方法調整:同名技能按作者分別統計,並覆蓋全部技能。圖中虛線為調整前的月份,與之後的資料不直接比較,也不計算跨越調整的增長。

月份	累計下載	環比	星標
2026-09	4715	—	7
2026-08	4355	+2.5%	7
2026-07	4250	+5.9%	7
2026-06	4015	+3.7%	7
2026-05	3873	—	7
2026-03	3568	—	5

SKILL.md 原文

以下是作者釋出的原始檔案,按純文字顯示,本站未做修改或稽核;其中的連結不可點選,命令請核實後再執行。抓取於 2026-10-23。

3.9 KB · ClawHub v1.1.0

---
name: shopping-expert
description: 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).
homepage: https://github.com/clawdbot/clawdbot
metadata: {"clawdbot":{"emoji":"🛒","requires":{"bins":["uv"],"env":["SERPAPI_API_KEY","GOOGLE_PLACES_API_KEY"]},"primaryEnv":"SERPAPI_API_KEY","install":[{"id":"uv-brew","kind":"brew","formula":"uv","bins":["uv"],"label":"Install uv (brew)"}]}}
---

# Shopping Expert

Find and compare products online and locally with smart recommendations.

展開全部(共 116 行)


## Quick Start

Find products online:

```bash
uv run {baseDir}/scripts/shop.py "coffee maker" \
  --budget medium \
  --max-results 5
```

Search with budget constraint:

```bash
uv run {baseDir}/scripts/shop.py "running shoes" \
  --budget "$100" \
  --preferences "Nike, cushioned, waterproof"
```

Find local stores:

```bash
uv run {baseDir}/scripts/shop.py "Bio Gemüse" \
  --mode local \
  --location "Hamburg, Germany"
```

Hybrid search (online + local):

```bash
uv run {baseDir}/scripts/shop.py "Spiegelreflexkamera" \
  --mode hybrid \
  --location "München, Germany" \
  --budget high \
  --preferences "Canon, 4K Video"
```

Search US stores:

```bash
uv run {baseDir}/scripts/shop.py "running shoes" \
  --country us \
  --budget "$100"
```

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

- **SERPAPI_API_KEY**: Required for online shopping (all modes except local-only)
- **GOOGLE_PLACES_API_KEY**: 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 API update
- **Local inventory**: Store stock not guaranteed via Places API

## Error Handling

- Invalid query → Returns error with suggestions
- No results found → Relaxes filters and retries
- API failures → Retry with exponential backoff (3 attempts)
- Missing API keys → Clear error message with setup instructions