Kleinanzeigen

kleinanzeigen-mcp

一个只读、遵守 robots 规则的 MCP 服务，基于 kleinanzeigen.de（德国分类信息网站）。

---

功能

工具	用途	请求数
search_listings	返回符合搜索条件的一页商品信息。	1
get_listing	按广告 ID 获取一条商品信息的完整内容。	1
get_shop	获取一位商业卖家的资料和商品信息。	1
find_category	查找与名称匹配的分类 ID。	0 — 内置数据集
find_location	查找与名称匹配的地点 ID。	0 — 内置数据集
find_shop	查找与名称匹配的商业卖家店铺别名。	1

---

安装

需要 Node 22 或更高版本。以下四种渠道安装的都是同一发布版本，区别仅在于由谁负责获取，彼此之间不会有任何同步。

渠道	适用对象	命令
npm / npx — 首选	任何 MCP 客户端用户	npx -y kanzeigen-mcp
Claude Code	一行命令，无需 JSON	claude mcp add kleinanzeigen -- npx -y kanzeigen-mcp
Claude Desktop	完全无需编辑 JSON	下载发布版本中的 .mcpb 并打开
Claude Code plugin	同时安装服务和技能	/plugin marketplace add IIxauII/kleinanzeigen-mcp
从克隆仓库运行	开发	开发

npm / npx — 适用于任何 MCP 客户端

软件包名为 kanzeigen-mcp。

无需安装，也无需构建。将客户端指向 npx，让它在首次运行时获取软件包：

{
  "mcpServers": {
    "kleinanzeigen": {
      "command": "npx",
      "args": ["-y", "kanzeigen-mcp"]
    }
  }
}

将这段内容放入客户端的配置文件中：Claude Desktop 使用 claude_desktop_config.json，Claude Code 使用 .mcp.json，其他客户端则使用相应的配置文件。之后重启客户端。

要手动验证（无需客户端）：

npx -y kanzeigen-mcp

Claude Code

claude mcp add kleinanzeigen -- npx -y kanzeigen-mcp

所有环境变量赋值都必须放在 -- 之前。 -- 之后的内容是 Claude Code 要运行的命令，因此变量若放在其后，就会成为 npx 的参数，而非环境变量：

claude mcp add kleinanzeigen -e KLEINANZEIGEN_MCP_RATE_LIMIT_MS=3000 -- npx -y kanzeigen-mcp

Claude Desktop — MCPB

从最新发布版本下载 kanzeigen-mcp-<version>.mcpb 并打开。Claude Desktop 会安装它，并以表单字段的形式提供下方的唯一可调选项，因此无需在这里使用配置文件。

选择此方式前，有两点值得了解。该捆绑包未经签名，因此安装对话框会发出警告——自行签名无法通过其自身验证，而获取正式证书需要付费，目前无人购买。此外，这种格式没有更新机制：已安装的 .mcpb 会一直停留在下载当天的版本，也不会收到任何更新提示。

Claude Code plugin — 服务和技能

/plugin marketplace add IIxauII/kleinanzeigen-mcp
/plugin install kanzeigen@kanzeigen

---

配置

KLEINANZEIGEN_MCP_RATE_LIMIT_MS — 请求之间的最短间隔，单位为毫秒。

• 未设置时默认为 1500 ms。

{
  "mcpServers": {
    "kleinanzeigen": {
      "command": "npx",
      "args": ["-y", "kanzeigen-mcp"],
      "env": { "KLEINANZEIGEN_MCP_RATE_LIMIT_MS": "3000" }
    }
  }
}

---

开发

从克隆的仓库运行。这是开发路径，而不是安装渠道；只有通过此路径，漂移检查和样本捕获脚本才能在仓库树中运行。

git clone [email protected]:IIxauII/kleinanzeigen-mcp.git
cd kleinanzeigen-mcp
npm install
npm run build

npm run build 会在 dist/index.js 生成单文件 ESM 包，并在其旁边生成两个配套数据集。使用绝对路径将客户端指向该文件：

{
  "mcpServers": {
    "kleinanzeigen": {
      "command": "node",
      "args": ["/absolute/path/to/kleinanzeigen-mcp/dist/index.js"]
    }
  }
}

npm test           # the whole suite
npm run typecheck  # tsc --noEmit, which is the real typecheck
npm run build      # tsup, into dist/

解析器测试使用已提交的样本：这些样本由开发时脚本在服务器之外手动捕获，仅保留解析器实际读取的 DOM，并经过脱敏。脱敏规则是：捕获的标记中所有涉及个人或可识别身份的信息都必须脱敏，包括解析器从不读取的属性。只针对解析器会处理的字段进行脱敏，曾导致合作伙伴广告 ID 和店铺名称残留在跟踪属性中。某项测试会对此规则进行验证。

维护者流程——重新生成两个打包数据集、运行漂移检查并发布版本——见 docs/maintenance.md，因为这份文档面向的是在克隆仓库中操作的人，而非安装了本项目的人。

延伸阅读：SPEC.md 介绍完整契约；CONTEXT.md 介绍代码库中所有名称所使用的词汇；docs/adr/ 记录了相关决策。