二手车价格历史分析

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install used-car-price-history-analysis
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 used-car-price-history-analysis。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

此 skill 使用 Crawlora 存储的车辆挂牌信息，并在需要时选取实时挂牌详情，构建包含日期的已观察要价事件台账。它有助于解释单个挂牌或谨慎匹配的一组车辆的价格变化，同时避免将首次观察到的价格误认为原始价格，或将挂牌降价误认为议价节省。
此工具专为可靠的汽车研究而设计，会保留来源 ID、URL、事件日期、抓取时间和覆盖范围限制。Openclaw Skills 用户可以生成可比车辆表和数据新鲜度说明，同时区分证据缺失与车辆已售出或价格已变动的证明。

应用场景

为特定二手车挂牌建立有日期记录的价格变动台账。
根据挂牌可用历史评估广告中的降价。
比较按年份、配置、里程、车况、地区及其他已知属性匹配的车辆价格走势。
使用当前来源详情核查选定挂牌，并标记其与存储记录的差异。
记录数据集覆盖范围、抓取新鲜度、缺失值以及尚未解决的车辆身份问题。

工作原理

确定研究范围：来源、地理区域、品牌、车型、年份、配置、里程和车况限制、观察窗口及价格依据。
检查数据集 facets，了解可接受的筛选条件，然后在限定的页面数和 credit 预算内搜索。
按 : 格式保留返回的挂牌 ID。将 VIN 视为身份线索，而不是数据集挂牌 ID；未关联的重新挂牌记录应保留为独立历史。
获取可用的价格历史事件，并分别保留事件 ID、schema version、snapshot_date 和 crawled_at。检查重复或异常日期。
必要时通过相关来源的实时详情 route 刷新选定挂牌，使用该来源自己的挂牌 ID 或 URL。将无法获取的挂牌视为不可用证据。
使用已知属性匹配可比车辆，明确标示未知属性，并避免将同一 VIN 的多段历史重复计作独立车辆。
对有效正价格计算 change = later − earlier 和 percent change = change / earlier × 100，并报告两个观察日期。
呈现事件台账、匹配可比车辆表、样本数和不同挂牌数、覆盖范围及新鲜度说明、当前与存储记录的差异，以及需要核实的卖家问题。

配置指南

在环境中设置 Crawlora API key。若可用，请使用列出的 Crawlora MCP 工具；否则使用捆绑的 shell 脚本。具体 endpoint 方法和参数请参阅 reference/endpoints.md。
export CRAWLORA_API_KEY="your-crawlora-api-key"
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
使用搜索返回的实际挂牌 ID 查询历史 route：
LISTING_ID="source:source_listing_id"
scripts/crawlora.sh "/datasets/vehicle-listings/price-history/$LISTING_ID"
检查应用程序 code 以及 HTTP 状态；响应内容位于 data 中。遇到身份验证错误时停止，遇到 HTTP 429 时延迟重试，上游暂时性故障只重试一次。请求应保持在指定范围和 credit 预算内。

数据架构

此 skill 会保留来源信息，并区分挂牌身份与车辆身份。
数据元素 处理方式
来源 存储的来源包括 carmax、autotrader 和 carsdotcom；每条记录都应保留来源。
挂牌身份 对项目和历史 route 使用 :。除非有明确证据表明相关联，不同卖家或重新挂牌应分别处理。
VIN 将其视为车辆身份线索，而非数据集挂牌 ID。不要自动将同一 VIN 的多段历史计为独立车辆。
价格事件 历史记录包含首次观察到的价格和已记录的变动，而不是每日抓取行。保留事件 ID 和 schema version。
日期 将 snapshot_date（事件日期）与 crawled_at（检索或抓取时间）分开；补录事件的日期可能早于其抓取时间。
可比车辆 追踪已知的匹配属性，例如年份、配置、驱动形式、里程、卖家类型、车况、历史、地区、货币和费用。未知值应保持未知。
覆盖范围 注明 CarMax 库存可枚举，而 Autotrader 和 Cars.com 的 ZIP 扫描为尽力而为，搜索区域可能只是近似范围。
若返回的历史为空，应报告未返回已索引历史，而不是证明价格从未变动。不要插补每日价格或价格持续时间。应区分价格上涨、降价以及缺失或无效值。输出应包含价格事件台账、匹配可比车辆表、覆盖范围和新鲜度说明、存储记录与当前信息的差异，以及需要卖家核实的问题。

高级特性

支持 Crawlora MCP 工具，或使用捆绑的
scripts/crawlora.sh
作为备用方案。
使用数据集 facets，在限定范围搜索之前发现可接受的来源、品牌、车型和配置筛选条件。
将存储的价格历史与实时详情刷新分开，并保留各 route 的挂牌身份。
处理补录的 Cars.com 原生价格历史事件，不混淆事件日期与抓取时间。
在分析中明确展示来源覆盖限制和近似地理范围。
采用谨慎的错误处理：身份验证错误时停止，达到速率限制时延迟重试，上游暂时性故障只重试一次。
坚持观察性分析：不推断议价节省、不插补未观察到的价格、不联系经销商，也不授权购买。

name: used-car-price-history-analysis description: Analyze observed used-car listing price changes through Crawlora stored vehicle histories and selected live listings. Use for a dated price-change ledger, matched comparable vehicles, or evaluating an advertised reduction with listing identity and crawl coverage preserved.

Used-car price history analysis

Access and scope

Set CRAWLORA_API_KEY to your Crawlora key. Prefer the listed Crawlora MCP tools when connected; otherwise use the bundled scripts/crawlora.sh, which sends x-api-key to https://api.crawlora.net/api/v1. Read reference/endpoints.md for exact methods and parameters. Check application code as well as HTTP status; payloads are inside data. Stop on authentication errors, back off on 429, and retry a transient upstream failure once. Bound requests by the requested scope and credit budget. Preserve source IDs, URLs, source dates, and retrieval/crawl times separately.

Explain observed asking-price changes for a listing or matched vehicle cohort. Establish source, geography, make/model/year/trim, mileage/condition constraints, observation window, and price basis before collecting comparable records.

Resolve listings and their recorded events

Discover accepted source/make/model/trim filters through dataset facets, then search with a bounded page budget. Stored sources are carmax, autotrader, and carsdotcom. CarMax inventory is enumerable; the other two are best-effort ZIP sweeps whose geocoded area can approximate the search location rather than the seller's address. Keep those coverage differences visible.
Copy returned IDs in : format into item/history routes. A VIN is a vehicle identity lead, not the dataset listing ID. Different sellers or relistings of the same VIN remain separate listing histories unless dates and seller evidence establish an explicit linkage.
Price history records the first observed price and observed changes, not a row for every crawl/day. Cars.com may include backfilled native price-history events, bounded by enrichment coverage. Keep snapshot_date separate from crawled_at: a backfilled event predates the crawl that obtained it.
An empty history means no indexed history was returned; one row means one recorded price, not proof the price never changed before observation began. Preserve event IDs/schema version and anomalous or duplicate dates for review.
Refresh selected listings through their source's live detail route when needed, resolving that route's own ID/URL from listing evidence. A failed or missing listing is unavailable evidence, not proof the car sold or a seller accepted a lower price. Do not substitute another vehicle with a similar title.
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

# Select an actual returned listing ID before:
# scripts/crawlora.sh "/datasets/vehicle-listings/price-history/$LISTING_ID"

Calculate comparable changes

For comparable positive prices, show change = later − earlier and percent change = change / earlier × 100, with both observed dates. Keep increases, reductions, and missing/invalid price values separate. Do not label a first-observed price as original MSRP or a price reduction as a negotiated saving. Do not interpolate daily prices or time-at-price beyond observed events.

Match year/trim/drivetrain, mileage, seller type, condition and accident/owner history when supplied, region, currency, and fees before comparing vehicles. Unknown attributes remain unknown. Report cohort sample size and distinct listing counts; two histories for one VIN are not automatically two independent vehicles. Return the price-event ledger, matched-comparable table, coverage/freshness notes, current-versus-stored discrepancies, and questions to verify with the seller. A research request does not authorise contacting dealers or purchasing a vehicle.

YouTube 内容差距分析
Twitch 类别机会研究