百度有驾汽车查询 Skill

百度有驾出品。用一句自然语言即可查询汽车价格、车型详情、经销商报价、降价信息、落地价计算和车主成交价参考。

能力

安装

首次使用前安装：

pip install -e .

用法

from youjia_client import YoujiaClient

client = YoujiaClient()

result = client.ask_price("奥迪A4L多少钱", city="北京")

配置自己的百度有驾 Key（持久化到 .env，之后自动启用）：

from youjia_client import save_key_to_dotenv

save_key_to_dotenv("sk-xxxxxxxxxxxxx")

Key 检查

1. 已有 Key（用户传入 YoujiaClient(key=...)、环境变量 YOUJIA_API_KEY、skill 包内 .env 文件或 ~/.youjia/key.json）→ 直接使用

2. 未检测到 Key 时向用户输出以下选项：

   • 申请 Key（推荐）：手机号验证即可获取
   • 手动配置 Key：通过环境变量 YOUJIA_API_KEY 或 .env 文件配置

3. 用户选择"申请 Key" → 读取 tempkey-guide.md 按其中步骤执行；验证码校验通过后，新 Key 会覆盖本地 YOUJIA_API_KEY 环境变量与 skill 包内 .env

参数与返回

汽车价格查询 — ask_price

ask_price(query, city="北京")：查询汽车品牌、车系、车型详情、经销商报价、降价信息、落地价、车主成交价等。

返回：API 原生响应 dict，包含 car_info（车型信息）、advertise_price_info（价格汇总）、discount（降价信息）、net_price_info（裸车价/落地价）、price_info（费用明细）、owner_price_gap_detail（车主成交价参考）等字段。

辅助方法：YoujiaClient.format_for_reply(result) 将返回结果渲染为可直接发送给用户的 Markdown 格式。

使用要点

1. Key：未配置 Key 时按"Key 检查"流程处理；如已有 Key，用 save_key_to_dotenv 配置后稳定性更佳
2. query 必须包含车系名称，API 通过车系名识别具体车型
3. city 参数可选，不同城市的经销商报价可能不同
4. 返回的价格数据为实时数据，会随市场变化更新

示例

from youjia_client import YoujiaClient

client = YoujiaClient()

# 查询汽车价格
data = client.ask_price("奥迪A4L多少钱")

# 指定城市查询
data = client.ask_price("宝马3系报价", city="上海")

# 格式化为 Markdown 输出
print(YoujiaClient.format_for_reply(data))

调用细节、Key 流程等见 references/。