mouser

用途

Mouser 技能用于在 Mouser Electronics 上搜索电子元器件，作为原型订单的次要来源。当 DigiKey 缺货或价格较差时使用。生产订单请参考 lcsc/jlcpcb。相关技能中，kicad 负责原理图分析并提取 MPN，bom 负责跨分销商的 BOM 采购编排，digikey 是原型主要来源（数据手册优先使用其直接 PDF 链接），spice 使用 Mouser 参数数据构建行为级 SPICE 模型。

主要能力

关键词搜索元器件，支持按库存、RoHS 等条件筛选，每页最多 50 条
按料号搜索，支持 Mouser 料号与制造商料号（MPN），一次最多 10 个，用竖线分隔
V2 端点支持制造商名称过滤与按页码分页
返回字段包括料号、制造商、描述、分类、数据手册 URL、产品详情 URL、库存、在途库存、交期、生命周期状态、是否停产、建议替代料、最小起订量、订购倍数、卷带包装、RoHS 状态、阶梯价格、参数属性、替代包装、附加费信息和合规信息
数据手册下载与同步，可维护与 KiCad 项目同目录的 datasheets/ 目录
支持从纯 MPN 列表批量同步数据手册

使用方式

需要先设置 Mouser Search API Key：

export MOUSER_SEARCH_API_KEY=your-search-api-key-uuid

API Key 获取方式：访问 mouser.com → My Mouser → My Account，在 APIs 部分点击 Manage，注册 Search API key。密钥可能需要审批，初始状态显示 pending authorization。

搜索端点均以查询参数传递密钥：?apiKey=<key>，POST 请求 Content-Type 为 application/json。

V1 关键词搜索： POST /api/v1/search/keyword?apiKey=<key> { "SearchByKeywordRequest": { "keyword": "100nF 0402 ceramic capacitor", "records": 50, "startingRecord": 0, "searchOptions": "InStock" } }

searchOptions 可选："None" | "Rohs" | "InStock" | "RohsAndInStock"；records 最大 50；startingRecord 为分页偏移。

V1 料号搜索： POST /api/v1/search/partnumber?apiKey=<key> { "SearchByPartRequest": { "mouserPartNumber": "GRM155R71C104KA88D|RC0402FR-0710KL", "partSearchOptions": "Exact" } }

partSearchOptions 可选："Exact" | "BeginsWith" | "Contains"。

V2 关键词加制造商搜索： POST /api/v2/search/keywordandmanufacturer?apiKey=<key> { "SearchByKeywordMfrNameRequest": { "keyword": "LMR51450", "manufacturerName": "Texas Instruments", "records": 25, "pageNumber": 1, "searchOptions": "InStock" } }

V2 制造商列表： GET /api/v2/search/manufacturerlist?apiKey=<key>

V1 的 keywordandmanufacturer、partnumberandmanufacturer 和 manufacturerlist 已弃用，建议使用 V2 版本。

数据手册同步脚本： python3 <skill-path>/scripts/sync_datasheets_mouser.py <file.kicad_sch> 可加 --dry-run 预览、--force 重试失败项、-o 指定输出目录、--parallel 并行下载。批量模式： python3 <skill-path>/scripts/sync_datasheets_mouser.py --mpn-list mpns.txt --output ./datasheets

单次数据手册下载： python3 <skill-path>/scripts/fetch_datasheet_mouser.py --search "TPS61023DRLR" -o datasheet.pdf

脚本默认在请求间加 1.0 秒延迟（免费层 30 次/分钟），可用 --delay 覆盖。数据手册下载按顺序尝试：原理图内嵌 URL、Mouser API 搜索、制造商替代 URL、headless 浏览器兜底。全部失败时应向用户提供 ProductDetailUrl，让用户在浏览器中下载。

无 API Key 时，可直接抓取搜索页：https://www.mouser.com/c/?q=<query>，但结果可能较杂乱（页面重度依赖 JS）。

适用场景

DigiKey 缺货或价格较差时的原型采购询价
为 KiCad 工程同步或补全数据手册
从纯 MPN 列表批量查找元器件与数据手册
查询价格阶梯、库存、交期、生命周期状态、停产替代料等参数
使用 Mouser 参数数据构建 SPICE 模型

限制

数据手册的 Mouser 托管 URL 会阻止自动化下载，即使带浏览器 User-Agent 也返回 HTML Access denied 页面；Mouser 产品页对多数自动请求返回 403，数据手册优先用 DigiKey。
免费层 Search API 约每分钟 30 次调用。
价格字段是带货币符号的字符串，如 "$0.10"；库存是字符串；IsDiscontinued 也是字符串 "true"/"false"，比较前需要解析。
Mouser 料号带 Mouser 专属前缀，跨分销商匹配应使用 ManufacturerPartNumber。
V2 包装对象名为 SearchByKeywordMfrNameRequest，V1 名称已弃用。
部分元器件有最小起订量和订购倍数限制；SurchargeMessages 可能包含美国关税百分比。
未提供免费层外的具体收费、价格信息。

技能介绍

用途

主要能力

使用方式

适用场景

限制