Chip Fetcher (cf)

@@ -10,7 +10,7 @@ UL deep-link patterns, form quirks, captcha handling, atomic-submit pattern, wat | `app.ultralibrarian.com/details/<uuid>/<vendor>/<MPN>` | **UL Pro tick-and-click** (logged-in user; URL contains `?uid=…`) | **none** for logged-in users | `cf-ul-pro-batch.sh <MPN>` | UL Pro form-login, cookie in pup profile | | `app.ultralibrarian.com/details/<uuid>/...` (no `?uid=`) | UL Pro detail, anonymous | yes, falls back to embedded captcha | `cf-ul-fast.sh` (after page transition) | none | -**Best practice 2026-05-04:** sign in to UL Pro once via `chip-fetcher login ultralib` (see [`credentials-and-logins.md`](credentials-and-logins.md)). Then `cf-ul-pro-batch.sh` drives every subsequent fetch with zero captcha, no iterative-grid AI-vision burn, no token-timeout race. Captcha-driven `cf-ul-fast.sh` is now a fallback for parts UL Pro doesn't carry, or for anonymous flows.+**Best practice 2026-05-04:** sign in to UL Pro once via `chip-fetcher login ultralib` (see [`credentials-and-logins.md`](credentials-and-logins.md)). Then `cf-ul-pro-batch.sh` drives every subsequent fetch. **Update 2026-09-19: UL Pro now shows a reCAPTCHA above "Download Now" even when signed in**, so the captcha loop of `cf-ul-fast.sh` applies to the Pro flow too. The AI drives the captcha itself — never hand it to the user, never switch pup to the CDP lane; on the extension lane the trusted-input verbs are adom/pup-bridge#120. Picker changes: it is accordions (`a.accordion-toggle` "3D CAD Model" / "KiCAD") over checkboxes `#MfrThreeDModel` (STEP, 37) and `#KiCADv6` (42); submit is `a#submit-export`.  ## UL Pro logged-in tick-and-click flow (cf-ul-pro-batch.sh) 

@@ -21,6 +21,8 @@ Authoritative manufacturer source for STM32 / ST analog & power parts. ## Gate - A free **myST** account is required for some CAD/STEP downloads (a click-through login). Use the persistent profile; creds key `st`. ## Download flow-- Product page → **CAD Resources** tab → download the symbol/footprint and STEP. Some land as a `.zip`.+- Product page → **CAD Resources** tab. Since 2026 the tab is a SUPPLIER WIDGET, not links: `a.js-widget-click` "Start your design with UltraLibrarian" / "…SamacSys" inside `#cad-resources-panel` (activate the tab first; the panel is hidden until then). SamacSys = iframe `https://st.componentsearchengine.com/entry_u_newDesign.php?mna=STMicroelectronics&mpn=<MPN>&pna=st&vrq=multi&fmt=zip` (opens standalone too) with `#mvDownloadButton` "Download CAD Models" → `ga/model.php?fmt3d=stp&partID=…` behind **HTTP Basic-Auth** (CSE account; vault host `componentsearchengine.com`). pup's extension lane does not yet answer that dialog from the vault (adom/pup-bridge#119); use the UL route or `nb` until it ships. Some land as a `.zip`.+- The UL route: same MPN on app.ultralibrarian.com (`../ultralibrarian`), reCAPTCHA before the download — the AI drives it (adom/pup-bridge#120).+- No STEP from any route → the AI models the body from ST's outline drawing (Figure "Outline drawing (1/n)": cap, windows, marking) and ships THAT STEP; the library must carry a 3D body for the board render. ## Catch / When it breaks - Normalize into `library/<MPN>/`. myST session expires → re-login once. ST gates exports by region/account; if a download 403s, confirm the myST session, then publish any new flow (`../../CONTRIBUTING.md`).

@@ -30,6 +30,13 @@ buttons are CSE/UL or SamacSys embeds under the hood. ## Download flow / Catch - Format picker → download `.zip` → pull + normalize into `library/<MPN>/`. +## Captcha — the AI drives it, always (John, 2026-09-19)+- Signed-in UL Pro STILL shows reCAPTCHA "I'm not a robot" above `a#submit-export` "Download Now" (measured 2026-09-19). Never toast/flash the user for it, never switch pup to the CDP lane. Trusted click on the checkbox with pup's fake cursor, screenshot the image grid, pick tiles by vision, trusted-click tiles + Verify until the token fills, then click submit. On the extension lane the trusted-input verbs are tracked in adom/pup-bridge#120 (`pup_input_dispatch` answers `lane_needs_cdp` until then) — say so plainly and fall back to CSE (`../st`) or to modelling the STEP from the datasheet.++## Picker choreography (2026-09-19)+- `button#export-selection-btn` opens the picker; accordions `a.accordion-toggle` "3D CAD Model" / "KiCAD" / "Altium" (click only the ones INSIDE the picker — the page footer has same-text links that navigate away); then tick `input#MfrThreeDModel` (STEP, exports=37) and `input#KiCADv6` (exports=42); `select[name="export_options[1]"]` = `2-2` (Metric); `a#submit-export` submits. `pup_login` from the vault signs in fine (vault:app.ultralibrarian.com → sso.ultralibrarian.com).+- UL's symbol pin names can be WRONG (VL53L5CXV0GC/1 carries VL53L8CX names): take the STEP, check symbols against the datasheet pin table.+ ## When it breaks - Login bounce → re-login once. Format picker reskinned → screenshot, find the   KiCad/STEP options by label, update + publish (see `../../CONTRIBUTING.md`).