element14

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

element14 / Newark / Farnell — Component Search, Datasheets & Ordering

Related Skills

Skill	Purpose
`kicad`	Schematic analysis — extracts MPNs for part lookup
`bom`	BOM management — orchestrates sourcing across distributors
`spice`	Uses element14 parametric data for behavioral SPICE models

Storefront	Region	Store ID
Newark	North America	`www.newark.com`
Farnell	UK / Europe	`uk.farnell.com`
element14	Asia-Pacific	`au.element14.com`

技能	用途
`kicad`	原理图分析——提取用于零件查找的MPN
`bom`	BOM管理——协调跨分销商的采购工作
`spice`	利用element14的参数化数据生成行为级SPICE模型

门店	区域	门店ID
Newark	北美	`www.newark.com`
Farnell	英国/欧洲	`uk.farnell.com`
element14	亚太	`au.element14.com`

Key Differences from DigiKey/Mouser

与DigiKey/Mouser的主要区别

Simple auth — API key as a query parameter, no OAuth flow
Free API key — register at partner.element14.com, courtesy usage allowance
Global coverage — same API covers US (Newark), EU (Farnell), APAC (element14)
Unprotected PDFs — datasheets hosted on farnell.com CDN, download freely with no bot protection
Datasheet URL in API response —
```
responseGroup=medium
```
includes
```
datasheets[].url
```

简单认证——将API密钥作为查询参数，无需OAuth流程
免费API密钥——在partner.element14.com注册即可获取，提供免费使用额度
全球覆盖——同一API覆盖美国（Newark）、欧盟（Farnell）、亚太（element14）
无防护PDF——Datasheet托管在farnell.com的CDN上，可免费下载，无机器人防护
API响应包含Datasheet URL——
```
responseGroup=medium
```
会返回
```
datasheets[].url
```
字段

API Credential Setup

API凭证设置

Register at partner.element14.com/member/register
- Free account — just username, email, password. No credit card needed.
- Provides a "courtesy usage allowance" (2 calls/sec, 1,000 calls/day — sufficient for normal use)
Register an application — after logging in, go to My API Keys and click "Get API Keys"
- App name: anything (e.g., "kicad-happy")
- Type: "Desktop application"
- Users: "1-10"
- Commercial: No
- Advertising: No
- Check "Issue a new key for Product Search API" → select "Basic" tier
- Agree to Terms of Service and click "Register Application"
Copy your API key — a 24-character alphanumeric string shown on the My API Keys page

Set the environment variable

ELEMENT14_API_KEY

before running the scripts:

bash

export ELEMENT14_API_KEY=your_api_key_here

If credentials are stored in a central secrets file (e.g.,

~/.config/secrets.env

), load them first:

bash

export $(grep -v '^#' ~/.config/secrets.env | grep -v '^$' | xargs)

注册账号：访问partner.element14.com/member/register
- 免费账号——仅需用户名、邮箱、密码，无需信用卡
- 提供“免费使用额度”（每秒2次调用，每日1000次调用——满足日常使用需求）
注册应用——登录后，进入我的API密钥页面，点击“获取API密钥”
- 应用名称：任意名称（例如："kicad-happy"）
- 类型：“桌面应用”
- 用户数量：“1-10”
- 商用：否
- 广告：否
- 勾选“为产品搜索API颁发新密钥”→选择“基础” tier
- 同意服务条款并点击“注册应用”
复制API密钥——在“我的API密钥”页面会显示一个24位的字母数字字符串

设置环境变量

ELEMENT14_API_KEY

，然后再运行脚本：

bash

export ELEMENT14_API_KEY=your_api_key_here

如果凭证存储在中央密钥文件中（例如：

~/.config/secrets.env

），请先加载：

bash

export $(grep -v '^#' ~/.config/secrets.env | grep -v '^$' | xargs)

Product Search API

产品搜索API

Base URL:

https://api.element14.com/catalog/products

All requests use GET with query parameters. Authentication is via

callInfo.apiKey

基础URL：

https://api.element14.com/catalog/products

所有请求均使用GET方法并附带查询参数，通过

callInfo.apiKey

进行认证。

Search Modes

搜索模式

The

term

parameter supports three search types:

Mode	Format	Example
Keyword	`any:<keywords>`	`term=any:100nF 0402 X7R`
MPN	`manuPartNum:<mpn>`	`term=manuPartNum:GRM155R71C104KA88D`
Distributor PN	`id:<sku>`	`term=id:94AK6874`

term

参数支持三种搜索类型：

模式	格式	示例
关键词	`any:<keywords>`	`term=any:100nF 0402 X7R`
MPN	`manuPartNum:<mpn>`	`term=manuPartNum:GRM155R71C104KA88D`
分销商零件编号	`id:<sku>`	`term=id:94AK6874`

Full Example

完整示例

GET https://api.element14.com/catalog/products
  ?term=manuPartNum:GRM155R71C104KA88D
  &storeInfo.id=www.newark.com
  &resultsSettings.offset=0
  &resultsSettings.numberOfResults=10
  &resultsSettings.responseGroup=medium
  &callInfo.responseDataFormat=JSON
  &callInfo.apiKey=YOUR_KEY

GET https://api.element14.com/catalog/products
  ?term=manuPartNum:GRM155R71C104KA88D
  &storeInfo.id=www.newark.com
  &resultsSettings.offset=0
  &resultsSettings.numberOfResults=10
  &resultsSettings.responseGroup=medium
  &callInfo.responseDataFormat=JSON
  &callInfo.apiKey=YOUR_KEY

Response Groups

响应分组

Group	Fields
`small`	SKU, displayName, brandName, MPN, attributes
`medium`	+ datasheets[], prices[], stock
`large`	+ images, related products, country of origin
`prices`	Tiered pricing only
`inventory`	Stock levels by warehouse/region

分组	包含字段
`small`	SKU、displayName、brandName、MPN、attributes
`medium`	+ datasheets[]、prices[]、stock
`large`	+ images、相关产品、原产国
`prices`	仅包含阶梯定价
`inventory`	按仓库/区域划分的库存水平

Response Format

响应格式

With

responseGroup=medium

, the response looks like:

json

{
  "manufacturerPartNumberSearchReturn": {
    "numberOfResults": 5,
    "products": [
      {
        "sku": "94AK6874",
        "displayName": "Murata GRM155R71C104KA88D",
        "translatedManufacturerPartNumber": "GRM155R71C104KA88D",
        "brandName": "Murata Electronics",
        "datasheets": [
          {
            "type": "TechnicalDataSheet",
            "description": "Datasheet",
            "url": "https://www.farnell.com/datasheets/74273.pdf"
          }
        ],
        "prices": [
          {
            "from": 1,
            "to": 9,
            "cost": 0.156
          }
        ],
        "stock": {
          "level": 45000,
          "leastLeadTime": 0,
          "status": 4,
          "statusMessage": "In Stock"
        },
        "attributes": [
          {"attributeLabel": "Capacitance", "attributeUnit": "", "attributeValue": "100nF"},
          {"attributeLabel": "Voltage Rating", "attributeUnit": "V", "attributeValue": "16"}
        ],
        "rohsStatusCode": "YES"
      }
    ]
  }
}

Key fields:

```
sku
```
— Newark/Farnell/element14 part number
```
translatedManufacturerPartNumber
```
— MPN
```
brandName
```
— manufacturer
```
datasheets[].url
```
— direct PDF URL (farnell.com CDN, no bot protection)
```
datasheets[].type
```
— usually
```
TechnicalDataSheet
```
```
prices[]
```
— tiered pricing with
```
from
```
,
```
to
```
,
```
cost
```
```
stock.level
```
— quantity in stock
```
stock.statusMessage
```
— human-readable availability
```
attributes[]
```
— parametric specs (label, unit, value)
```
rohsStatusCode
```
— RoHS compliance (
```
YES
```
/
```
NO
```
)

当使用

responseGroup=medium

时，响应格式如下：

json

{
  "manufacturerPartNumberSearchReturn": {
    "numberOfResults": 5,
    "products": [
      {
        "sku": "94AK6874",
        "displayName": "Murata GRM155R71C104KA88D",
        "translatedManufacturerPartNumber": "GRM155R71C104KA88D",
        "brandName": "Murata Electronics",
        "datasheets": [
          {
            "type": "TechnicalDataSheet",
            "description": "Datasheet",
            "url": "https://www.farnell.com/datasheets/74273.pdf"
          }
        ],
        "prices": [
          {
            "from": 1,
            "to": 9,
            "cost": 0.156
          }
        ],
        "stock": {
          "level": 45000,
          "leastLeadTime": 0,
          "status": 4,
          "statusMessage": "In Stock"
        },
        "attributes": [
          {"attributeLabel": "Capacitance", "attributeUnit": "", "attributeValue": "100nF"},
          {"attributeLabel": "Voltage Rating", "attributeUnit": "V", "attributeValue": "16"}
        ],
        "rohsStatusCode": "YES"
      }
    ]
  }
}

关键字段：

```
sku
```
— Newark/Farnell/element14的零件编号
```
translatedManufacturerPartNumber
```
— MPN
```
brandName
```
— 制造商
```
datasheets[].url
```
— 直接PDF链接（托管在farnell.com的CDN上，无机器人防护）
```
datasheets[].type
```
— 通常为
```
TechnicalDataSheet
```
```
prices[]
```
— 包含
```
from
```
、
```
to
```
、
```
cost
```
的阶梯定价
```
stock.level
```
— 库存数量
```
stock.statusMessage
```
— 易读的库存状态
```
attributes[]
```
— 参数化规格（标签、单位、值）
```
rohsStatusCode
```
— RoHS合规性（
```
YES
```
/
```
NO
```
）

Store IDs

门店ID

Common store IDs for the

storeInfo.id

parameter:

Store ID	Region
`www.newark.com`	US (default)
`uk.farnell.com`	UK
`www.farnell.com`	EU
`au.element14.com`	Australia
`sg.element14.com`	Singapore
`in.element14.com`	India

storeInfo.id

参数常用的门店ID：

门店ID	区域
`www.newark.com`	美国（默认）
`uk.farnell.com`	英国
`www.farnell.com`	欧盟
`au.element14.com`	澳大利亚
`sg.element14.com`	新加坡
`in.element14.com`	印度

Rate Limits

请求速率限制

No documented rate limits beyond the courtesy usage allowance. Be respectful — use 0.5s delays between calls.

除免费使用额度外，无其他文档化的速率限制。请合理使用——在调用之间设置0.5秒的延迟。

Filters

过滤器

Add to query parameters:

resultsSettings.refinements.filter=rohsCompliant

— RoHS parts only

resultsSettings.refinements.filter=inStock

— in-stock only

可添加到查询参数中：

resultsSettings.refinements.filter=rohsCompliant

— 仅显示RoHS合规零件

resultsSettings.refinements.filter=inStock

— 仅显示有库存的零件

Pagination

分页

```
resultsSettings.offset
```
— starting index (0-based)
```
resultsSettings.numberOfResults
```
— max 50 per page
Only the first 100 results are reliably pageable

```
resultsSettings.offset
```
— 起始索引（从0开始）
```
resultsSettings.numberOfResults
```
— 每页最多50条结果
仅前100条结果支持可靠分页

Datasheet Download & Sync

Datasheet下载与同步

element14's farnell.com CDN serves datasheet PDFs directly — no bot protection, no special headers needed. Datasheet URLs come from the API response (

datasheets[].url

element14的farnell.com CDN直接提供Datasheet PDF文件——无需机器人防护，无需特殊请求头。Datasheet链接来自API响应中的

datasheets[].url

字段。

Datasheet Directory Sync

Datasheet目录同步

Use

sync_datasheets_element14.py

to maintain a

datasheets/

directory alongside a KiCad project. Same workflow and

manifest.json

format as the DigiKey, Mouser, and LCSC skills.

bash

undefined

使用

sync_datasheets_element14.py

脚本可在KiCad项目旁维护一个

datasheets/

目录。工作流和

manifest.json

格式与DigiKey、Mouser和LCSC技能一致。

bash

undefined

Sync datasheets for a KiCad project

同步KiCad项目的Datasheet

python3 <skill-path>/scripts/sync_datasheets_element14.py <file.kicad_sch>

Preview what would be downloaded

预览将要下载的内容

python3 <skill-path>/scripts/sync_datasheets_element14.py <file.kicad_sch> --dry-run

Retry previously failed downloads

重试之前失败的下载

python3 <skill-path>/scripts/sync_datasheets_element14.py <file.kicad_sch> --force

Use a specific store (default: www.newark.com)

使用指定门店（默认：www.newark.com）

python3 <skill-path>/scripts/sync_datasheets_element14.py <file.kicad_sch> --store uk.farnell.com

Custom output directory

自定义输出目录

python3 <skill-path>/scripts/sync_datasheets_element14.py <file.kicad_sch> -o ./my-datasheets

Parallel downloads (3 workers)

并行下载（3个工作进程）

python3 <skill-path>/scripts/sync_datasheets_element14.py <file.kicad_sch> --parallel 3

Batch mode — sync from a plain MPN list (no KiCad project required)

批量模式——从纯MPN列表同步（无需KiCad项目）

python3 <skill-path>/scripts/sync_datasheets_element14.py --mpn-list mpns.txt --output ./datasheets


**MPN-list batch mode** (KH-312) — when you have a list of MPNs but no
KiCad project to point at. One MPN per line; blank lines and `#`
comments (full-line and inline) are skipped; generic values are filtered
via `is_real_mpn()` and de-duplicated. Output defaults to `./datasheets/`
in the current working directory when `--output` is omitted. Note:
`ELEMENT14_API_KEY` is still required even in dry-run mode; see the
v1.4 follow-up in the issue tracker if dry-run credential-independence
matters for your workflow.

The script:
- **Runs the kicad schematic analyzer** to extract components, MPNs, and distributor PNs
- **Accepts any identifier** — MPN, Newark/Farnell PN, or other distributor PNs from KiCad symbol properties
- **Prefers MPN search** (`manuPartNum:`) for exact match — falls back to keyword search
- **Downloads from farnell.com CDN** — direct PDF URLs, no bot protection
- **Writes `manifest.json` manifest** — same format as DigiKey/Mouser/LCSC skills
- **Verifies PDF content** — checks MPN, manufacturer, and description keywords
- **Rate-limited** — 0.5s between API calls (configurable with `--delay`)
- **Saves progress incrementally** — safe to interrupt

python3 <skill-path>/scripts/sync_datasheets_element14.py --mpn-list mpns.txt --output ./datasheets


**MPN列表批量模式**（KH-312）——当你有MPN列表但没有对应的KiCad项目时使用。每行一个MPN；空行和`#`注释（整行或行内）会被跳过；通过`is_real_mpn()`过滤通用值并去重。如果未指定`--output`，默认输出到当前工作目录的`./datasheets/`。注意：即使在dry-run模式下，仍需`ELEMENT14_API_KEY`；如果dry-run模式下无需凭证对你的工作流很重要，请查看问题追踪器中的v1.4后续更新。

该脚本具备以下功能：
- **运行KiCad原理图分析器**以提取元件、MPN和分销商零件编号
- **支持任意标识符**——MPN、Newark/Farnell零件编号或KiCad符号属性中的其他分销商零件编号
- **优先使用MPN搜索**（`manuPartNum:`）以获取精确匹配——如果失败则回退到关键词搜索
- **从farnell.com CDN下载**——直接PDF链接，无机器人防护
- **生成`manifest.json`清单**——格式与DigiKey/Mouser/LCSC技能一致
- **验证PDF内容**——检查MPN、制造商和描述关键词
- **速率限制**——API调用之间间隔0.5秒（可通过`--delay`配置）
- **增量保存进度**——中断后可安全恢复

Single Datasheet Download

单个Datasheet下载

Use

fetch_datasheet_element14.py

for one-off downloads.

bash

undefined

使用

fetch_datasheet_element14.py

脚本进行单次下载。

bash

undefined

Search by MPN

通过MPN搜索

python3 <skill-path>/scripts/fetch_datasheet_element14.py --search "GRM155R71C104KA88D" -o datasheet.pdf

Search by Newark/Farnell part number

通过Newark/Farnell零件编号搜索

python3 <skill-path>/scripts/fetch_datasheet_element14.py --search "94AK6874" -o datasheet.pdf

Direct URL download

直接通过URL下载

python3 <skill-path>/scripts/fetch_datasheet_element14.py "https://www.farnell.com/datasheets/74273.pdf" -o datasheet.pdf

JSON output

输出JSON格式结果

python3 <skill-path>/scripts/fetch_datasheet_element14.py --search "GRM155R71C104KA88D" --json


The script:
- **OS-agnostic** — uses `requests` → `urllib` → `playwright` fallback chain
- **Validates PDF headers** — rejects HTML error pages
- **Falls back to alternative manufacturer sources** when element14 URL fails
- **Exit codes**: 0 = success, 1 = download failed, 2 = search/API error
- **Dependencies**:
  - `pip install requests` (recommended; urllib fallback works fine for element14)
  - `pip install playwright && playwright install chromium` (optional; rarely needed)

python3 <skill-path>/scripts/fetch_datasheet_element14.py --search "GRM155R71C104KA88D" --json


该脚本具备以下功能：
- **跨平台兼容**——采用`requests` → `urllib` → `playwright`的 fallback 链
- **验证PDF头**——拒绝HTML错误页面
- **当element14链接失败时，回退到其他制造商来源**
- **退出码**：0 = 成功，1 = 下载失败，2 = 搜索/API错误
- **依赖项**：
  - `pip install requests`（推荐；urllib fallback可正常用于element14）
  - `pip install playwright && playwright install chromium`（可选；很少需要）

Web Search Fallback

网页搜索回退方案

If the API is unavailable, search by fetching product pages directly:

https://www.newark.com/search?st=<query>
https://uk.farnell.com/search?st=<query>

如果API不可用，可直接抓取产品页面进行搜索：

https://www.newark.com/search?st=<query>
https://uk.farnell.com/search?st=<query>

Tips

小贴士

Use
```
responseGroup=medium
```
— includes datasheets and pricing without the overhead of
```
large
```
Use
```
manuPartNum:
```
prefix for exact MPN matches;
```
any:
```
for keyword search
Cross-reference using
```
translatedManufacturerPartNumber
```
(MPN) across DigiKey/Mouser/LCSC
Useful for international users where DigiKey/Mouser shipping is expensive

使用
```
responseGroup=medium
```
——包含Datasheet和价格信息，且没有
```
large
```
分组的额外开销
使用
```
manuPartNum:
```
前缀进行精确MPN匹配；使用
```
any:
```
进行关键词搜索
通过
```
translatedManufacturerPartNumber
```
（MPN）在DigiKey/Mouser/LCSC之间进行交叉参考
对国际用户非常实用，因为DigiKey/Mouser的运费可能很高

element14

Original

Translation

element14 / Newark / Farnell — Component Search, Datasheets & Ordering

element14 / Newark / Farnell — Component Search, Datasheets & Ordering

Related Skills

相关技能

Key Differences from DigiKey/Mouser

与DigiKey/Mouser的主要区别

API Credential Setup

API凭证设置

Product Search API

产品搜索API

Search Modes

搜索模式

Full Example

完整示例

Response Groups

响应分组

Response Format

响应格式

Store IDs

门店ID

Rate Limits

请求速率限制

Filters

过滤器

Pagination

分页

Datasheet Download & Sync

Datasheet下载与同步

Datasheet Directory Sync

Datasheet目录同步

Sync datasheets for a KiCad project

同步KiCad项目的Datasheet

Preview what would be downloaded

预览将要下载的内容

Retry previously failed downloads

重试之前失败的下载

Use a specific store (default: www.newark.com)

使用指定门店（默认：www.newark.com）

Custom output directory

自定义输出目录

Parallel downloads (3 workers)

并行下载（3个工作进程）

Batch mode — sync from a plain MPN list (no KiCad project required)

批量模式——从纯MPN列表同步（无需KiCad项目）

Single Datasheet Download

单个Datasheet下载

Search by MPN

通过MPN搜索

Search by Newark/Farnell part number

通过Newark/Farnell零件编号搜索

Direct URL download

直接通过URL下载

JSON output

输出JSON格式结果

Web Search Fallback

网页搜索回退方案

Tips

小贴士