内容
# rozetka-mcp
一个MCP服务器，封装了[Rozetka.com.ua](https://rozetka.com.ua/)的公开只读API，您可以在MCP-aware客户端（Claude Code、Claude Desktop等）中搜索产品、浏览类别、阅读评论和查找卖家。
只读 - 无购物车，无订单，无身份验证。
## 工具
6个组共23种工具：
**搜索与目录**
- `search_products(text, page, sort, section_id, producer, seller, price_min, price_max, state)` — 全文搜索。
- `browse_category(category_id, page, sort, seller, state, price_min, price_max, producer, custom_filters)` — 浏览类别并应用筛选。
- `browse_url(url)` — 直接加载Rokseta目录网址。
- `get_category(category_id)` — 类别元数据 + 面包屑。
- `get_category_tree()` — 完整的大型菜单（缓存）。
- `get_super_portals()` — 首页类别ID。
**产品**
- `get_product(product_id, is_group)` — 最丰富的单一产品载荷。
- `get_products(product_ids)` — 批量详情，最多60个ID。
- `get_product_prices(product_ids)` — 廉价的多产品价格刷新。
- `get_product_description(product_id)` — 长篇描述 + 富媒体块。
- `get_product_characteristics(product_id)` — 分组的规格。
- `get_product_seo_tags(product_id)` — 相关的交叉链接标签。
- `get_product_marketing(product_id)` — 标签 + 促销 + 超级优惠 + 赠品（组合）。
- `get_product_guarantee(product_id, category_id)` — 保修信息。
- `get_product_accessories(product_id)` — 推荐的配件。
**评论**
- `list_reviews(product_id, page, sort, limit, type, top_seller_id)` — 评论或问答（`type='comment'|'question'`）。
- `get_review_summary(product_ids)` — 总体评分 + 按星级计数。
- `list_review_attachments(product_id, attachment_type, limit, offset)` — 评论者发布的照片/视频。
**卖家**
- `get_seller(seller_owox_id)` — 卖家信息（Rokseta本身为`5`）。
- `get_seller_by_name(name)` — 按URL slug查找。
- `get_seller_rating(seller_owox_id)` — 完整的评分明细。
**地点**
- `get_user_location()` — 基于IP的城市检测。
- `get_city(city_id)` — 按UUID的城市详情。
## 安装
需要Python 3.10+。使用[uv](https://docs.astral.sh/uv/)：
```sh
git clone https://github.com/jlight/rozetka-mcp.git
cd rozetka-mcp
uv sync
```
## 运行
```sh
uv run rozetka-mcp
```
服务器通过stdio使用MCP，并为Rokseta请求乌克兰内容（`lang=ua`，`country=UA`）。
## 连接到Claude Code
```sh
claude mcp add rozetka -- uv --directory /absolute/path/to/rozetka-mcp run rozetka-mcp
```
或手动将其添加到Claude Code MCP配置中：
```json
{
"mcpServers": {
"rozetka": {
"command": "uv",
"args": ["--directory", "/absolute/path/to/rozetka-mcp", "run", "rozetka-mcp"]
}
}
}
```
## 工作原理
大多数Rokseta API主机（`common-api`，`xl-catalog-api`，`product-api`）都位于Cloudflare后面，并拒绝普通的`requests` / `httpx`流量。此服务器使用[`curl_cffi`](https://github.com/yifeikong/curl_cffi)并带有Chrome TLS伪装，看起来像一个真正的浏览器，这是社区包装器（如[`ALERTua/rozetka_api`](https://github.com/ALERTua/rozetka_api））使用的相同方法。
Rokseta API是非官方的 - 端点可能会更改。请将其视为尽力而为。
## 许可证
MIT。参见[LICENSE](LICENSE)。
