名称： marktplaats
描述： 支持过滤功能，搜索 Marktplaats.nl 全品类分类广告。
主页： https://www.marktplaats.nl
元数据： {"clawdbot":{"emoji":"🇳🇱","requires":{"bins":["node"]}}}

Marktplaats 技能

搜索任意 Marktplaats 分类，按状态/配送方式过滤，列出分类，并获取商品详情。

命令行界面 (CLI)

npm install -g {baseDir}

# 搜索
marktplaats-search "<查询词>" [选项]
  -n, --limit <数量>        结果数量（默认: 10，最大: 100）
  -c, --category <ID>       分类 ID（顶级分类）
  --min-price <分>          最低价格（单位：欧分）
  --max-price <分>          最高价格（单位：欧分）
  --sort <relevance|date|price-asc|price-desc>
  --param key=value         按属性过滤（可重复使用）
  --details [目标]          获取“第一个”结果或指定 URL/ID 的详情
  --json                    输出原始 JSON 数据

# 分类
marktplaats-categories            # 主分类
marktplaats-categories <ID>       # 指定分类的子分类
  --json                          输出原始 JSON 数据

过滤器

常用过滤器配合 --param 使用：

也支持英文别名：new, used, like-new, pickup, shipping

示例

# 仅搜索全新笔记本电脑
marktplaats-search "laptop" --param condition=Nieuw

# 搜索支持邮寄的二手相机
marktplaats-search "camera" --param condition=Gebruikt --param delivery=Verzenden

# 搜索价格低于 1.5 万欧元的汽车
marktplaats-search "bmw 330d" --category 96 --max-price 1500000

# 搜索仅限自提的家具，按价格升序排序
marktplaats-search "eettafel" --param delivery=Ophalen --sort price-asc

# 获取第一个搜索结果的详情
marktplaats-search "iphone" -n 1 --details first

# 列出所有分类
marktplaats-categories

# 列出宝马分类下的子分类
marktplaats-categories 96

编程接口 (ESM)

import { searchListings, fetchCategories, getListingDetails } from '{baseDir}';

// 带过滤器的搜索
const results = await searchListings({
  query: 'espresso machine',
  params: { condition: 'Nieuw', delivery: 'Verzenden' },
  limit: 10,
});

// 获取分类
const categories = await fetchCategories();  // 顶级分类
const bmw = await fetchCategories(96);       // 宝马分类的子分类

// 获取商品详情
const details = await getListingDetails(results.listings[0].vipUrl);

注意事项

• 价格单位为 欧分（€15,000 = 1500000）
• 搜索结果包含商品的完整 URL
• 使用 --json 选项可查看所有可用的筛选维度和过滤键
• 搜索结果后会显示过滤提示