shopping-expert

17
5
Source

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).

Install

mkdir -p .claude/skills/shopping-expert && curl -L -o skill.zip "https://mcp.directory/api/skills/download/2438" && unzip -o skill.zip -d .claude/skills/shopping-expert && rm skill.zip

Installs to .claude/skills/shopping-expert

About this skill

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

a-stock-analysis

openclaw

A股实时行情与分时量能分析。获取沪深股票实时价格、涨跌、成交量,分析分时量能分布(早盘/尾盘放量)、主力动向(抢筹/出货信号)、涨停封单。支持持仓管理和盈亏分析。Use when: (1) 查询A股实时行情, (2) 分析主力资金动向, (3) 查看分时成交量分布, (4) 管理股票持仓, (5) 分析持仓盈亏。

757288

fivem

openclaw

Fix, create, or validate FiveM server resources for QBCore/ESX (config.lua, fxmanifest.lua, items, housing/furniture, scripts, MLOs). Use when asked to debug resource errors, convert ESX↔QB, update fxmanifest versions, add items, or source scripts from GitHub. Also use for SSH key generation for SFTP access.

424261

research-paper-writer

openclaw

Creates formal academic research papers following IEEE/ACM formatting standards with proper structure, citations, and scholarly writing style. Use when the user asks to write a research paper, academic paper, or conference paper on any topic.

81168

keyword-research

openclaw

Discovers high-value keywords with search intent analysis, difficulty assessment, and content opportunity mapping. Essential for starting any SEO or GEO content strategy.

443107

html-to-ppt

openclaw

Convert HTML/Markdown to PowerPoint presentations using Marp

33789

weread

openclaw

WeChat Reading (微信读书) CLI tool for fetching notes and highlights. Use when: (1) user asks about weread/微信读书 notes or highlights, (2) fetching today's or recent reading notes, (3) exporting book highlights, (4) managing reading bookshelf, (5) any task involving reading notes from WeChat Reading.

11385

You might also like

ui-ux-pro-max

nextlevelbuilder

"UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 8 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient."

2,8892,530

pdf-to-markdown

aliceisjustplaying

Convert entire PDF documents to clean, structured Markdown for full context loading. Use this skill when the user wants to extract ALL text from a PDF into context (not grep/search), when discussing or analyzing PDF content in full, when the user mentions "load the whole PDF", "bring the PDF into context", "read the entire PDF", or when partial extraction/grepping would miss important context. This is the preferred method for PDF text extraction over page-by-page or grep approaches.

3,8201,662

flutter-development

aj-geddes

Build beautiful cross-platform mobile apps with Flutter and Dart. Covers widgets, state management with Provider/BLoC, navigation, API integration, and material design.

2,1561,645

drawio-diagrams-enhanced

jgtolentino

Create professional draw.io (diagrams.net) diagrams in XML format (.drawio files) with integrated PMP/PMBOK methodologies, extensive visual asset libraries, and industry-standard professional templates. Use this skill when users ask to create flowcharts, swimlane diagrams, cross-functional flowcharts, org charts, network diagrams, UML diagrams, BPMN, project management diagrams (WBS, Gantt, PERT, RACI), risk matrices, stakeholder maps, or any other visual diagram in draw.io format. This skill includes access to custom shape libraries for icons, clipart, and professional symbols.

2,2691,469

godot

bfollington

This skill should be used when working on Godot Engine projects. It provides specialized knowledge of Godot's file formats (.gd, .tscn, .tres), architecture patterns (component-based, signal-driven, resource-based), common pitfalls, validation tools, code templates, and CLI workflows. The `godot` command is available for running the game, validating scripts, importing resources, and exporting builds. Use this skill for tasks involving Godot game development, debugging scene/resource files, implementing game systems, or creating new Godot components.

2,4741,225

nano-banana-pro

garg-aayush

Generate and edit images using Google's Nano Banana Pro (Gemini 3 Pro Image) API. Use when the user asks to generate, create, edit, modify, change, alter, or update images. Also use when user references an existing image file and asks to modify it in any way (e.g., "modify this image", "change the background", "replace X with Y"). Supports both text-to-image generation and image-to-image editing with configurable resolution (1K default, 2K, or 4K for high resolution). DO NOT read the image file first - use this skill directly with the --input-image parameter.

1,961969