Marktplaats 技能

搜索任意 Marktplaats 类别，按成色/配送方式筛选，列出分类结构，并获取商品详情。

CLI

npm install -g {baseDir}

# 搜索
marktplaats-search "" [options]
  -n, --limit          返回结果数量（默认：10，上限：100）
  -c, --category        分类 ID（顶层分类）
  --min-price        最低价格（单位：欧元分）
  --max-price        最高价格（单位：欧元分）
  --sort 
  --param key=value         按属性筛选（可重复使用）
  --details [target]        获取首个结果、URL 或 ID 对应的商品详情
  --json                    输出原始 JSON

# 分类列表
marktplaats-categories            # 主分类列表
marktplaats-categories        # 指定分类下的子分类
  --json                          输出原始 JSON

筛选器

常用筛选器通过 --param 使用：

英文别名同样可用：new、used、like-new、pickup、shipping

示例

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

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

# 搜索价格低于 €15,000 的汽车
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

# 列出 BMW（分类 ID 96）的子分类
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);       // 获取 BMW（ID 96）的子分类

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

注意事项

• 价格单位为欧元分（例如 €15,000 = 1500000）
• 返回结果中包含商品完整 URL
• 使用 --json 可查看所有可用 facet 和筛选键（filter keys）
• 筛选提示将在搜索结果后显示