用途
marktplaats-mcp 是一个 MCP（模型上下文协议）服务器，连接荷兰 Marktplaats.nl 和比利时 2dehands.be 两个二手分类信息平台。它让 AI 智能体能够以自然语言搜索商品、筛选分类属性、查看卖家信誉、比较价格，并持续监控新发布的广告。项目为独立开源项目，与 Marktplaats、2dehands 或 Adevinta 无关联。
主要能力
- 搜索与筛选：跨站搜索荷兰与比利时 listings，可按分类属性过滤，支持语言限定（荷兰语或法语）。
- 广告详情与卖家审核：查看广告详情，检查卖家评价与可信度，进行比价和价格统计。
- 新广告监控：对搜索结果或已保存搜索进行监控，发现新上架广告。
- 账号操作（需本地服务器并登录）：读取和发送站内消息、出价、管理收藏和用户自己的广告。
- 输出结构化：每个工具返回带真实 schema 的结构化输出。提供两个提示词模板：bargain_hunt 和 vet_listing，封装常见工作流。
使用方式
免安装（只读）：将托管地址 https://marktplaats-mcp.jaspnerd.dev/mcp 作为自定义连接器添加到 claude.ai（设置 → 连接器，免费版与移动端均可用）、ChatGPT、Mistral Le Chat、Perplexity 或 Gemini 应用。
Claude Code：一条命令即可。
其他客户端：先安装 uv（macOS 使用 brew install uv，Windows 使用 winget install --id=astral-sh.uv -e），然后添加标准 MCP 配置，运行 uvx marktplaats-mcp。项目文档提供 40 个客户端（Cursor、VS Code、Codex、Gemini CLI、Cline、Windsurf、JetBrains、Zed、opencode、Goose 等）的分步说明及各操作系统配置路径。
使用自己的账号：Marktplaats 没有公开 API，登录使用短信双因素认证，因此服务器不会索要密码，而是从已登录的浏览器复制会话。会话存储在 ~/.config/marktplaats-mcp/session.json，仅用户本人可读。登录后重启 MCP 客户端，账号工具出现。
各平台注意事项： macOS：系统默认阻止命令行工具读取浏览器数据，需在“系统设置 → 隐私与安全性 → 完全磁盘访问权限”中为所用终端应用（Terminal、iTerm、Warp 或 VS Code）添加权限，退出并重新打开后再次运行登录命令。 Windows：Chrome 和 Edge 运行时锁定 cookie 文件，工具会先复制，通常可直接使用；若失败可关闭浏览器重试，或使用 --paste。 Linux：Chromium 系浏览器将 cookie 密钥存放在密钥环（GNOME Keyring 或 KWallet）中，需已解锁；Firefox 无需额外设置。Snap 或 Flatpak 浏览器配置文件位置不同，需使用 --paste。 通用备选：marktplaats-mcp login --paste 无需任何权限，在浏览器中打开 marktplaats.nl，按 F12 → Network，点击任意请求，复制 Cookie 请求头并粘贴即可。也可在客户端配置中设置 MARKTPLAATS_COOKIE / TWEEDEHANDS_COOKIE。会话可持续数周，过期后工具会提示重新登录。
安全与限制
- 发送、联系卖家和出价会先返回预览，只有在再次调用并传入 confirm=true 时才会执行。出价在 Marktplaats 上具有约束力，工具拒绝低于最低价的出价。自动刊登广告被 Marktplaats 条款禁止，因此有意未实现。
- 只读工具带有匹配的 MCP 注解，客户端会跳过确认提示；写入工具则会要求确认。
- 默认无需凭据；搜索、详情、卖家检查、筛选、价格统计和监控均不需要账号。
- 本地服务器仅从浏览器或仅本人可读的文件读取 cookie，且只发送给 marktplaats.nl / 2dehands.be，从不记录。托管端点配置账号凭据时会拒绝启动。
- 登录 --read-only 或设置 MARKTPLAATS_READ_ONLY=1 可完全禁用写入；每次确认的写入都会在本地记录日志。
- 广告文本和消息由其他用户撰写，服务器提示模型将其视为数据，绝不视为指令。
- 请求间隔由 MARKTPLAATS_MIN_INTERVAL_MS 控制（默认 200），失败时使用退避和 Retry-After 重试，搜索页面缓存一分钟。托管端点对每个客户端及全局进行速率限制。
- 无联盟链接、无跟踪，广告 URL 按平台发布原样返回。
- 由于平台 API 未公开且可能变化，项目每天运行一次实时金丝雀检测。
- 付费推广（DAGTOPPER、TOPADVERTENTIE）默认被过滤掉；传入 include_sponsored=true 可显示。total_count 是平台过滤前的原始计数，因此有时结果数少于限制值而 total_count 偏高。
- 支持 Python 3.10 及以上；CI 在 Linux、macOS 和 Windows 上测试 3.11 至 3.13。
适用场景
适合需要跨荷兰和比利时二手市场搜索、比价、监控特定商品或审核卖家可信度的用户，以及希望通过 AI 智能体自动化这些流程的开发者。使用自己的登录后，也可在 AI 对话中管理站内消息、出价和收藏。
其他信息
项目采用 MIT 许可证，开源免费，无 API 密钥。提供 Claude Desktop 扩展包（MCPB）、已保存搜索创建、跨站搜索（一次调用覆盖荷兰与比利时）等功能。支持通过 uv sync --all-groups 和 uv run pytest 进行开发测试，uv run python scripts/e2e_smoke.py 运行实时金丝雀。欢迎 PR，参见 CONTRIBUTING.md。项目复用了 marktplaats-py、marktplaats-monitor、marktplaats-2dehands-mcp 和 PonClick/marktplaats-mcp 的成熟思路，细节见 THIRD_PARTY_NOTICES.md。
