# Liyu Pinche Open Capability API

Purpose: readonly ride-search and official group-entry tools for LLM agents.
Base URL: https://www.pcsfc.com
Current stable LLM toolset: five readonly tools only.

## Tools

- getLiyuCapabilities: use for capability discovery or integration self-check.
- smartRideSearch: use for natural-language ride questions such as route, date, cargo, or passenger needs.
- searchRides: use when departure and destination are already structured.
- getRideDetail: use only when an info_id is known from search results.
- searchGroups: use when the user asks for official ride groups or group entry pages.

## Selection Rules

- Natural route question -> smartRideSearch with page_size 3.
- Structured route fields -> searchRides with page 1 and page_size 3.
- Detail by id -> getRideDetail.
- Group or official entry request -> searchGroups with action=groups, version=v1, include_detail=0, limit 3.
- Publish, contact, booking, payment, bulk export, hidden contact, or unrelated travel planning -> no tool.

## Output Rules

Use structured data first. Mention validity fields when present. Use entry_page_url for group delivery. Do not invent rides, prices, seats, contact details, groups, success rates, safety guarantees, or platform adoption.

## Safety Boundary

Readonly only. Do not publish ride requests, contact users, book seats, handle payments, export contact lists, reconstruct full phone numbers, expose raw QR assets, expose internal paths, or claim public adoption without verified non-internal traffic evidence.

## Verified Local Evidence

TENCENT_ADP_SAVED_TOOL_COUNT 5
TENCENT_ADP_FIVE_TOOL_CHECKTOOL_PASS 1
FIVE_TOOL_30CASE_STATIC_EVAL_PASS 1
FIVE_TOOL_READONLY_API_5CASE_SMOKE_PASS 1
NATURAL_USER_TRAFFIC_CONFIRMED 0
PUBLIC_ADOPTION_CLAIM_ALLOWED 0