Extract a datasheet into a component twin
datasheetvend_build_component_twinExtract a datasheet with DatasheetVend Fast Extraction and return its Unified Component Model (UCM) digital twin in one call. Fast Extraction runs once for every requested module, and the modules' facts combine into one twin, filed where they belong: pins, whole_part (temperatures, absolute limits, package, ordering code), interfaces_rails, registers and checks — every fact with a check ('passed', 'needs_review', 'disagrees', 'failed_sanity_check') and, where recorded, its datasheet page. Returns the same ucm_twin_v1 view as datasheetvend_get_component_twin, with every section unless you ask for sections, one pin or a search, plus an extraction block: the engine, rescued_features (modules Fast Extraction could not complete at turbo speed that the standard deep engine extracted instead, slower for just those modules -- still billed and still in the twin), the modules NEITHER engine could extract (no credits charged for those), the credits charged and stored=false. Treat facts that did not pass as unverified and cite their page. The twin is NOT saved to your account: datasheetvend_get_component_twin and the dashboard will not find it, and calling again extracts and bills again. Needs a DatasheetVend API key. Costs the requested modules' credits: pinout (1 credit), absolute_max (2 credits), pin_cautions (2 credits), logic_levels (2 credits), thermal (2 credits), timing (2 credits), register_map (3 credits), peripheral_matrix (2 credits), power_battery (1 credit), part_decoder (2 credits), cad_normalized (1 credit, extracted as footprint); all of them 20 credits.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pin | No | One pin by number, name or alternate function (for example '27', 'PC4' or 'SDA'): every fact that reaches it — its own and those of its rails and interfaces. | |
| search | No | Only facts whose parameter, symbol, statement or node contains this text, case-insensitive (for example 'storage temperature' or 'TWCR'). With no sections given, searches pins, whole_part, interfaces_rails and registers. | |
| modules | No | Twin modules to extract and combine: pinout, absolute_max, pin_cautions, logic_levels, thermal, timing, register_map, peripheral_matrix, power_battery, part_decoder, cad_normalized. Omit for all of them. Each costs its module credits. | |
| partName | No | Optional part number / MPN to target in a datasheet that covers several parts. | |
| sections | No | Parts of the twin to include besides the summary: pins, whole_part, interfaces_rails, registers, checks. Omit, with no pin or search, for every section — this twin is not stored, so there is no second read. | |
| max_facts | No | Cap on facts returned across the pin and sections (default 200). `truncated` says when it was reached. | |
| only_passed | No | Only facts that passed every check. Default false: every fact comes with its check. | |
| documentPath | Yes | https:// URL to the datasheet PDF. The remote /api/mcp endpoint accepts ONLY https:// URLs (it downloads them). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pin | Yes | The requested pin with the facts that reach it, or null when no pin was asked for. | |
| part | Yes | ||
| checks | Yes | ||
| counts | Yes | ||
| places | Yes | ||
| contract | Yes | Contract id: ucm_twin_v1 | |
| sections | Yes | The requested sections: pins, whole_part, interfaces_rails, registers, checks — facts with their check and, where recorded, their page. | |
| warnings | Yes | ||
| datasheet | Yes | ||
| truncated | Yes | ||
| built_from | Yes | ||
| extraction | Yes | The Fast Extraction run behind this twin | |
| how_to_read | Yes |