marktplaats

核心用法

Marktplaats Skill 是一款专为荷兰最大分类广告平台 Marktplaats.nl 设计的搜索工具，提供 CLI 命令行与 JavaScript API 两种使用方式。用户可通过 marktplaats-search 命令执行关键词搜索，支持按类别、价格区间、商品状态（全新/二手）、配送方式（自提/邮寄）等多维度过滤，结果可按相关性、日期或价格排序。marktplaats-categories 命令用于浏览平台分类体系，便于精准定位目标品类。程序化 API 采用 ESM 模块导出，开发者可直接调用 searchListings、、fetchCategories、、getListingDetails 等函数集成至自有应用。

显著优点

该 Skill 的最大亮点在于零外部依赖，仅依赖 Node.js 18+ 内置的 fetch API，彻底规避了供应链攻击风险。代码结构清晰，输入验证严格——所有数值参数（如 limit、price）均经过范围限制，字符串参数通过 URLSearchParams 自动编码，有效防止注入攻击。双语支持（荷兰语/英语）降低了非荷兰用户的使用门槛。输出格式灵活，既提供人类可读的表格展示，也支持 --json 原始数据导出，便于后续自动化处理。

潜在缺点与局限性

作为第三方非官方工具，其稳定性高度依赖 Marktplaats.nl 的 API 与页面结构。网站若调整接口或反爬策略，可能导致功能失效。HTML 解析采用正则表达式而非专用解析库，虽降低了依赖，但在极端复杂的页面结构下可能存在解析偏差。此外，该 Skill 仅覆盖荷兰本土市场，对国际用户适用性有限。价格单位采用欧分（euro cents）而非欧元，虽符合平台惯例，但需用户适应换算。

适合的目标群体

• 荷兰本地消费者：寻找二手商品、比价或追踪特定品类（如汽车、家具、电子产品）
• 跨境电商从业者：调研荷兰市场商品行情与价格趋势
• 开发者与数据分析师：需要程序化获取分类广告数据进行二次分析
• 节俭生活倡导者：高效筛选"免费赠送"或低价优质商品

使用风险

• API 可用性风险：Marktplaats.nl 未提供官方公开 API，工具依赖的端点可能随时变更或受限
• 数据时效性：搜索结果为平台公开数据，不包含私信议价或已下架商品状态
• 网络依赖：需稳定访问荷兰服务器，部分地区可能存在延迟或访问限制
• 无持久化功能：每次查询均为实时请求，不支持离线缓存或历史记录管理