{
  "schemaVersion": "1.0",
  "item": {
    "slug": "apple-mail-search",
    "name": "Apple Mail Search",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/mneves75/apple-mail-search",
    "canonicalUrl": "https://clawhub.ai/mneves75/apple-mail-search",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/apple-mail-search",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=apple-mail-search",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/apple-mail-search"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/apple-mail-search",
    "agentPageUrl": "https://openagent3.xyz/skills/apple-mail-search/agent",
    "manifestUrl": "https://openagent3.xyz/skills/apple-mail-search/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/apple-mail-search/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Apple Mail Search",
        "body": "Search Apple Mail.app emails instantly via SQLite. ~50ms vs 8+ minutes with AppleScript."
      },
      {
        "title": "Installation",
        "body": "# Copy mail-search to your PATH\ncp mail-search /usr/local/bin/\nchmod +x /usr/local/bin/mail-search"
      },
      {
        "title": "Usage",
        "body": "mail-search subject \"invoice\"           # Search subjects\nmail-search sender \"@amazon.com\"        # Search by sender email\nmail-search from-name \"John\"            # Search by sender name\nmail-search to \"recipient@example.com\"  # Search sent mail\nmail-search unread                      # List unread emails\nmail-search attachments                 # List emails with attachments\nmail-search attachment-type pdf         # Find PDFs\nmail-search recent 7                    # Last 7 days\nmail-search date-range 2025-01-01 2025-01-31\nmail-search open 12345                  # Open email by ID\nmail-search stats                       # Database statistics"
      },
      {
        "title": "Options",
        "body": "-n, --limit N    Max results (default: 20)\n-j, --json       Output as JSON\n-c, --csv        Output as CSV\n-q, --quiet      No headers\n--db PATH        Override database path"
      },
      {
        "title": "Examples",
        "body": "# Find bank statements from last month\nmail-search subject \"statement\" -n 50\n\n# Get unread emails as JSON for processing\nmail-search unread --json | jq '.[] | .subject'\n\n# Find all PDFs from a specific sender\nmail-search sender \"@bankofamerica.com\" -n 100 | grep -i statement\n\n# Export recent emails to CSV\nmail-search recent 30 --csv > recent_emails.csv"
      },
      {
        "title": "Why This Exists",
        "body": "MethodTime for 130k emailsAppleScript iteration8+ minutesSpotlight/mdfindBroken since Big SurSQLite (this tool)~50ms\n\nApple removed the emlx Spotlight importer in macOS Big Sur. This tool queries the Envelope Index SQLite database directly."
      },
      {
        "title": "Technical Details",
        "body": "Database: ~/Library/Mail/V{9,10,11}/MailData/Envelope Index\n\nKey tables:\n\nmessages - Email metadata (dates, flags, FKs)\nsubjects - Subject lines\naddresses - Email addresses and display names\nrecipients - TO/CC mappings\nattachments - Attachment filenames\n\nLimitations:\n\nRead-only (cannot compose/send)\nMetadata only (bodies in .emlx files)\nMail.app only (not Outlook, etc.)"
      },
      {
        "title": "Advanced: Raw SQL",
        "body": "For custom queries, use sqlite3 directly:\n\nsqlite3 -header -column ~/Library/Mail/V10/MailData/Envelope\\ Index \"\nSELECT m.ROWID, s.subject, a.address\nFROM messages m\nJOIN subjects s ON m.subject = s.ROWID\nLEFT JOIN addresses a ON m.sender = a.ROWID\nWHERE s.subject LIKE '%your query%'\nORDER BY m.date_sent DESC\nLIMIT 20;\n\""
      },
      {
        "title": "License",
        "body": "MIT"
      }
    ],
    "body": "Apple Mail Search\n\nSearch Apple Mail.app emails instantly via SQLite. ~50ms vs 8+ minutes with AppleScript.\n\nInstallation\n# Copy mail-search to your PATH\ncp mail-search /usr/local/bin/\nchmod +x /usr/local/bin/mail-search\n\nUsage\nmail-search subject \"invoice\"           # Search subjects\nmail-search sender \"@amazon.com\"        # Search by sender email\nmail-search from-name \"John\"            # Search by sender name\nmail-search to \"recipient@example.com\"  # Search sent mail\nmail-search unread                      # List unread emails\nmail-search attachments                 # List emails with attachments\nmail-search attachment-type pdf         # Find PDFs\nmail-search recent 7                    # Last 7 days\nmail-search date-range 2025-01-01 2025-01-31\nmail-search open 12345                  # Open email by ID\nmail-search stats                       # Database statistics\n\nOptions\n-n, --limit N    Max results (default: 20)\n-j, --json       Output as JSON\n-c, --csv        Output as CSV\n-q, --quiet      No headers\n--db PATH        Override database path\n\nExamples\n# Find bank statements from last month\nmail-search subject \"statement\" -n 50\n\n# Get unread emails as JSON for processing\nmail-search unread --json | jq '.[] | .subject'\n\n# Find all PDFs from a specific sender\nmail-search sender \"@bankofamerica.com\" -n 100 | grep -i statement\n\n# Export recent emails to CSV\nmail-search recent 30 --csv > recent_emails.csv\n\nWhy This Exists\nMethod\tTime for 130k emails\nAppleScript iteration\t8+ minutes\nSpotlight/mdfind\tBroken since Big Sur\nSQLite (this tool)\t~50ms\n\nApple removed the emlx Spotlight importer in macOS Big Sur. This tool queries the Envelope Index SQLite database directly.\n\nTechnical Details\n\nDatabase: ~/Library/Mail/V{9,10,11}/MailData/Envelope Index\n\nKey tables:\n\nmessages - Email metadata (dates, flags, FKs)\nsubjects - Subject lines\naddresses - Email addresses and display names\nrecipients - TO/CC mappings\nattachments - Attachment filenames\n\nLimitations:\n\nRead-only (cannot compose/send)\nMetadata only (bodies in .emlx files)\nMail.app only (not Outlook, etc.)\nAdvanced: Raw SQL\n\nFor custom queries, use sqlite3 directly:\n\nsqlite3 -header -column ~/Library/Mail/V10/MailData/Envelope\\ Index \"\nSELECT m.ROWID, s.subject, a.address\nFROM messages m\nJOIN subjects s ON m.subject = s.ROWID\nLEFT JOIN addresses a ON m.sender = a.ROWID\nWHERE s.subject LIKE '%your query%'\nORDER BY m.date_sent DESC\nLIMIT 20;\n\"\n\nLicense\n\nMIT"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/mneves75/apple-mail-search",
    "publisherUrl": "https://clawhub.ai/mneves75/apple-mail-search",
    "owner": "mneves75",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/apple-mail-search",
    "downloadUrl": "https://openagent3.xyz/downloads/apple-mail-search",
    "agentUrl": "https://openagent3.xyz/skills/apple-mail-search/agent",
    "manifestUrl": "https://openagent3.xyz/skills/apple-mail-search/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/apple-mail-search/agent.md"
  }
}