五工具只读候选包：不发布、不联系、不订座、不支付、不导出联系方式。

五工具 API Reference

本页只列当前建议暴露给大模型的五个只读端点。旧聚合工具、发布写入、联系用户、后台统计、批量导出不在本页范围内。

Base URL

https://www.pcsfc.com

通用响应

{
  "code": 0,
  "message": "success",
  "data": {},
  "meta": {
    "source": "里鱼拼车官方数据",
    "request_id": "req_xxx"
  }
}

调用方优先使用 data 的结构化字段。reply 或 rendered_answer 可作为面向用户的摘要，但不能覆盖结构化有效性字段。

getLiyuCapabilities

GET /lypinche/capabilities

用途：能力自检、读取只读边界和工具说明。

模型规则：不要用能力清单回答具体路线是否有车。

smartRideSearch

POST /lypinche/smart
Content-Type: application/json

{"query":"明天济南到北京有没有顺风车","page_size":3}

用途：用户用自然语言询问路线、日期、车找人、人找车或货找车时优先使用。

参数：

query required string max 200
page_size default 3 max 5

回答规则：展示路线、时间、类型、座位、有效性说明；不补充接口未返回的车源、价格、联系方式或成交承诺。

searchRides

POST /lypinche/search
Content-Type: application/json

{"departure":"济南","destination":"北京","page":1,"page_size":3}

用途：出发地和目的地已结构化时使用。

参数：

departure required string
destination required string
type optional 1=人找车 2=车找人 3=车找货 4=货找车
date optional string
page default 1 max 5
page_size default 3 max 5

回答规则：最多展示 3 条；用户明确要求更多时最多 5 条，不做批量导出。

getRideDetail

GET /lypinche/pcdetail?info_id=259334

用途：用户已经有 info_id 并要求查看单条公开详情。

模型规则：没有 info_id 时先让用户选择结果，不要猜 ID。联系方式只能按接口返回的脱敏字段展示。

searchGroups

GET /lypinche?action=groups&version=v1&keyword=曹县青岛拼车群&limit=3&include_detail=0

用途：用户找拼车群、官方群、群入口，或查车无结果后想看相关群入口。

参数：

action groups
version v1
keyword required when departure/destination absent
departure optional string
destination optional string
limit default 3 max 5
include_detail 0

回答规则：只提供 entry_page_url 官方中转页。不要输出原始 QR 资产、内部路径、隐藏参数或群资产文件名。

不调用工具的场景

用户要求代发布
用户要求代联系司机或乘客
用户要求订座、支付、交易撮合
用户要求导出联系方式
用户要求完整手机号或隐藏联系方式
用户要求原始 QR 资产或内部文件路径
用户问无关旅游攻略、天气、酒店等泛旅行问题

五工具 API Reference

Base URL

通用响应

getLiyuCapabilities

smartRideSearch

searchRides

getRideDetail

searchGroups

不调用工具的场景

推荐错误处理