troedler

用一次查询搜索多个二手市场——从你自己的机器上，按你自己的节奏，以你自己的名义。

trödler 在市场上淘货，从别人的物品中筛出那件值得拥有的东西。这个工具同时做到这一点，横跨 eBay、分类广告网站、公共机构拍卖和收藏家市场，并告诉你某件东西在哪里便宜、在哪里不便宜。

它目前是一个命令行工具和一个 MCP 服务器，因此你可以从 shell 或 AI 助手中使用它。计划推出原生 GNOME/Adwaita 应用。它通过 gjsify 运行在 GJS 上——TypeScript，无需 Node 运行时。

$ troedler search Bandsäge --max-price 400 --seller private --explain

  1. Metabo BAS 318 Bandsäge — gebraucht, funktionsfähig
     289,00 €  Gebraucht — sehr gut · privat · Versand · 21762 Otterndorf · vor 2 d · unter dem Feld
     https://www.ebay.de/itm/…

Preisband über 23 Angebote: 95,00 € … 240,00 € — 315,00 € — 420,00 € … 890,00 €

eBay: 18 Treffer
    Filter beim Anbieter: maxPrice, sellerType
    Filter hier nachgezogen: —
Kleinanzeigen: übersprungen — Nutzungsbedingungen untersagen automatisierten Abruf, siehe docs/quellen/kleinanzeigen.de.md
Zoll-Auktion: 5 Treffer

它能做什么

• 一次查询，覆盖每个市场。 结果按来源分组，因此你可以看到某件东西在一个平台上卖 40 欧元、在另一个平台上卖 120 欧元——这才是你真正想要的答案。

• 这个价格划算吗？ 基于当前在售商品给出中位数和四分位区间，并对每条列表给出粗略判断。它描述你眼前的行情；它不做估价。

• 带提醒的已保存搜索。 troedler watch run 只报告自上次以来新增的内容。

• 关注单个商品。 对于你还在考虑的东西，跟踪价格变化和"已售罄"状态。

• 一个 MCP 服务器，让助手可以代你搜索——并且可以看到某个来源为什么没有返回结果，而不是就此断定该商品不存在。

Related MCP server: Secondhand MCP

它不会做什么

这比功能列表更重要，因为它决定了其他一切。

troedler 在本地运行，为一个人服务，绝不以服务形式运行。没有托管的爬虫、没有共享索引、没有服务器模式。它只读取网站 robots.txt 允许的内容，一次一个请求，请求之间留有间隔，使用一个诚实的用户代理，说明自己是谁以及向哪里投诉。它从不登录、从不伪装浏览器、从不绕过验证码或机器人墙、从不重试被拒绝的请求。当市场说不时，那就是答案。

条款禁止自动访问的市场默认关闭。troedler 仍然提供它们——只是在你明确同意之前不会为你抓取：providers enable 会完整打印运营商的条款，没有 --acknowledge 就拒绝执行。

责任由你承担。 troedler 是一个非商业工具，运行在你的机器上，使用你的地址，为你的个人搜索服务。服务的条款约束的是使用它的人，因此开启一个来源意味着以你自己的名义请求它，并自己为其负责。软件既不会替你做出这个决定，也不会隐瞒自己的身份：它把来源关闭，引用你将要违反的条款句子，记录你同意的日期，然后不再干预。即使开启，它也保持所有其他限制——robots.txt、请求节奏、诚实的用户代理、不登录、不规避。

不存储任何关于卖家的信息——没有姓名、没有 ID、没有个人资料。电话号码和电子邮件地址在解析时从列表文本中剥离。图片只做链接，从不下载。

来源

每个来源在 docs/quellen/ 下都有一条记录，包含其 robots.txt 的发现、相关条款，以及人工最后检查的日期。troedler terms 打印摘要，troedler robots <url> 回答给定 URL 是否可以被抓取以及由哪条规则决定。

快速开始

gjsify install                              # never npm install — see AGENTS.md
gjsify workspace troedler-cli build
gjsify run app/dist/troedler.gjs.mjs check  # what is configured, what is not

凭据放在 .env（复制 .env.example）或你的 shell 中。每一项都是可选的：没有密钥的来源会报告自己未配置并被跳过——它绝不会让搜索静默失败。

作为 MCP 服务器，将你的客户端指向：

{
  "command": "…/node_modules/.bin/gjsify",
  "args": ["run", "…/app/dist/troedler.gjs.mjs", "mcp"],
  "cwd": "…/app"
}

除非设置了 TROEDLER_MCP_ALLOW_WRITE=1，否则工具都是只读的，服务器通过丢弃任何未声明为只读的工具来强制执行这一点。

数据存放位置

本仓库内从不写入任何内容。

troedler cache purge 清除本地记录；troedler config path 打印所有内容的存放位置。

贡献与异议

如果你运营这些网站之一，并且希望 troedler 不要读取它，请提交 issue 或写信给用户代理中的地址——该主机将被列入退出名单，并从下一个版本中移除。无需争论，无需等待。

许可证：MIT。属于 werkstatt 工作区的一部分，与 postbote 和 bauplaner 并列。