百度有驾汽车查询（Baidu Youjia Car）

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

功能概述

本技能通过百度有驾 API 提供以下能力：

1. 车型搜索与识别 - 通过用户的自然语言查询识别车系 ID
2. 车型详情查询 - 获取车型完整信息，包括厂商价格、经销商报价、降价信息、保险成本、落地价等
3. 销售排行榜 - 查询热门车型、销量排行、按价格/品牌/能源类型筛选
4. 经销商信息 - 获取指定城市的经销商联系方式与报价
5. 城市支持 - 支持按城市查询（如北京、上海等），获取本地经销商信息

核心工作流程

用户提问 → 车系识别 → 详情查询 → 结果展示

当用户提出汽车相关问题时：

1. 识别车系 - 使用 NER（命名实体识别）接口搜索用户提到的车型，提取 series_id
2. 获取详情 - 用 series_id 调用车型详情接口，获取价格、经销商、优惠等信息
3. 补充信息 - 如需排行榜或其他信息，调用相应接口
4. 格式化展示 - 以友好的方式展示给用户

脚本使用

脚本文件：scripts/youjia_car.py

1. 搜索车型（识别车系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
    }
  ]
}

2. 获取车型详情

python3 scripts/youjia_car.py detail --series_id "1684" --city "北京"

返回包含：

• 车系基本信息（品牌、车系名、厂商指导价）
• 价格信息（厂商价、最低成交价、降价信息、落地价）
• 经销商列表（城市、地址、联系信息）
• 保险成本明细（购置税、车船税、交强险、商业险等）
• 用户成交价格参考
• 优惠信息统计

3. 查询排行榜

# 销量排行（按销量排序）
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 接口详解

1. 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"
    }
  ]
}

2. 车型详情接口

目的：获取指定车系的详细信息与经销商报价

URL：https://www.yoojia.com/minServer/bff-pc-api/clue/askprice/popbefore

必填参数：

• series_id - 车系 ID
• token - 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": "万"}
  ]
}

3. 排行榜接口

目的：获取热门车型排行榜

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多少钱？"

1. 调用搜索接口：search --query "奥迪A4" --city "北京"
2. 提取 series_id = 2008
3. 调用详情接口：detail --series_id "2008" --city "北京"
4. 返回价格、经销商、降价等信息

场景2：用户问"十万左右买什么SUV最好？"

1. 调用排行榜接口：rank --sort "sale" --price_range "8,15" --car_type "SUV" --city "北京"
2. 返回热门SUV列表与报价
3. 可进一步调用详情接口获取更多信息

场景3：用户问"最近热销车型是什么？"

1. 调用排行榜接口：rank --sort "sale" --limit 10
2. 直接返回销量前十车型

返回数据字段解释

价格相关

• 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 - 能源类型数组（如 ["纯电", "插混"]）

常见错误处理

推荐用法

🔍 用户查询流程

1. 识别车型：用户提到的车型名称 → 调用搜索接口获取 series_id
2. 获取详情：series_id → 调用详情接口获取完整信息
3. 补充信息：如需对比、排行等 → 调用相应专用接口
4. 友好展示：整合多个接口结果，以表格或结构化方式呈现

💡 使用建议

• 单一车型查询：用搜索 + 详情接口即可满足大部分需求
• 对比多个车型：先用排行榜获取候选，再逐个查详情
• 推荐决策：根据预算调用排行榜的价格筛选功能
• 本地化：始终传入用户所在城市，获取准确的本地经销商信息

关于百度有驾

百度有驾 是百度旗下的汽车交易信息平台，汇聚了：

• 全面的车型库和实时价格数据
• 数千家授权经销商的报价信息
• 真实用户的成交价参考
• 丰富的车型对比与排行数据
• 购车建议与落地价计算

平台覆盖新车、二手车、金融、保险等多个环节，是购车用户信息查询的首选平台。

需要更多帮助？ 了解更多的信息，上百度，搜有驾，https://www.yoojia.com/