内容
# 🛒 Coupang MCP 服务器
Coupang（酷邦）商品信息查询的 [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) 服务器。
Claude Code, Cursor, VS Code Copilot, ChatGPT Desktop 等支持 MCP 的 AI 客户端可以通过该服务器以自然语言执行 Coupang 商品搜索、价格比较、库存确认、评论查询等操作。
## 主要功能
| 工具 | 说明 |
|------|------|
| `coupang_search_products` | 通过关键词搜索商品（支持按推荐顺序、价格、销量排序） |
| `coupang_get_price` | 查询商品详细价格（包括折扣价、原价、折扣率、配送信息） |
| `coupang_check_inventory` | 查询库存状态、配送信息、卖家信息 |
| `coupang_get_reviews` | 查询商品评论（包括评分、内容、发表日期） |
## 运行方式
通过 Chrome 浏览器的 [CDP (Chrome DevTools Protocol)](https://chromedevtools.github.io/devtools-protocol/) 连接到 Coupang 网站，无需额外的 API 密钥。
```
AI 客户端 → MCP 服务器 → Chrome CDP → coupang.com
```
## 安装
### 1. 克隆项目并构建
```bash
git clone https://github.com/burlesquer/coupang-mcp.git
cd coupang-mcp
npm install
npm run build
```
### 2. 安装 Playwright
```bash
npx playwright install chromium
```
### 3. 启动 Chrome 调试模式
MCP 服务器需要 Chrome 以调试模式运行，以建立连接。
**Windows（Win+R 或 PowerShell）：**
```
C:\Program Files\Google\Chrome\Application\chrome.exe --remote-debugging-port=9222 --user-data-dir="C:/ChromeTEMP"
```
**macOS：**
```bash
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir="/tmp/ChromeTEMP"
```
**Linux：**
```bash
google-chrome --remote-debugging-port=9222 --user-data-dir="/tmp/ChromeTEMP"
```
> **重要：** 在运行调试模式前，请确保已关闭所有 Chrome 实例。 `--user-data-dir` 参数指定了独立的配置文件，以避免与现有的 Chrome 实例冲突。
## MCP 客户端配置
### Claude Code
**全局注册（所有项目均适用）：**
```bash
claude mcp add coupang node /path/to/coupang-mcp/dist/index.js
```
**项目范围（仅在当前项目中使用）：**
在项目根目录创建 `.mcp.json`：
```json
{
"mcpServers": {
"coupang": {
"command": "node",
"args": ["/path/to/coupang-mcp/dist/index.js"]
}
}
}
```
### Claude Desktop
在 `Settings → Developer → Edit Config` 中编辑 `claude_desktop_config.json`：
```json
{
"mcpServers": {
"coupang": {
"command": "node",
"args": ["/path/to/coupang-mcp/dist/index.js"]
}
}
}
```
### Cursor
在 Settings → MCP Servers 中添加：
```json
{
"mcpServers": {
"coupang": {
"command": "node",
"args": ["/path/to/coupang-mcp/dist/index.js"]
}
}
}
```
### 其他支持 MCP 的客户端
VS Code（Copilot）、Windsurf、ChatGPT Desktop、Cline 等所有支持 MCP 的客户端均可使用相同的配置格式。
### 环境变量（可选）
| 变量 | 默认值 | 说明 |
|------|--------|------|
| `COUPANG_CDP_URL` | `http://localhost:9222` | Chrome CDP 连接 URL |
## 使用示例
在 MCP 客户端中直接用自然语言请求：
```
"在 Coupang 上搜索无线耳机"
"比较 AirPods Pro 的价格"
"查询商品 ID 8443849352 的库存"
"显示商品 ID 8443849352 的评论"
"查找 Mac Mini 的低价选项"
```
### 搜索排序选项
| 选项 | 说明 |
|------|------|
| `scoreDesc` | Coupang 推荐顺序（默认） |
| `salePriceAsc` | 按价格从低到高 |
| `salePriceDesc` | 按价格从高到低 |
| `saleCountDesc` | 按销量从高到低 |
## 技术栈
- **TypeScript** + **Node.js**
- **[@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk)** — MCP 协议实现
- **[Playwright](https://playwright.dev/)** — 连接 Chrome CDP 和页面解析
- **[Zod](https://zod.dev/)** — 输入模式验证
## 限制
- Chrome 必须以调试模式运行（`--remote-debugging-port=9222`）
- 如果 Coupang 网站结构发生变化，可能需要更新选择器
- 过多的请求可能会导致 Coupang 短暂封禁
## 许可证
ISC
