用途：解释某条车源或匹配车源群体的挂牌要价变化，输出带日期的价格变动台账、可比车源对比表、覆盖与新鲜度说明、当前与存储数据差异，以及需向卖家核实的问题。
主要能力：通过数据集 facets 发现可用的来源/品牌/车型/配置筛选条件，再在限定页数预算内搜索。存储来源为 carmax、autotrader、carsdotcom；CarMax 库存可枚举，另两个为尽力而为的 ZIP 扫描，其地理编码区域近似搜索位置而非卖家地址，需保留这些覆盖差异。价格历史记录首次观测价格与观测到的变动，而非每次抓取一行；Cars.com 可能含回填的原生价格历史事件。
使用方式：设置 CRAWLORA_API_KEY；优先使用已连接的 Crawlora MCP 工具，否则用 scripts/crawlora.sh，它向 https://api.crawlora.net/api/v1 发送 x-api-key。参考 reference/endpoints.md 获取方法与参数。将返回的 ID 以 <source>:<source_listing_id> 格式用于 item/history 路由；VIN 是车辆身份线索，不是数据集列表 ID。示例： scripts/crawlora.sh /datasets/vehicle-listings/facets facet=source scripts/crawlora.sh /datasets/vehicle-listings/search make=Toyota model=Camry source=carmax page=1 page_size=10 scripts/crawlora.sh "/datasets/vehicle-listings/price-history/$LISTING_ID"
计算：对可比正价格，change = later − earlier，percent change = change / earlier × 100，并附两个观测日期；分别保留涨价、降价与缺失/无效价格。不得把首次观测价标为原始 MSRP，不得把降价标为议价节省，不得在观测事件之外插值每日价格或停留时长。比较前需匹配年份/配置/驱动、里程、卖家类型、车况与事故/车主历史、地区、币种和费用；未知属性保持未知。报告群体样本量与去重车源数。
限制：空历史表示未返回索引历史，一行表示一条记录价格，不能证明观测开始前价格未变。检查应用代码与 HTTP 状态，载荷在 data 内；认证错误即停止，429 退避，瞬时上游失败重试一次。按请求范围与额度预算限制请求。保留来源 ID、URL、来源日期与抓取时间。失败或缺失车源是不可用证据，不等于车辆已售或卖家接受低价；不得用标题相似的其他车辆替代。研究请求不授权联系经销商或购车。