内容
# mercapi-mcp
让您的 AI 助手以简单语言搜索日本最大的二手市场 [Mercari](https://jp.mercari.com) ，无需爬虫，无需手动筛选。这是一个基于 [MCP](https://modelcontextprotocol.io) 协议的 [mercapi](https://github.com/zhu-kai/mercapi-node) 服务器。
您可以提出以下问题：
> "在 Mercari 上以低于 ¥30,000 的价格出售的 Daiwa Saltiga 鱼竿，优先显示最便宜的。"
>
> "这个卖家的评分是多少，他们还出售什么商品？"
>
> "有没有即将结束的复古 Game Boy 游戏拍卖？"
助手会调用以下工具，获取紧凑的结果，并附带 `jp.mercari.com` 的直接链接，然后为您分析。
## 设置
需要 Node ≥ 20。
**Claude 代码**
```bash
claude mcp add mercari -- npx -y mercapi-mcp
```
**Claude 桌面版 / Cursor** — 添加到您的 `mcpServers` 配置：
```json
{
"mcpServers": {
"mercari": {
"command": "npx",
"args": ["-y", "mercapi-mcp"]
}
}
}
```
无需 API 密钥或账户。
## 工具
| 工具 | 用途 |
|---|---|
| `search_items` | 按关键词搜索商品列表 |
| `get_item` | 获取单个商品的详细信息 |
| `get_seller` | 获取卖家的资料和评分 |
| `get_seller_items` | 获取卖家所有的商品列表 |
**`search_items`** 是主要工具。助手可以选择：
- **过滤器** — `priceMin`/`priceMax`（日元），`condition`（从 `brand_new` 到 `bad`），`status`（`on_sale`/`sold`/`all`），`excludeKeyword`
- **排序** — `score`（默认），`price_asc`，`price_desc`，`newest`，`likes`
- **返回数量** — `limit`（1–120，默认 20）和 `detail`（`compact` 或 `full`）
- **输出格式** — `format`（`text`，默认，或 `json` 用于原始结构化数据）
- **分页** — 传递 `pageToken` 从之前的搜索结果
所有四个工具都接受 `format: "json"` 以返回结构化对象（mercapi 解析的字段）而不是人类可读的文本 — 这对于后续的程序化使用非常有用。
拍卖列表会标记当前出价数量和截止日期；`get_item` 返回完整的拍卖状态（起始价格，最高出价，结束时间）。使用日语关键词可以获得最佳结果。
## 工作原理
结果以紧凑的结构化文本返回，而不是原始 JSON — 大约 90% 的信息相同，但令 AI 助手可以扫描更多列表而不会超出其上下文限制。每个商品都包含其 `https://jp.mercari.com/item/{id}` 链接，以便您可以打开它找到的任何商品。
## 注意事项
- **非官方 API。** 请求直接从您的机器 IP 地址发送到 Mercari 的私有端点。适合交互式使用；大量自动化查询可能会被限速。
- API 健康状态持续在上游监控 — [状态页面](https://zhu-kai.github.io/mercapi-node/)。
- 这是一个只读搜索工具。它无法购买、竞价、发送消息或列出商品。
## 鸣谢
封装了 [mercapi](https://www.npmjs.com/package/mercapi) （Node），它本身是 [take-kun/mercapi](https://github.com/take-kun/mercapi) （Python）的端口，该项目反向工程了 Mercari API。
## 许可证
MIT
