Blocket MCP

Blocket MCP

我受够了在 Blocket 上不停翻找，于是现在让 ChatGPT 来做。

它无法登录、给卖家发消息或发布任何内容。它只会读取公开广告。

工具

search 支持全部 13 个版块：Torget，以及汽车、船只、摩托车、房车、露营车、卡车、拖拉机、联合收割机、雪地摩托、ATV、轻便摩托车和公交车。你可以像平常一样输入筛选条件，例如 Volvo V70、Segelbåt、Stockholm，服务会推断出 Blocket 的 ID。品牌名拼错了？结果会出现在 unmatched 中，并附上建议，模型会在下次调用时修正。如果没有这项功能，你就会悄无声息地搜到瑞典的所有汽车。它还支持按距离搜索、赠送物品和求购广告、可配送物品、“今天早上以来的新内容”、某位卖家的全部库存，以及方便快速了解市场的价格分布计数。每次搜索还会返回对应的 blocket.se URL。将它保存在 Blocket 应用中，新广告出现时你就会收到推送。

Blocket 自带的搜索会带出许多无关结果。想找 iPhone 13？通过 exclude 传入 skal、laddare 和 köpes，手机壳、充电器和求购广告就会被排除。还可以使用 require，并切换为仅搜索标题。如果这样导致一页结果不多，服务会继续读取，但最多读取 200 条广告。Blocket 常见的搜索运算符照常可用：-word、OR、"exact phrase"、word*。开启 deals 后，每条结果都会根据相同搜索结果的价格中位数标记价格水平，从划算到偏高。无论是否开启，标题中含有“defekt”“reservdelar”“startar inte”等字样的结果都会被标记。

get_ad 最多接受 5 个广告 ID 或链接。它会提供描述、规格、设备、所有照片、广告是否仍在售、卖家信息，以及收藏人数。它也会指出常见的诈骗迹象，例如在 Blocket 之外付款、“通过 WhatsApp 联系我”以及外国号码。汽车和船只会显示马力，电动汽车会显示续航里程和电池容量，车商发布的汽车则会显示车商提供的不含增值税价格。拥有 Google 评分的车商也会显示评分。车商发布的汽车还会附带车辆历史链接。一次提供多个广告即可进行比较。

get_ad_photos 会将广告的最多 8 张照片作为实际图像发送，以便能够识图的模型自行判断状况。锈蚀、裂纹和缺失部件通常比在描述中更容易从照片里发现。

price_check 用于回答“这个价格公道吗？”。它会按品牌、型号、年份、里程或船长查找相似的在售广告，并提供 p10 到 p90 的价格区间，以及你的广告所处的位置。可比广告少于 8 条时，它会放宽匹配条件，并说明放宽了哪些条件。这些数字是要价，因为 Blocket 不会显示实际成交价。

list_filters 会列出某个版块的筛选条件和值，以及实时计数。

在自己的电脑上运行

Claude Desktop、Claude Code、Cursor 和 Codex 可以通过 stdio 在本地运行服务。无需令牌，也无需托管。

Claude Desktop 用户从 Releases 下载 blocket-mcp-<version>.mcpb，然后双击即可。安装就这么简单。

其他客户端可以用 Docker 启动。在 Claude Code 中，命令如下：

claude mcp add blocket -- docker run -i --rm ghcr.io/idoo/blocket-mcp

Cursor 和 Codex 的 MCP 配置使用相同的命令和参数。如果不想用 Docker，也可以使用 Node 20 或更高版本自行构建：

npm ci && npm run build:stdio
node dist/blocket-mcp.js

托管运行，供 ChatGPT 和 claude.ai 使用

ChatGPT 和 claude.ai 无法访问你的笔记本电脑，因此服务需要一个公开的 HTTPS 地址。我把服务部署在 Cloudflare 上。Firebase 也可以。

无需登录。ChatGPT 的自定义连接器只能选择 OAuth 或不使用身份验证；对于公开广告来说，OAuth 显得过于复杂，因此接口通过一个秘密路径 /mcp/<token> 隐藏。访问其他路径会返回 404。生成一个足够长的随机令牌：

openssl rand -hex 24

Cloudflare Workers

免费套餐足以满足需求。

git clone https://github.com/idoo/blocket-mcp && cd blocket-mcp
npm ci
npx wrangler login
npx wrangler deploy
npx wrangler secret put MCP_PATH_TOKEN    # paste the token

Wrangler 会在最后输出一个 workers.dev URL。在后面加上 /mcp/<token>。wrangler.jsonc 中每分钟最多允许 120 次调用。

本地开发：在 .dev.vars 中设置 MCP_PATH_TOKEN=dev，运行 npm run dev，然后访问 http://localhost:8787/mcp/dev。

Firebase

Cloud Functions 需要 Blaze 套餐，这意味着必须绑定一张银行卡。单个人的流量不会超出免费额度。

git clone https://github.com/idoo/blocket-mcp && cd blocket-mcp
npm ci && npm --prefix functions ci
firebase login
firebase use --add                              # pick your project
firebase functions:secrets:set MCP_PATH_TOKEN   # paste the token
firebase deploy --only functions

端点为 https://europe-north1-<project-id>.cloudfunctions.net/mcp/<token>。Firebase 没有速率限制器。函数最多启动 3 个实例，这样即使有人发现了你的 URL，账单也不会太高。想换个区域或增加容量？请查看 functions/src/index.ts 顶部。

如需在不部署的情况下测试，请将 MCP_PATH_TOKEN=dev 放入 functions/.secret.local，然后运行 firebase emulators:start --only functions。URL 为 http://127.0.0.1:5001/<project-id>/europe-north1/mcp/dev。

连接

网页版 ChatGPT：打开 Plugins，点击 Add，再选择 “Add custom MCP server”。粘贴端点，无需身份验证，完成。然后在任意聊天中输入 @Blocket。由于所有工具都标记为只读，它不会每次调用都提示你授权。

claude.ai：Settings → Connectors → Add custom connector。

Claude Code 和 Codex：

claude mcp add --transport http blocket https://…/mcp/<token>
codex mcp add blocket --url https://…/mcp/<token>

工作原理

Blocket 没有公开 API。该服务会调用 blocket.se 自身页面加载的 JSON 端点，通常每次工具调用发起一个请求；执行比较和价格检查时则会发起几个请求。筛选条件名称会与 Blocket 的实时筛选列表进行匹配，因此上周才出现的品牌现在也能正常使用。如果 Blocket 更改这些端点，这些功能就会失效，直到有人提交修复。欢迎提交 PR。

dunderrrrrr/blocket_api 中的端点说明为我提供了入门帮助。与 Blocket AB 没有任何关联。

许可证

MIT