# Send Shopping Expert to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "shopping-expert",
    "name": "Shopping Expert",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/udiedrichsen/shopping-expert",
    "canonicalUrl": "https://clawhub.ai/udiedrichsen/shopping-expert",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/shopping-expert",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=shopping-expert",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/shop.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "shopping-expert",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-08T19:22:29.806Z",
      "expiresAt": "2026-05-15T19:22:29.806Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=shopping-expert",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=shopping-expert",
        "contentDisposition": "attachment; filename=\"shopping-expert-1.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "shopping-expert"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/shopping-expert"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/shopping-expert",
    "downloadUrl": "https://openagent3.xyz/downloads/shopping-expert",
    "agentUrl": "https://openagent3.xyz/skills/shopping-expert/agent",
    "manifestUrl": "https://openagent3.xyz/skills/shopping-expert/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/shopping-expert/agent.md"
  }
}
```
## Documentation

### Shopping Expert

Find and compare products online and locally with smart recommendations.

### Quick Start

Find products online:

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

Search with budget constraint:

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

Find local stores:

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

Hybrid search (online + local):

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

Search US stores:

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
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: udiedrichsen
- Version: 1.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-08T19:22:29.806Z
- Expires at: 2026-05-15T19:22:29.806Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/shopping-expert)
- [Send to Agent page](https://openagent3.xyz/skills/shopping-expert/agent)
- [JSON manifest](https://openagent3.xyz/skills/shopping-expert/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/shopping-expert/agent.md)
- [Download page](https://openagent3.xyz/downloads/shopping-expert)