内容
# sbazar-mcp
[](https://www.npmjs.com/package/sbazar-mcp)
[](./LICENSE)
一个适用于 [Sbazar.cz](https://www.sbazar.cz) 的 [MCP](https://modelcontextprotocol.io) 服务器，该网站是捷克的分类广告市场。允许 Claude（或任何 MCP 客户端）搜索 Sbazar 列表并获取完整的商品详情。
## 工具列表
- **`sbazar_search`** — 按关键词搜索列表，可选价格范围和地区过滤。
- **`sbazar_get_item`** — 获取指定 ID 或 URL 的列表的完整详情（描述、图片、卖家等）。
## 安装
需要 Node.js 18+。
服务器已发布到 npm 并通过 `npx` 运行 — 无需克隆或构建。
### Claude 桌面版
添加到 `~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）或 `%APPDATA%\Claude\claude_desktop_config.json`（Windows）：
```json
{
"mcpServers": {
"sbazar": {
"command": "npx",
"args": ["-y", "sbazar-mcp"]
}
}
}
```
### Claude 代码
```bash
claude mcp add sbazar -- npx -y sbazar-mcp
```
或添加到项目中的 `.mcp.json` 或 `~/.claude.json`:
```json
{
"mcpServers": {
"sbazar": {
"command": "npx",
"args": ["-y", "sbazar-mcp"]
}
}
}
```
### Cursor
添加到 `~/.cursor/mcp.json`（或项目特定的 `.cursor/mcp.json`）：
```json
{
"mcpServers": {
"sbazar": {
"command": "npx",
"args": ["-y", "sbazar-mcp"]
}
}
}
```
### 其他 MCP 客户端
任何支持 stdio MCP 服务器的客户端都可以将其启动为 `npx -y sbazar-mcp`.
## 使用示例
连接后，您可以向助手提问：
- *"在 Sbazar 上查找布拉格拉格售价低于 8000 克朗的 Steam Deck。*
- *"获取 `https://www.sbazar.cz/inzerat/123456789-...` 的详情。"*
- *"在 Sbazar 上搜索 iPhone 14，最高 15000 克朗。"*
## 工具参考
### `sbazar_search`
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
| `phrase` | 字符串 | 是 | 搜索查询（例如 `"steam deck"`）。 |
| `limit` | 数字 | 否 | 最大结果数，1–60。默认 20。 |
| `price_from` | 数字 | 否 | 最低价格，单位为捷克克朗。 |
| `price_to` | 数字 | 否 | 最高价格，单位为捷克克朗。 |
| `locality` | 字符串 | 否 | 按城市/地区过滤（例如 `"Praha"`）。在客户端应用。 |
### `sbazar_get_item`
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
| `id_or_url` | 字符串 | 是 | 商品 ID 或完整的 Sbazar.cz 列表 URL。 |
## 开发
```bash
git clone https://github.com/basta/sbazar-mcp
cd sbazar-mcp
npm install
npm run build
npm start
```
进行内部开发体验（TS 直接通过 `tsx` 运行）：
```bash
npm run dev
```
## 许可证
MIT — 请参阅 [LICENSE](./LICENSE)。
## 免责声明
这是一个非官方的、社区建设的项目。它与 Sbazar.cz 或 Seznam.cz 无关，也不得到他们的认可。
