baidu-youjia-car — 百度有驾车

百度有驾汽车查询（Baidu Youjia Car）数据由百度有驾（Youjia）提供 — 国内领先的汽车交易信息平台，提供实时车型价格、经销商报价、销量排行等数据。

功能概述 本技能通过百度有驾 API 提供以下能力： 车型搜索与识别 - 通过用户的自然语言查询识别车系 ID 车型详情查询 - 获取车型完整信息，包括厂商价格、经销商报价、降价信息、保险成本、落地价等 销售排行榜 - 查询热门车型、销量排行、按价格/品牌/能源类型筛选 经销商信息 - 获取指定城市的经销商联系方式与报价 城市支持 - 支持按城市查询（如北京、上海等），获取本地经销商信息

核心工作流程 用户提问 → 车系识别 → 详情查询 → 结果展示 当用户提出汽车相关问题时： 识别车系 - 使用 NER（命名实体识别）接口搜索用户提到的车型，提取 series_id 获取详情 - 用 series_id 调用车型详情接口，获取价格、经销商、优惠等信息 补充信息 - 如需排行榜或其他信息，调用相应接口 格式化展示 - 以友好的方式展示给用户

脚本使用 脚本文件：scripts/youjia_car.py

• 搜索车型（识别车系ID）

python3 scripts/youjia_car.py search --query "奥迪A4" --city "北京" 返回示例：{ "sug_list": ["奥迪A4L", "奥迪A4(进口)", "奥迪A4"], "series_info": [ { "series_id": "2008", "series_name": "奥迪A4L", "brand_name": "奥迪", "brand_id": 8 } ] }

• 获取车型详情

python3 scripts/youjia_car.py detail --series_id "1684" --city "北京" 返回包含：车系基本信息（品牌、车系名、厂商指导价）价格信息（厂商价、最低成交价、降价信息、落地价）经销商列表（城市、地址、联系信息）保险成本明细（购置税、车船税、交强险、商业险等）用户成交价格参考优惠信息统计

• 查询排行榜

# 销量排行（按销量排序） python3 scripts/youjia_car.py rank --sort "sale" --city "北京" --limit 20 # 按价格区间筛选 python3 scripts/youjia_car.py rank --sort "sale" --price_range "8,15" --city "北京" # 按车型级别筛选 python3 scripts/youjia_car.py rank --sort "sale" --car_type "SUV" --city "北京" 返回包含：排行前N名车型信息价格范围销量数据是否新能源、能源类型经销商报价

API 接口详解

• NER 搜索接口

目的：识别用户提到的车型，获取 series_id URL：https://m.yoojia.com/api/search/sug 必填参数：query - 用户输入的车型名称（如"奥迪A4"）token - API Token 可选参数：city - 城市名称（影响本地结果排序） 返回：匹配的车系列表，优先返回最匹配的车系 ID { "text_att": [ { "series_id": "2008", "series_name": "奥迪A4L", "brand_id": 8, "brand_name": "奥迪", "type": "series" } ] }

• 车型详情接口

目的：获取指定车系的详细信息与经销商报价 URL：https://www.yoojia.com/minServer/bff-pc-api/clue/askprice/popbefore 必填参数：series_id - 车系 IDtoken - API Token 可选参数：city - 城市名称（获取该城市的经销商信息，如"北京"）dealer_id - 指定经销商 ID 返回：完整的车型信息 { "car_info": { "series_id": "1684", "series_name": "速腾", "brand_name": "大众", "model_name": "2026款 S 1.5L 时尚版", "manufacturer_price": "9.38万", "img": "..." }, "advertise_price_info": { "manufacturer_price": {"price": "9.38", "unit": "万"}, "min_reference_price": {"price": "7.98", "unit": "万"}, "max_reference_price": {"price": "9.38", "unit": "万"}, "discount": {"price": "1.40", "unit": "万"} }, "dealer_list": [ { "city_name": "北京", "dealer_name": "...", "dealer_address": "...", "manufacturer_price": "9.38万" } ], "price_info": [ {"type": "manufacturer_price", "name": "厂商指导价", "price": ".38", "unit": "万"}, {"type": "purchase_tax", "name": "购置税", "price": "301", "unit": "元"}, {"type": "vehicle_traffic_accident_insurance", "name": "交强险", "price": "50", "unit": "元"}, {"type": "sum_price", "name": "落地价", "price": "1.80", "unit": "万"} ] }

• 排行榜接口

目的：获取热门车型排行榜 URL：https://www.yoojia.com/api/rank/getranklistv2 必填参数：sort - 排序方式（如 sale 表示按销量排序）token - API Token 可选参数：city - 城市名称（如"北京"）price - 价格范围（如"8,15"表示8-15万）sub_level - 车型级别（如"2"表示SUV，"1"表示轿车）energy_type - 能源类型（如"8"表示纯电动） 返回：按排序条件排列的车型列表 { "list": [ { "series_id": "1005769", "series_name": "Model Y", "brand_name": "特斯拉", "price": "26.35-31.35万", "series_sub_level": "中型SUV", "idx": 1, "text": {"title": 39827, "sub_title": "销量"} } ] }

使用示例 场景1：用户问"奥迪A4多少钱？" 调用搜索接口：search --query "奥迪A4" --city "北京" 提取 series_id = 2008 调用详情接口：detail --series_id "2008" --city "北京" 返回价格、经销商、降价等信息 场景2：用户问"十万左右买什么SUV最好？" 调用排行榜接口：rank --sort "sale" --price_range "8,15" --car_type "SUV" --city "北京" 返回热门SUV列表与报价 可进一步调用详情接口获取更多信息 场景3：用户问"最近热销车型是什么？" 调用排行榜接口：rank --sort "sale" --limit 10 直接返回销量前十车型

返回数据字段解释 价格相关 manufacturer_price - 厂商指导价 min_reference_price - 最低成交价（经销商最低报价） max_reference_price - 最高成交价（经销商最高报价） discount - 降价幅度 成本明细 purchase_tax - 购置税 vehicle_and_vessel_usage_tax - 车船税 vehicle_traffic_accident_insurance - 交强险（强制保险） business_all - 商业险（推荐但非强制） sum_price - 落地价（总成本，包含所有费用） 新能源标识 is_new_energy - 是否新能源车（1为是，0为否） energy_type - 能源类型数组（如 ["纯电", "插混"]）

常见错误处理 错误 原因 解决方案 series_id 不存在 搜索结果为空或无该车系 检查搜索关键词是否正确，尝试模糊搜索 城市不支持 指定的城市在该平台无数据 尝试使用主要城市（北京、上海、广州等） 返回为空 该车型在指定城市无经销商信息 尝试其他城市或检查车型是否停产

推荐用法 用户查询流程 识别车型：用户提到的车型名称 → 调用搜索接口获取 series_id 获取详情：series_id → 调用详情接口获取完整信息 补充信息：如需对比、排行等 → 调用相应专用接口 友好展示：整合多个接口结果，以表格或结构化方式呈现 使用建议 单