hashgraph-online/awesome-codex-plugins / plugins/aklofas/kicad-happy/skills/digikey
digikey
VerifiedSearch DigiKey for electronic components and download datasheets — primary source for prototype orders and the preferred API method for fetching datasheets. Find parts by keyword or MPN, check pricing/stock, download datasheets via API, analyze specifications. Sync and maintain a local datasheets directory — extract components from schematics, download missing datasheets, keep them up to date. Also supports batch MPN-list seeding (`--mpn-list`) for bulk workflows without a KiCad project. Use when the user asks about electronic components, part specs, datasheets, pricing, stock, footprints, or needs to download a datasheet — even without mentioning "DigiKey". Also for "sync datasheets", "download datasheets for my board/project", or mentions a datasheets directory. DigiKey is the default distributor for prototyping. For BOM workflows, see the bom skill.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 18.5 KB |
| scripts/_core_path.py | script | 697 B |
| scripts/fetch_datasheet_digikey.py | script | 5.9 KB |
| scripts/provider_digikey.py | script | 15.2 KB |
| scripts/sync_datasheets_digikey.py | script | 2.4 KB |
scripts/fetch_datasheet_digikey.py
View on GitHub#!/usr/bin/env python3
"""Download a datasheet PDF from a manufacturer URL.
Handles manufacturer-specific quirks:
- TI: DigiKey returns JS-redirect URLs; this script extracts the direct PDF URL
- Protocol-relative URLs (//mm.digikey.com/...): adds https: prefix
- Microchip: Redirects to login; uses alternative URL patterns as fallback
- Various manufacturers that block bare urllib: uses requests library with
proper User-Agent (some sites, such as analog.com, time out over urllib but
answer requests)
Usage:
python3 fetch_datasheet_digikey.py <url> [--output <path>]
python3 fetch_datasheet_digikey.py --search <MPN> [--output <path>]
The --search mode requires DIGIKEY_CLIENT_ID and DIGIKEY_CLIENT_SECRET
environment variables.
Dependencies:
- requests (pip install requests) — preferred, handles all manufacturer sites
- Falls back to urllib if requests is not installed or is older than 2.32.2 (some sites may fail)
Exit codes:
0 = success (PDF downloaded)
1 = download failed after all attempts
2 = search failed (API error or part not found)
"""
import argparse
import json
import sys
import _core_path # noqa: F401
from distributor_core.download import (download_pdf, try_alternative_sources,
add_download_args, apply_download_args)
from distributor_core.verify import fetch_mismatch, refuse_fetch_hit, same_part, verify_datasheet
from distributor_core.manifest import _friendly_filename
from provider_digikey import _digikey_pns, search_digikey
def main():
parser = argparse.ArgumentParser(description="Download a datasheet PDF")
group = parser.add_mutually_exclusive_group(required=True)
group.add_argument("url", nargs="?", help="Direct URL to the PDF")
group.add_argument("--search", metavar="MPN", help="Search DigiKey by MPN and download the datasheet")
parser.add_argument("--output", "-o", help="Output file path (default: <MPN>.pdf in current directory)")
parser.add_argument("--json", action="store_true", help="Output result as JSON (for script integration)")
add_download_args(parser)
args = parser.parse_args()
apply_download_args(args)
if args.search:
product = search_digikey(args.search)
if not product:
if args.json:
json.dump({"success": False, "error": "Part not found"}, sys.stdout)
sys.exit(2)
mpn = product.get("ManufacturerProductNumber", args.search)
other = fetch_mismatch(args.search, mpn, _digikey_pns(product))
if other:
refuse_fetch_hit("DigiKey", args.search, other, args.json)
verify_pn = args.search if same_part(args.search, mpn) else mpn
desc = product.get("Description", {}).get("ProductDescription", "")
ds_url = product.get("DatasheetUrl", "")
output_path = args.output or (_friendly_filename(mpn, desc) + ".pdf")
if args.json:
result = {
"mpn": mpn,
"manufacturer": product.get("Manufacturer", {}).get("Name", ""),
"description": product.get("Description", {}).get("ProductDescription", ""),
"datasheet_url": ds_url,
}
if not ds_url:
print(f"No datasheet URL for {mpn}", file=sys.stderr)
if args.json:
result["success"] = False
result["error"] = "No datasheet URL in DigiKey listing"
json.dump(result, sys.stdout)
sys.exit(2)
if download_pdf(ds_url, output_path):
vr = verify_datasheet(output_path, verify_pn, desc,
product.get("Manufacturer", {}).get("Name", ""))
if vr["confidence"] == "wrong":
print(f"WARNING: Downloaded PDF may be wrong datasheet for {mpn}",
file=sys.stderr)
print(f" {vr['details']}", file=sys.stderr)
elif vr["confidence"] == "unverified":
print(f" Verification inconclusive for {mpn}: {vr['details']}",
file=sys.stderr)
if args.json:
result["success"] = True
result["output"] = output_path
result["verification"] = vr
json.dump(result, sys.stdout)
sys.exit(0)
# Try alternative sources
print(f"Primary URL failed, trying alternatives for {mpn}...", file=sys.stderr)
if try_alternative_sources(mpn, output_path):
vr = verify_datasheet(output_path, verify_pn, desc,
product.get("Manufacturer", {}).get("Name", ""))
if vr["confidence"] == "wrong":
print(f"WARNING: Downloaded PDF may be wrong datasheet for {mpn}",
file=sys.stderr)
print(f" {vr['details']}", file=sys.stderr)
if args.json:
result["success"] = True
result["output"] = output_path
result["source"] = "alternative"
result["verification"] = vr
json.dump(result, sys.stdout)
sys.exit(0)
print(f"Failed to download datasheet for {mpn}", file=sys.stderr)
if args.json:
result["success"] = False
result["error"] = "All download methods failed"
json.dump(result, sys.stdout)
sys.exit(1)
else:
# Direct URL mode
url = args.url
output_path = args.output or "datasheet.pdf"
if download_pdf(url, output_path):
if args.json:
json.dump({"success": True, "output": output_path, "url": url}, sys.stdout)
sys.exit(0)
else:
print(f"Failed to download PDF from {url}", file=sys.stderr)
if args.json:
json.dump({"success": False, "url": url, "error": "Download failed"}, sys.stdout)
sys.exit(1)
if __name__ == "__main__":
from kicad_core.cli import utf8_stdio
utf8_stdio()
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |