epc_skill

Overview

This skill wraps the Jisu EPC (automotive parts) API to query vehicle parts trees, model details, VIN lookups, groups, diagrams, and part lists. It exposes endpoints to drill from brand to specific parts and to retrieve diagram hotspots and part numbers. Configure with a JISU_API_KEY and use the provided commands to fetch car lists, details, VIN info, groups, and group parts.

How this skill works

The skill calls Jisu EPC endpoints: /epc/car for brand and model hierarchy, /epc/cardetail for model metadata, /epc/vin to resolve VIN to a carid, /epc/group to list groups and diagram nodes, and /epc/groupparts to get parts for a diagram. Use group responses (isend, isgraph, grouptype) to recurse until diagrams are found, then fetch parts to get numbers, quantities, and hotspot coordinates. Error responses and API error codes are passed through from the provider.

When to use it

• Build an interactive EPC tree browser by brand, series, and model.
• Resolve a VIN to exact vehicle model and production info before parts lookup.
• Drill into engine or subsystem diagrams to extract part numbers and quantities.
• Provide clickable exploded diagrams with hotspot coordinates for a parts catalog.
• Verify part compatibility across model variants using carid and group metadata.

Best practices

• Always set JISU_API_KEY in environment before calling the skill.
• Start VIN-based lookups with /epc/vin to obtain carid for accurate results.
• Use /epc/group recursively and check isend/isgraph to find diagram levels reliably.
• Call /epc/groupparts only with a valid group parentid to retrieve parts and coordinates.
• Handle common API error codes (201–205, 220 and system codes 101–108) and surface clear messages to users.

Example use cases

• User asks “What is the EPC tree for this BMW?” → call vin or car then group recursively to assemble the tree.
• User asks “What parts are in the engine exploded view?” → locate the engine group via /epc/group then fetch /epc/groupparts for part numbers and counts.
• User wants to browse parts by brand → start with /epc/car parentid=0 to list brands and descend by selected IDs.
• Integrate into a parts ordering UI to display clickable diagram hotspots and fill order forms with part numbers and quantities.