/install apple-serial-lookup
Apple Serial Lookup
Identify any Apple device from its serial number by combining local decoding with web lookups.
Workflow
1. Decode locally (old 11-12 char format)
Run the bundled decoder script:
python3 scripts/decode_serial.py \x3CSERIAL>
This extracts:
- Manufacturing location and date
- Model codes and configuration identifiers
- Model identifier (e.g., MacBookPro10,1, iPhone9,1) when known
- Basic specs (RAM, storage options) from built-in database
The script includes a database of common model codes compiled from repair sources and EveryMac.
2. Web lookup for complete specs and unknown models
For full specifications or unknown model codes, perform web lookup:
- Primary:
web_searchfor"Apple serial number \x3CSERIAL> specs"or"\x3CSERIAL> site:everymac.com" - Fallback:
web_fetchfromhttps://everymac.com/ultimate-mac-lookup/?search_keywords=\x3CSERIAL>
If EveryMac is blocked by captcha, try:
https://appleserialnumberinfo.com/Desktop/index.php?sn=\x3CSERIAL>(may need browser)- Search for the model code (e.g., "Apple DKQ model identifier") to match to a specific device
For new-format (post-2021) serials, web search won't help — direct the user to check Apple's coverage page themselves:
- Apple Check Coverage:
https://checkcoverage.apple.com/(requires captcha, but returns device model + warranty status) - This is the only reliable source for randomized 10-character serials
- Apple switched to randomized serials starting in late 2020/early 2021 (beginning with iPhone 12 and M1 Macs), fully rolled out across all products by 2021
3. Present results
Combine local decode + web data into a comprehensive summary:
Enhanced Output (from local decode):
- Device: Model name and identifier (e.g., MacBook Pro 15" Mid-2012, MacBookPro10,1)
- Serial: Full serial number
- Manufactured: Location, week, year (e.g., ~Week 38, Sep 2012, Quanta Shanghai)
- Specs: RAM and storage options from built-in database
- Model Codes: Last 4 characters with decode attempt
Web Enhancement (when needed):
- Exact processor specifications
- Complete technical specifications
- Warranty status (Apple Check Coverage)
- Current market value
Reference
- Serial format & encoding: references/serial-format.md
- Model code database: references/model-codes.md - mappings from model codes to device specs and model identifiers
The model code database is continuously expandable as new mappings are discovered.
Notes
- Old format (12 chars): decodable locally for location/date, web needed for exact model
- New format (10-14 chars, 2021+): fully randomized, web lookup is the only option
- IMEI numbers (15 digits) are NOT serial numbers — note this if a user provides one
- The script outputs JSON for easy parsing
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install apple-serial-lookup - 安装完成后,直接呼叫该 Skill 的名称或使用
/apple-serial-lookup触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Apple Serial Lookup 是什么?
Look up Apple device information from a serial number. Supports iPhones, iPads, Macs (MacBook, iMac, Mac mini, Mac Pro, Mac Studio), Apple Watch, Apple TV, and iPods. Use when a user provides an Apple serial number and wants to identify the device, check specs, manufacturing date/location, warranty status, or get detailed model information. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 1171 次。
如何安装 Apple Serial Lookup?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install apple-serial-lookup」即可一键安装,无需额外配置。
Apple Serial Lookup 是免费的吗?
是的,Apple Serial Lookup 完全免费(开源免费),可自由下载、安装和使用。
Apple Serial Lookup 支持哪些平台?
Apple Serial Lookup 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Apple Serial Lookup?
由 siatrial(@siatrial)开发并维护,当前版本 v1.0.0。