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

核心用法

Marktplaats Skill 是荷兰最大二手交易平台 Marktplaats.nl 的官方搜索客户端，提供完整的 CLI 工具与程序化 API。

CLI 功能：

• marktplaats-search: 跨分类搜索，支持关键词、价格区间（欧分单位）、排序方式
• marktplaats-categories: 浏览层级分类体系（汽车、电子产品、家具等）
• 高级筛选：--param 支持状态（全新/二手/故障）、交付方式（自提/邮寄）、一口价等

API 集成：ESM 模块导出 searchListings、fetchCategories、getListingDetails 三个核心函数，可直接嵌入自动化工作流。

显著优点

• 零依赖安全架构：纯 Node.js 内置 fetch 实现，无供应链攻击面
• 智能参数映射：自动将英文别名（new/used/pickup）转换为荷兰语原值
• 数据完整性：返回完整列表 URL、分类层级、价格分位数，支持 --json 原始数据导出
• T2 可信来源：GitHub 公开仓库，MIT 许可证，维护者 Paul Voorschot 有持续开源贡献记录

潜在局限

• 地域限制：仅覆盖荷兰市场（marktplaats.nl），价格单位为欧元欧分（€15,000 = 1500000），国际用户需适应
• 只读权限：无法发布、编辑或购买，仅支持搜索与详情获取
• 速率限制：未内置请求节流，高频调用可能触发服务端限流
• 内容验证缺失：API 响应未校验 Content-Type，极端情况下可能解析异常

适合人群

• 荷兰本地买家：快速筛选自提/邮寄商品，比价二手汽车、家具、电子产品
• 跨境电商卖家：监控竞品定价与市场供需
• 数据分析师：提取结构化交易数据用于趋势研究
• 自动化开发者：构建价格预警、库存追踪机器人

常规风险

• 隐私披露：搜索关键词发送至 Marktplaats.nl 服务器，需了解其隐私政策
• 交易安全：Skill 本身不处理支付或物流，线下交易需自行防范欺诈
• API 稳定性：依赖官方未文档化的内部 API，存在接口变更风险

---

安全认证：S+ 顶级评级，静态分析 95 分，动态行为 90 分，零依赖设计获满分。