# price-comparison

price-comparison is a Claude Code skill that searches catalog products, compares merchant offers, and checks price history. It also handles access-key setup.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 332 repo stars
- Author: hhtower
- License: GPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hhtower/price-comparison/tree/HEAD/skills/price-comparison/SKILL.md
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/price-comparison

## What it does

price-comparison searches a connected catalog, retrieves merchant offers, and compares recorded price history. It responds to requests about that catalog and to setup requests, rather than general online shopping or model API pricing.

A bundled Node.js script provides product search, catalog checks, tool schemas, offer retrieval, and history queries. Comparisons use matching currency, duration, quantity, and delivery type while accounting for price status, stock, and expiry. An incomplete response is not treated as a complete quote. Prices are snapshots; the merchant controls the final amount and stock.

The helper needs Node.js 22+ and `PRICE_COMPARISON_API_KEY`. Set `PRICE_COMPARISON_URL` to point at a self-hosted service; the default is `https://price.yufu.pub`. No MCP client setup, package installation, or model API key is required.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add hhtower/price-comparison --skill price-comparison -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/price-comparison/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/price-comparison/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add hhtower/price-comparison --skill price-comparison -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/price-comparison/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add hhtower/price-comparison --skill price-comparison -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/price-comparison/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install hhtower/price-comparison skills/price-comparison
```

2. **Manually: put the files in place**
- File: `.github/skills/price-comparison/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add hhtower/price-comparison --skill price-comparison -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/hhtower/price-comparison --path skills/price-comparison
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/price-comparison/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/hhtower/price-comparison/tree/HEAD/skills/price-comparison/SKILL.md

## When to use it
- find a product in the connected catalog
- compare offers from different merchants
- retrieve price history in one currency
- spot incomplete quote coverage
- configure catalog access

## Example prompts
- Search the catalog for ChatGPT Plus and compare offers by currency, duration, and delivery type.
- Show the selected product's price history and flag daily lows that come from different merchants.
- Run `setup` and configure the price-comparison access key.

## Similar
- [Bikefuchs — Bike Parts Price Comparison](https://affpapa.org/en/nevibecode/mcp/bikefuchs-bike-parts-price-comparison.md) — MCP server
- [pricewin-price-comparison](https://affpapa.org/en/nevibecode/skills/pricewin-price-comparison.md) — skill · 10500 installs
- [idealo MCP Server](https://affpapa.org/en/nevibecode/mcp/idealo-mcp-server.md) — MCP server · ★ 29 repo stars
- [aibijia-price-comparison](https://affpapa.org/en/nevibecode/skills/aibijia-price-comparison.md) — skill · 287 installs
- [firecrawl-build-onboarding](https://affpapa.org/en/nevibecode/skills/firecrawl-build-onboarding.md) — skill · 62600 installs
- [한국 PC 부품 가격비교](https://affpapa.org/en/nevibecode/mcp/pc.md) — MCP server · ★ 12 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
