← Back to Skills Marketplace
siatrial

Apple Serial Lookup

by siatrial · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
1171
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install apple-serial-lookup
Description
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.
README (SKILL.md)

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_search for "Apple serial number \x3CSERIAL> specs" or "\x3CSERIAL> site:everymac.com"
  • Fallback: web_fetch from https://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

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
Usage Guidance
This skill appears to do what it says: it decodes old-format Apple serials locally and uses web searches/fetches for anything it cannot decode. Before installing, consider: (1) web lookups may send serial numbers to third-party sites (EveryMac and community sites) and may trigger captchas that the skill suggests bypassing with a browser tool — only provide serials you are comfortable sharing with those sites; (2) randomized post‑2021 serials cannot be decoded locally and require Apple’s checkcoverage (which involves a captcha and the official Apple site); (3) the local model-code database is compiled from community sources and may be incomplete or slightly inaccurate — treat results as best-effort; (4) no credentials are requested, so you should never need to provide Apple account data or API keys to use this skill. Minor note for maintainers: the decoder contains a duplicate dictionary key for 'D2' in LOCATIONS (a benign bug that affects lookup determinism for that key) but this is not a security issue.
Capability Analysis
Type: OpenClaw Skill Name: apple-serial-lookup Version: 1.0.0 The skill is designed to look up Apple device information from a serial number using a local Python script and web lookups. The `scripts/decode_serial.py` script performs only string parsing and dictionary lookups, with no file system access, network calls, or dangerous execution. The `SKILL.md` instructs the agent to use `web_search` and `web_fetch` on legitimate Apple and tech information sites (e.g., everymac.com, checkcoverage.apple.com) for additional data. There is no evidence of data exfiltration, malicious execution, persistence, obfuscation, or prompt injection attempts against the agent beyond the stated purpose.
Capability Assessment
Purpose & Capability
Name/description match the implementation: the included Python decoder and model-code references support local decoding of old-format serials, and SKILL.md explicitly instructs web lookups for unknown/new randomized serials. Nothing requested (no env vars, no binaries) is out of scope for a serial-lookup utility.
Instruction Scope
Runtime instructions are narrowly scoped to (1) running the bundled decoder and (2) performing web searches/fetches against EveryMac and fallback sites, plus using Apple Check Coverage for randomized serials. Note: the SKILL.md suggests using browser automation when pages present captchas — that means the agent may use a browsing/web-fetch tool and will send serials to third-party sites; this is expected for the stated purpose but worth being aware of from a privacy perspective.
Install Mechanism
No install spec is provided and the skill is primarily instruction + a small local decoder script. Nothing is downloaded or executed from external URLs during install.
Credentials
The skill requests no environment variables or credentials. That is proportional to its stated purpose (serial decoding + web lookups). It does not ask for Apple account credentials, API keys, or other secrets.
Persistence & Privilege
always is false and there are no requests to modify agent/system configuration or to persist credentials. Autonomous invocation is allowed (platform default) but not combined with other concerning privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install apple-serial-lookup
  3. After installation, invoke the skill by name or use /apple-serial-lookup
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release – Look up Apple device details from serial numbers. - Supports iPhones, iPads, Macs (all types), Apple Watch, Apple TV, and iPods. - Decodes older (pre-2021) serials locally to reveal manufacturing data, model identifiers, and basic specs. - Offers web lookup steps for full specifications and unknown or newer serials. - Guides users to official Apple coverage page for randomized (2021+) serials. - Outputs results as JSON for easy integration.
Metadata
Slug apple-serial-lookup
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is 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. It is an AI Agent Skill for Claude Code / OpenClaw, with 1171 downloads so far.

How do I install Apple Serial Lookup?

Run "/install apple-serial-lookup" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Apple Serial Lookup free?

Yes, Apple Serial Lookup is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Apple Serial Lookup support?

Apple Serial Lookup is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Apple Serial Lookup?

It is built and maintained by siatrial (@siatrial); the current version is v1.0.0.

💬 Comments