← Back to Skills Marketplace
udiedrichsen

Shopping Expert

by udiedrichsen · GitHub ↗ · v1.1.0
cross-platform ⚠ suspicious
3443
Downloads
5
Stars
16
Active Installs
2
Versions
Install in OpenClaw
/install 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).
Usage Guidance
This skill appears to do what it says (uses SerpAPI for online results and Google Places for local stores), but review these points before installing or providing API keys: - The registry requires both SERPAPI_API_KEY and GOOGLE_PLACES_API_KEY. If you only need online shopping, you should not have to provide a Google Places key — ask the publisher why both are mandatory or avoid providing the Places key. - The code is a Python script that declares dependencies (requests, urllib3) but the install spec only installs 'uv' via brew. Ensure you run it in an environment with Python 3.10+ and the required Python packages, or the script will fail. - The skill makes external network calls to SerpAPI and Google Places using your API keys. Only supply keys you trust and be aware of possible charges and quota usage from those services. - If you have security concerns, run the script in an isolated environment (container/VM) and inspect or run it with limited API keys (read-only or quota-limited) first. If you want to proceed, ask the publisher to clarify why GOOGLE_PLACES_API_KEY is listed as required in the registry (when SKILL.md states it's only needed for local/hybrid) and to provide an install step for the Python dependencies or a packaged runtime.
Capability Analysis
Type: OpenClaw Skill Name: shopping-expert Version: 1.1.0 The OpenClaw AgentSkills skill bundle 'shopping-expert' is classified as benign. The `SKILL.md` documentation clearly outlines the skill's purpose and required API keys (`SERPAPI_API_KEY`, `GOOGLE_PLACES_API_KEY`), which are directly relevant to its functionality. The `scripts/shop.py` Python code uses standard libraries (`requests`, `urllib3`) to interact with the legitimate SerpAPI and Google Places API endpoints. There is no evidence of data exfiltration, unauthorized command execution, persistence mechanisms, obfuscation, or prompt injection attempts against the agent. All observed behaviors are aligned with the stated purpose of finding and comparing products online and locally.
Capability Assessment
Purpose & Capability
Name/description align with functionality: the code calls SerpAPI for Google Shopping and Google Places for local searches. Requesting SERPAPI_API_KEY and GOOGLE_PLACES_API_KEY is expected for online and local modes respectively.
Instruction Scope
SKILL.md instructs the agent to run the provided Python script via 'uv run'. The runtime instructions and script only reference the two API keys and do not ask for unrelated files or secrets. The SKILL.md correctly documents that GOOGLE_PLACES_API_KEY is only required for local/hybrid modes, but the registry's required env list contradicts that (see environment_proportionality).
Install Mechanism
Install spec is a brew formula for 'uv' which matches the example 'uv run ...' usage. This is a low-risk install mechanism compared with arbitrary downloads. However, the script is Python and declares Python package dependencies (requests, urllib3) in its header, but the install spec does not install those Python dependencies or ensure Python is present—this mismatch may cause runtime failures.
Credentials
Registry requires both SERPAPI_API_KEY and GOOGLE_PLACES_API_KEY. SKILL.md and the code indicate SERPAPI is needed for online/hybrid and GOOGLE_PLACES only for local/hybrid. Requiring both keys unconditionally is disproportionate if a user only wants online-only searches. PrimaryEnv set to SERPAPI_API_KEY is appropriate, but forcing a Places key when not needed is an unnecessary credential request.
Persistence & Privilege
The skill does not request always:true and does not declare any system-wide configuration changes. It runs as an on-demand script and has normal autonomous-invocation defaults; no elevated persistence or cross-skill modification is present.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install shopping-expert
  3. After installation, invoke the skill by name or use /shopping-expert
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Default to German search (Amazon.de, Google.de), add --country parameter, EUR currency support
v1.0.0
Initial release: dual-mode shopping with SerpAPI Google Shopping for online products and Google Places API for local stores. Smart scoring algorithm, budget parsing, preference matching, and both Markdown and JSON output formats.
Metadata
Slug shopping-expert
Version 1.1.0
License
All-time Installs 17
Active Installs 16
Total Versions 2
Frequently Asked Questions

What is 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). It is an AI Agent Skill for Claude Code / OpenClaw, with 3443 downloads so far.

How do I install Shopping Expert?

Run "/install shopping-expert" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Shopping Expert free?

Yes, Shopping Expert is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Shopping Expert support?

Shopping Expert is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Shopping Expert?

It is built and maintained by udiedrichsen (@udiedrichsen); the current version is v1.1.0.

💬 Comments