cochesnet-cli：使用命令行搜索西班牙 coches.net 车辆租赁与买卖列表

名称： cochesnet-cli
描述： 使用 cochesnet CLI 搜索 coches.net 车辆列表并获取详情。当用户需要 coches.net 市场数据，或需要了解 cochesnet-cli 的具体命令和参数时应用此工具。
compatibility: 需要安装 cochesnet-cli（Node.js 18+），并能够访问 apps.gw.coches.net。
许可证： MIT
元数据：
author: pjtf93
version: "0.1.0"

功能概述

使用 cochesnet CLI 搜索车辆列表并获取广告详情。

使用场景

• 用户需要在终端中搜索 coches.net 上的车辆列表。
• 用户需要根据已知的广告 ID 获取列表详情。
• 用户希望获得 JSON 格式的输出以便进行脚本处理。

命令说明

搜索列表

cochesnet search "<查询内容>" [--limit <数量>] [--page <页码>]

获取详情

cochesnet listing <广告ID>

JSON 格式输出

在任何命令后添加 --json 参数即可获得 JSON 格式输出：

cochesnet search "bmw" --json
cochesnet listing 58229053 --json

配置选项

支持以下环境变量进行配置：
- COCHESNET_BASE_URL（默认值：https://apps.gw.coches.net）
- COCHESNET_APP_VERSION（默认值：7.94.0）
- COCHESNET_HTTP_USER_AGENT（默认值：coches.net 7.94.0）
- COCHESNET_X_USER_AGENT（默认值：3）
- COCHESNET_TENANT（默认值：coches）
- COCHESNET_VARIANT（可选，用于设置 X-Adevinta-MT-Variant 请求头）

输出内容

• 搜索命令：以表格或 JSON 格式返回结果，包含 ID、标题、价格、年份、里程、地点和 URL。
• 详情命令：以表格或 JSON 格式返回结果，包含标题、价格、URL、卖家和描述信息。

使用示例

cochesnet search "bmw" --limit 5
cochesnet search "toyota" --page 2
cochesnet listing 58229053

错误处理

• 执行失败时会返回非零的退出码。
• 在脚本中使用时，建议结合 --json 参数并检查退出码来判断执行状态。