partsouq.com - OEM parts lookup by VIN (live EPC mirror)

Notes an AI agent reads before it works on partsouq.com: what to open, what to call, what breaks. Written by browser-harness contributors after real runs, and kept on GitHub under the MIT license.

Run it in Browser Use Cloud Source on GitHub

Give it to your agent

Any coding agent

Start the task with this line. The Markdown version is the same notes without the page around them.

Read https://browser-use.com/skills/partsouq.md, then <your task>

Browser Harness

Save the files into your workspace and turn domain skills on. The code below calls its helpers, such as http_get and js. What Browser Harness is.

d="${BH_AGENT_WORKSPACE:-$HOME/.config/browser-harness/agent-workspace}/domain-skills/partsouq"
mkdir -p "$d" && cd "$d"
curl -sLO https://raw.githubusercontent.com/browser-use/browser-harness/main/agent-workspace/domain-skills/partsouq/vin-lookup.md
export BH_DOMAIN_SKILLS=1

Validated 2026-08-12 (Toyota/Lexus, brand-new 2026 VIN resolved perfectly).

The one URL that matters

https://partsouq.com/en/search/all?q=<17-char VIN>

Redirects straight into the manufacturer EPC catalog for that exact vehicle (region/year/model/modelcode, e.g. GYU15L-BWXGBA), with production date, color code, trim code shown. No login needed for browsing.

Search inside the vehicle

The vehicle page has a "Search in vehicle" box - accepts part names, 5-digit Toyota base codes (e.g. 44250), or callouts. Results give full part numbers with qty + production-date applicability windows and link to the exploded diagram (figure) pages.

Why this beats the alternatives

Toyota TIS (techinfo.toyota.com) does NOT include the parts catalog on standard subscriptions - t3Portal/resources/jsp/partscatalog/index.jsp just errors ("There was an error in the page you requested"). Don't chase it.
US dealer e-commerce sites (RevolutionParts network: lexuspartsnow, parts.<dealer>.com) lag months behind on new models - their VIN decoders reject brand-new VINs ("unable to process") and new-model catalogs may list accessories only. They also 403 non-browser fetchers (WebFetch/curl); they load fine in a real browser.
PartSouq's EPC data is near-live (had a 2026 PHV weeks after production).

Traps

Diagram footnote N01 callouts = parts not supplied individually.
Fitment differs across trims of the same model line. Resolve the exact part through the VIN-specific catalog. Verify its production-date applicability before ordering.

vin-lookup.md · updated Oct 9, 2026 · 230 words

Sites change. These notes describe what worked when they were last updated, not a guarantee they still do. If something broke, the fix is a pull request to browser-harness.