wallapop-cli：使用 wallapop 命令行搜索二手列表、获取商品详情

名称： wallapop-cli
描述： 使用 wallapop CLI 搜索商品、获取商品详情、查看用户资料以及浏览分类目录。当用户询问 Wallapop 市场数据或需要 wallapop-cli 的使用命令和参数时应用。
compatibility: 需要安装 wallapop-cli (Node.js 18+)，能访问 api.wallapop.com 的网络，非搜索接口可选配 WALLAPOP_ACCESS_TOKEN。

目的

提供简洁、正确的 wallapop-cli 使用命令。

使用时机

• 用户询问如何在终端中搜索 Wallapop 商品。
• 用户需要用于筛选搜索（价格、位置、类别、数量限制）的 CLI 参数。
• 用户需要查询商品或用户的命令。
• 用户需要用于脚本处理的 JSON 输出。

命令

搜索商品

wallapop search "<查询词>" [--lat <纬度>] [--lng <经度>] [--min-price <最低价>] [--max-price <最高价>] [--category <类别ID>] [--limit <数量>]

说明：
- 若省略 --lat/--lng，则使用配置的默认位置。
- --limit 在本地对结果进行截断。

商品详情

wallapop item <商品ID>

用户资料

wallapop user <用户ID>

分类目录

wallapop categories

JSON 输出（所有命令）

添加全局参数 --json：

wallapop --json search "笔记本电脑"
wallapop --json item abc123

配置

• 可通过环境变量设置默认位置：
• WALLAPOP_LAT
• WALLAPOP_LNG
• 非搜索接口的可选认证令牌：
• WALLAPOP_ACCESS_TOKEN

输出预期

• 搜索：表格或 JSON 数组，包含 ID、标题、价格、距离和用户信息。
• 商品：表格或 JSON，包含标题、描述、分类、用户和图片信息。
• 用户：表格或 JSON，包含个人资料字段。
• 分类：表格或 JSON 列表，包含类别 ID 和名称。

示例（安全占位符）

wallapop search "相机" --min-price 50 --max-price 200
wallapop search "椅子" --lat 40.0 --lng -3.0 --limit 5
wallapop item abc123
wallapop user user123
wallapop --json categories

错误处理

• 失败时返回非零退出码。
• 对于脚本使用，建议使用 --json 参数，并通过检查退出码来处理错误。