耦合MCP服务器
使用模型上下文协议（MCP）服务器，Claude AI可以使用Coupang联盟API进行商品搜索和信息查询。
功能
- 商品搜索：使用关键字搜索Coupang商品
- 查询商品详细信息：使用商品ID查看详细信息
- 按类别最佳商品：按类别查看热门商品（支持18个类别）
- 创建深度链接：将Coupang URL转换为包含跟踪代码的快捷URL
- 提供联盟链接：创建Coupang Partners联盟链接
- 异步处理：使用aiohttp高效调用API
要求
- Python 3.13+
- UV（Python包管理器）
- Coupang Partners API认证
安装
方法1：安装PyPI软件包（推荐）
最简单的方法。只需一行即可安装并在Claude Desktop中使用。
pip install mcp-coupang-server\*\*📦 PyPI安装指南请参阅\*\*。
本指南包括：
- 如何安装PyPI软件包
- Claude Desktop设置（包括环境变量）
- 如何解决和更新问题
方法2：Git Clone（开发者）
如果您想亲自修改或贡献源代码，请使用此方法。
# 1. 저장소 클론
git clone https://github.com/space-cap/mcp-coupang-server.git
cd mcp-coupang-server
# 2. 의존성 설치
uv sync
# 3. 환경 변수 설정
# .env 파일을 생성하고 쿠팡 API 키를 입력하세요\*\*📖 Git Clone安装指南请参阅\*\*。
本指南包括：
- 如何安装Python和UV
- Coupang Partners API密钥发放流程
- 如何设置Claude Desktop（Windows/MacOS/Linux）
- 故障排除和测试方法
环境变量
.env 文件示例：
COUPANG_ACCESS_KEY=your_access_key_here
COUPANG_SECRET_KEY=your_secret_key_here
COUPANG_PARTNER_ID=your_partner_id_here
COUPANG_SUB_ID=your_sub_id_here # Optional: Default tracking ID for deeplinks使用方法
本地测试
直接运行MCP服务器：
uv run python main.py与Claude Desktop配合使用
Claude Desktop配置文件（claude_desktop_config.json）添加以下内容：
窗户：
{
"mcpServers": {
"coupang": {
"command": "uv",
"args": [
"--directory",
"C:\\path\\to\\mcp-coupang-server",
"run",
"python",
"main.py"
]
}
}
}macOS/Linux：
{
"mcpServers": {
"coupang": {
"command": "uv",
"args": [
"--directory",
"/path/to/mcp-coupang-server",
"run",
"python",
"main.py"
]
}
}
}有关详细设置，请参阅 docs/claude-desktop-setup.md请参阅。
提供的工具
1.搜索产品
使用关键字搜索Coupang商品。
参数：
keyword（string，必需）：搜索词（例如“laptop”，“iPhone 15”）limit（integer，可选）：结果计数（1-100，默认值：10）
示例：
검색어 "노트북"으로 상품 20개 검색回复：
Found 20 product(s) for '노트북':
1. LG 그램 17인치 노트북
Price: 1,899,000원
ID: 1234567890
🚀 Rocket Delivery
📦 Free Shipping
URL: https://link.coupang.com/...
2. 삼성 갤럭시북 Pro
Price: 1,499,000원
...2.获取产品详细信息
使用商品ID查询详细信息。
参数：
product_id（string，必需）：Coupang商品ID
示例：
상품 ID "1234567890"의 상세 정보 조회回复：
Product Details for ID: 1234567890
Name: LG 그램 17인치 노트북
Price: 1,899,000원
Original Price: 2,299,000원
Discount: 17% (Save 400,000원)
Category: Electronics
Shipping: 🚀 Rocket Delivery, 📦 Free Shipping
Image: https://thumbnail.coupangcdn.com/...
Affiliate URL: https://link.coupang.com/...3.按类别获取最佳产品
查看特定类别的最佳商品。
参数：
category_id（string，必需）：Coupang类别IDlimit（integer，可选）：结果计数（1-100，默认值：20）
可用类别：
1001-女性时尚1002-男性时尚1010-美妆1012-食品1013-厨房用品1014-生活用品1015-家庭装修1016-家电数码1017-运动/休闲1018-汽车用品1019-图书/唱片/DVD1020-玩具/爱好1021-文具/办公室1024-健康/健康食品1025-国内旅行1026-海外旅行1029-宠物用品1030-幼儿时装
示例：
가전디지털 카테고리(1016)의 베스트 상품 10개 조회回复：
Found 10 best product(s) in category '1016':
1. 삼성전자 갤럭시 버즈3 Pro
Price: 289,000원
ID: 8123456789
Category: 가전디지털
🚀 Rocket Delivery
📦 Free Shipping
💰 Discount: 10%
URL: https://link.coupang.com/...
2. LG전자 그램 스타일 노트북
Price: 1,790,000원
...4.创建_部署链接
将Coupang商品URL转换为包含跟踪代码的快捷URL。
参数：
coupang_urls（array，必需）：要转换的Coupang URL列表sub_id（string，可选）：跟踪/Sub ID（环境变量默认值可用）
示例：
다음 쿠팡 URL을 딥링크로 변환해줘:
https://www.coupang.com/vp/products/184614775回复：
Created 1 deeplink(s):
1. Original: https://www.coupang.com/vp/products/184614775
Shortened: https://coupa.ng/blE0dT
Landing: https://link.coupang.com/re/AFFSDP?lptag=AF1234567&pageKey=319834306&itemId=1023216541&vendorItemId=70064597513&traceid=V0-183-5fddb21eaffbb2ef使用案例：
- 将搜索结果中获得的商品URL转换为可跟踪的链接
- 通过一次转换多个商品的URL来管理链接
- 使用Sub ID跟踪各种流量源
项目结构
mcp-coupang-server/
├── src/
│ ├── __init__.py
│ ├── server.py # MCP 서버 메인 로직
│ ├── coupang_client.py # 쿠팡 API 클라이언트
│ ├── models/
│ │ ├── __init__.py
│ │ └── product.py # 상품 데이터 모델
│ ├── tools/
│ │ ├── __init__.py
│ │ ├── search.py # 검색 도구 유틸리티
│ │ └── details.py # 상세정보 도구 유틸리티
│ └── utils/
│ ├── __init__.py
│ ├── config.py # 환경 변수 관리
│ ├── auth.py # HMAC 인증
│ └── categories.py # 카테고리 코드 정의
├── playground/ # 테스트 스크립트 (콘솔)
│ ├── 1_simple_search.py
│ ├── 2_product_details.py
│ ├── 3_compare_products.py
│ ├── 4_price_filter.py
│ ├── 5_rocket_delivery.py
│ ├── 6_category_best.py
│ ├── 7_create_deeplinks.py
│ └── README.md
├── tests/ # 테스트 파일
├── docs/ # 문서
├── main.py # 진입점
├── pyproject.toml # 프로젝트 설정
└── pytest.ini # 테스트 설정发布
您想分发给其他人使用吗？ \*\*🚀 部署指南请参阅\*\*。
部署方法：
- GitHub公共存储库（最简单，推荐）
- 部署PyPI包
- Docker容器
- MCP注册
开发
运行测试
# 모든 테스트 실행
uv run pytest
# 상세 출력과 함께 실행
uv run pytest -v
# 특정 테스트 파일만 실행
uv run pytest tests/test_client.py
# 커버리지와 함께 실행 (pytest-cov 설치 필요)
uv run pytest --cov=src --cov-report=html代码质量
项目符合以下条件：
- 使用Type hints
- 通过Pydantic验证数据
- 异步编程（asyncio/aiohttp）
- 全面的单元测试和集成测试
许可证
该项目在MIT许可下分发。有关详细信息，请访问 许可证 请参考文件。
MIT License - Copyright (c) 2025 space-cap贡献
欢迎您的贡献！ 贡献.md请参阅。
问题报告
如果发现错误或有功能要求 问题请生成。
相关链接
注意事项
作为Coupang Partners活动的一部分，本服务将收取一定的费用。