Name: Shopping Expert
Author: udiedrichsen

据 AlphaMoat 统计,截至 2026-09,Shopping Expert 累计下载 4,715 次、获 7 个星标,在全部 5,078 个 AI 技能中排名第 2,012 位,在「生活服务」分类(246 个)中排名第 68 位。

累计安装

374

累计下载

4,715

星标

全站排名

#2,012

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

平台	累计安装	累计下载	星标	评论
ClawHub ↗	150	4,452	7	-
SkillHub ↗	374	4,715	7	—

各平台的计数口径不同,统计时间不一致。

这个技能是做什么的

支持线上、本地、混合及自动模式，可按预算、品牌或功能偏好筛选，并按价格、评分或相关性排序。使用 uv；线上搜索需 SerpAPI key，本地与混合搜索需 Google Places key。结果包含商品信息和链接，但价格可能变化，Places 结果不保证门店库存。搜索词发送给 SerpAPI，本地位置发送给 Google Places；可用近似位置，购买或出行前核对链接、卖家和库存。

资料发布于 2026-10-27

可以用来做什么

比较线上与附近来源的商品选项

什么时候用

商品搜索需要预算、偏好和地点筛选时

示例提示词

以下是根据技能文档生成的示例,不代表实际运行结果。

整理预算、偏好与地点，选择搜索模式，并在展示选项时说明库存限制。

月度数据趋势

累计下载4,715

星标7

2026-09 起统计方法调整:同名技能按作者分别统计,并覆盖全部技能。图中虚线为调整前的月份,与之后的数据不直接比较,也不计算跨越调整的增长。

月份	累计下载	环比	星标
2026-09	4,715	—	7
2026-08	4,355	+2.5%	7
2026-07	4,250	+5.9%	7
2026-06	4,015	+3.7%	7
2026-05	3,873	—	7
2026-03	3,568	—	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