Price Compare MCP

台灣電商比價工具 MCP Server，支援 momo、PChome、Coupang、ETMall、Rakuten、Yahoo購物中心、Yahoo拍賣價格搜尋與比較。

目前版本：v0.4.0 | 更新日誌

功能

工具	說明
`compare_prices`	跨平台搜尋最低價商品

參數說明

compare_prices

參數	類型	預設值	說明
`query`	str	(必填)	搜尋關鍵字
`top_n`	int	20	回傳筆數
`min_price`	int	0	最低價格過濾 (0=不過濾)
`max_price`	int	0	最高價格過濾 (0=不過濾)
`require_words`	list[list[str]]	None	關鍵字分組過濾。組與組是 AND 關係，組內是 OR 關係。例：[["SONY", "索尼"], ["電視", "TV"]] = (SONY OR 索尼) AND (電視 OR TV)
`include_auction`	bool	False	是否包含 Yahoo 拍賣競標商品 (預設僅含立即購買)
`platform`	str	None	指定單一平台搜尋。None = 搜尋所有平台。可選：pchome, momo, coupang, etmall, rakuten, yahoo_shopping, yahoo_auction

回傳值：str (TOON 格式) - 壓縮序列化的產品列表，以降低 LLM token 消耗

使用範例

# 搜尋所有平台最低價（預設）
compare_prices(query="SONY 50吋電視")

# 只搜尋 momo 平台
compare_prices(query="SONY 50吋電視", platform="momo")

# 只搜尋 PChome 平台的 Apple 產品
compare_prices(query="Apple AirPods Pro", platform="pchome")

# 搜尋特定品牌（符合其中一個即可）
compare_prices(
    query="無線耳機",
    require_words=[["Apple", "Beats", "Sony"]]  # 品牌過濾
)

# 複雜過濾：品牌 AND 功能
compare_prices(
    query="藍牙喇叭",
    require_words=[["JBL", "BOSE"], ["防水", "IP67"]],  # (JBL OR BOSE) AND (防水 OR IP67)
    min_price=500,
    max_price=5000
)

# 搜尋包含 Yahoo 拍賣競標商品
compare_prices(query="iPhone 15", include_auction=True)

提示：Coupang 等平台的搜尋結果有時會包含不相關的低價商品，使用 require_words 可有效過濾。

安裝

pip install mcp-taiwan-price-compare
# 或
uv pip install mcp-taiwan-price-compare

MCP Server 配置

Claude Desktop / Claude Code

CLI 快速安裝（推薦）：

claude mcp add price-compare -- uv run --directory /path/to/price_compare price-compare-mcp

手動編輯配置檔：

系統	路徑
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

{
  "mcpServers": {
    "price-compare": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/price_compare", "price-compare-mcp"]
    }
  }
}

Gemini CLI

安裝 Gemini CLI：

npm install -g @google/gemini-cli@latest

編輯 ~/.gemini/settings.json：

{
  "mcpServers": {
    "price-compare": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/price_compare", "price-compare-mcp"]
    }
  }
}

ChatGPT（Developer Mode）

需要 ChatGPT Plus/Pro/Team/Enterprise 方案

ChatGPT 僅支援遠端 HTTPS MCP server，需先部署或使用 ngrok：

# 本地開發：使用 ngrok 建立 HTTPS 通道
ngrok http 8000

開啟 ChatGPT → Settings → Developer mode → 啟用
Settings → Connectors → Create
輸入 MCP server URL（ngrok 提供的 HTTPS URL）

詳細說明：OpenAI MCP 文件

Perplexity AI（Mac 本地）

目前 Perplexity 僅支援 macOS 桌面版的本地 MCP

開啟 Perplexity Mac App → Settings → Connectors
首次使用需安裝 Helper：點擊安裝 PerplexityXPC
點擊 Add Connector → Simple 分頁
填入設定：
- Server Name: price-compare
- Command: uvx --from mcp-taiwan-price-compare price-compare-mcp
測試：輸入「幫我搜尋 iPhone 16 最低價」

詳細說明：Perplexity MCP 文件

其他安裝方式

直接使用 (CLI)

除了作為 MCP Server，你也可以直接在終端機使用此工具進行比價：

# 安裝後可直接使用系統指令
price-compare "Nintendo Switch"
price-compare "Sony 耳機" --top 5 --min 1000 --max 5000 --desc

# 或透過 uv 執行 (如果你沒有全域安裝)
uv run price-compare "Nintendo Switch"

CLI 參數說明

參數	說明
`query`	搜尋關鍵字 (必填)
`-n`, `--top`	顯示筆數 (預設: 10)
`--min`	最低價格過濾
`--max`	最高價格過濾
`--desc`	價格由高到低排序 (預設為低到高)

使用 uvx（無需安裝）：

{
  "mcpServers": {
    "price-compare": {
      "command": "uvx",
      "args": ["--from", "mcp-taiwan-price-compare", "price-compare-mcp"]
    }
  }
}

使用 npx + stdio wrapper：

mcp-taiwan-price-compare