← 返回 Skills 市场

Global Price Comparison

Name: Global Price Comparison
Author: wsjwong

作者 Joe Wong · GitHub ↗ · v1.0.2

cross-platform ✓ 安全检测通过

387

总下载

当前安装

版本数

在 OpenClaw 中安装

/install global-price-comparison

功能描述

Discover and compare the same product across multiple countries and source types (official stores, marketplaces, retailers) using Brave and/or Tavily web sea...

使用说明 (SKILL.md)

Global Price Comparison

Use this skill to run a global same-product price scan and output a USD-normalized comparison.

Quick start

# 1) Create a starter CSV template
python scripts/global_price_compare.py template --out /tmp/offers.csv

# 2) (Optional) discover candidate links by country/source type
# Uses Brave and Tavily when available (BRAVE_API_KEY / TAVILY_API_KEY)
python scripts/global_price_compare.py discover \
  --product "iPhone 16 Pro 256GB" \
  --countries US,JP,DE,UK \
  --source-types official_store,marketplace,electronics_retailer \
  --engine all \
  --out /tmp/discover.json

# 3) Fill /tmp/offers.csv with verified offers, then compare
python scripts/global_price_compare.py compare \
  --input /tmp/offers.csv \
  --format markdown

Workflow

Define exact product variant (model/storage/spec).
Run discover to get candidate URLs by market and source type.
Add verified offers to CSV (product,country,currency,source_type,source_name,price,url).
Run compare to normalize all prices to USD and rank best/worst.
Share markdown/JSON/CSV output.

Commands

Template

python scripts/global_price_compare.py template --out /tmp/offers.csv

Discover candidate links

python scripts/global_price_compare.py discover \
  --product "PlayStation 5 Slim" \
  --countries US,JP,DE \
  --source-types official_store,marketplace,electronics_retailer \
  --engine all \
  --count 3 \
  --format markdown

Notes:

discover supports --engine brave|tavily|all (default all).
For all, it uses Brave first and only falls back to Tavily when Brave fails or returns no results.
Set one or both keys as needed: BRAVE_API_KEY, TAVILY_API_KEY.
Source types are intentionally generic (not local-store specific).

Compare offers in USD

python scripts/global_price_compare.py compare \
  --input /tmp/offers.csv \
  --format markdown \
  --out /tmp/comparison.csv

Outputs include:

ranked offers by USD price
delta vs best offer
spread in USD and %

Defaults

Default country set:

US, UK, JP, DE, FR, CA, AU, SG, HK, TW

Default source types:

official_store
marketplace
electronics_retailer
general_retailer

Data/quality guardrails

Before finalizing recommendations:

confirm same model/variant
confirm tax/shipping basis consistency
separate new vs refurbished/used
keep URL + timestamp evidence

Detailed schema + guardrails:

references/data-shape-and-source-types.md

Resources

Script: scripts/global_price_compare.py
Reference: references/data-shape-and-source-types.md

安全使用建议

This skill appears to do what it says: search public search APIs for candidate product links and convert prices to USD. Before installing/providing API keys, consider: (1) Only supply BRAVE_API_KEY and/or TAVILY_API_KEY if you trust those services and are comfortable that the agent will make search requests (keys are sent to those APIs). Use limited-scope or revocable keys where possible. (2) The script makes outbound requests to open.er-api.com for exchange rates; verify you are comfortable with that external dependency. (3) Review the bundled Python script locally if you want to verify it does not transmit data beyond search/discovery results. (4) Because the agent can invoke skills autonomously by default, if you do provide API keys expect the agent to perform network queries without prompting during discovery flows—restrict or rotate keys if needed. If you want higher assurance, request a full file diff or run the script in an isolated environment first.

功能分析

Type: OpenClaw Skill Name: global-price-comparison Version: 1.0.2 The skill is a legitimate tool for global product price comparison and USD normalization. It uses standard search APIs (Brave and Tavily) and a public exchange rate API (open.er-api.com) to perform its stated functions. Analysis of `scripts/global_price_compare.py` and `SKILL.md` shows no evidence of data exfiltration, malicious execution, or prompt injection intended to compromise the agent or the host system.

能力评估

✓ Purpose & Capability

Name/description (global product price discovery and USD normalization) match the included script and docs: the script performs discovery via Brave/Tavily and converts local prices to USD using a public FX API. No unrelated capabilities or credentials are requested.

ℹ Instruction Scope

SKILL.md instructs running the provided script and filling a CSV; the discover command requires BRAVE_API_KEY and/or TAVILY_API_KEY (documented). The runtime instructions do cause outbound HTTP requests to Brave, Tavily, and the public FX API (open.er-api.com) which is consistent with discovery/normalization. This is expected, but you should be aware the skill will send product queries and URLs to those external services when discovery is used.

✓ Install Mechanism

No install spec (instruction-only with a bundled Python script). Nothing is downloaded or written by an installer step. The script runs locally and is the only code artifact.

ℹ Credentials

The skill does not declare required env vars in registry metadata, but the documentation and script reference optional BRAVE_API_KEY and TAVILY_API_KEY for discovery. Requesting these service API keys is proportionate to the discovery feature. There are no unrelated or excessive credential requests.

✓ Persistence & Privilege

always is false and the skill does not request persistent/system-wide privileges. It does not attempt to write or modify other skill configurations based on the provided files.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install global-price-comparison
安装完成后，直接呼叫该 Skill 的名称或使用 /global-price-comparison 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.2

Discovery strategy update: Brave as primary, Tavily as fallback when Brave fails or returns no results.

v1.0.1

Add Tavily Web Search support for discover mode; new --engine brave|tavily|all with merged deduplicated sources.

v1.0.0

- Initial release of the global-price-comparison skill. - Enables discovery and comparison of the same product across multiple countries and source types. - Normalizes all offers to USD for easy ranking and spread analysis. - Supports official stores, marketplaces, and electronics retailers. - Includes workflow, command-line scripts, and quality guardrails for accurate global price checks.

元数据

Slug global-price-comparison

版本 1.0.2

许可证 —

累计安装 2

当前安装数 2

历史版本数 3

常见问题