概述
wallapop-cli 是一个基于 Node.js 的命令行工具，用于访问西班牙知名二手交易平台 Wallapop 的公开数据。该工具无需官方 API 密钥即可执行商品搜索，但部分功能（如查看非公开商品详情或用户资料）需要可选的访问令牌。
核心用法
该技能提供完整的 CLI 命令结构：
- 搜索商品：
wallapop search "<关键词>"支持价格区间（--min-price/--max-price）、地理坐标（--lat/--lng）、分类 ID（--category）和结果数量限制（--limit） - 商品详情：
wallapop item <商品ID>获取特定商品的完整信息 - 用户资料：
wallapop user <用户ID>查询卖家信息 - 分类列表：
wallapop categories列出可用商品分类
所有命令均支持 --json 全局标志，输出结构化数据便于脚本集成。
显著优点
1. 零配置搜索：无需认证即可搜索公开商品，降低使用门槛
2. 地理感知：支持基于 GPS 坐标的本地化搜索，匹配 Wallapop 的社区交易模式
3. 脚本友好：JSON 输出模式配合非零退出码，适合自动化工作流
4. 环境变量配置：通过 WALLAPOP_LAT/WALLAPOP_LNG 设置默认位置，简化重复查询
潜在局限
- 功能边界：仅封装只读端点，不支持发布商品、私信或交易操作
- 认证限制：非搜索端点需
WALLAPOP_ACCESS_TOKEN，获取方式未在文档中说明 - 平台依赖：完全依赖 Wallapop 的私有 API，存在接口变更风险
- 地理局限：Wallapop 主要服务西班牙及欧洲市场，商品数据的地域覆盖有限
适合人群
- 需要批量抓取二手市场数据的分析师和研究人员
- 希望监控特定商品价格变动的个人买家
- 开发本地比价工具或库存管理系统的开发者
- 学习 CLI 工具设计和 API 封装的技术爱好者
常规风险
该工具本身为只读封装，不直接修改用户数据或执行交易。主要风险包括：
- 过度请求可能导致 IP 被 Wallapop 临时限制
- 依赖非官方 API 端点，存在随时失效的可能
- 输出包含公开用户信息，需遵守数据保护法规（如 GDPR）