[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77MC5EECSFSXZS33WAVBD7C":3,"skill-same:01M77MC5EECSFSXZS33WAVBD7C":45},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":25,"repositoryHtmlUrl":26,"repositoryHomepageUrl":27,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M77MC5EECSFSXZS33WAVBD7C","mailtap",null,"Lord1Egypt\u002Fawesome-skill-forge","Lord1Egypt","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F99746359?v=4","01M7592YDNT0XK9WJ0T2MQVPDN","Mohamed Mounir Ali AL Keshita","01M75GRFNHC8VZNWEB8DKDE433",3,"MIT","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fm\u002Fmailtap\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"# MailTap - Temporary Email Service\n\n**Version:** 1.0.4\\\n**Author:** Web3 Hungry\\\n**Author Handle:** @zororaka00\\\n**Author Profile:** [https:\u002F\u002Fx.com\u002Fweb3hungry](https:\u002F\u002Fx.com\u002Fweb3hungry)\\\n**Homepage:** [https:\u002F\u002Fwww.mailtap.org](https:\u002F\u002Fwww.mailtap.org)\\\n**Category:** Utilities → Automation → Privacy & Verification\\\n**Tags:** `temporary-email`\n\n## Overview\n\nThis skill provides seamless access to the MailTap Public API, a free temporary email service that generates disposable email addresses valid for 30 minutes.\n\nNo authentication or API key is required — all endpoints are public and use simple HTTP GET requests.\n\nThis skill does not store, proxy, or modify any email data. All operations communicate directly with the official MailTap public API.\n\n**Ideal for AI agents performing tasks such as:**\n- Registering on websites\u002Fservices without exposing real email addresses\n- Capturing verification codes, one-time links, or confirmation emails\n- Automating web3 airdrops, form submissions, or testing flows that require email verification\n- Privacy-focused workflows where email traceability must be avoided\n- Downloading email attachments when available\n\n**Base URL:** `https:\u002F\u002Fapi.mailtap.org`\n\nAll responses are returned in JSON format.\n\n## Core Capabilities\n\nThe skill exposes three primary endpoints:\n\n1. **Generate** a new temporary email address\n2. **Retrieve** details of an existing email address\n3. **Fetch** all messages in the inbox (including attachments metadata)\n\nAgents can chain operations autonomously (generate → wait → poll inbox → extract data → download attachments).\n\n## Usage Guide for Agents\n\nAgents should use standard HTTP tools (`curl`, `fetch`, `requests`, etc.) to interact with the API.\n\n### 1. Generate New Temporary Email\n\n```bash\ncurl \"https:\u002F\u002Fapi.mailtap.org\u002Fpublic\u002Fgenerate\"\n```\n\n**Example response:**\n\n```json\n{\n  \"address\": \"abc123xyz@mailtap.com\",\n  \"expires_at\": \"2026-02-15T04:30:00.000Z\",\n  \"created_at\": \"2026-02-15T04:00:00.000Z\"\n}\n```\n\n### 2. Get Email Details\n\n```bash\ncurl \"https:\u002F\u002Fapi.mailtap.org\u002Fpublic\u002Femail\u002F{address}\"\n```\n\n### 3. Get Inbox Messages\n\n```bash\ncurl \"https:\u002F\u002Fapi.mailtap.org\u002Fpublic\u002Finbox\u002F{address}\"\n```\n\n**Example response with attachment:**\n\n```json\n{\n  \"messages\": [\n    {\n      \"id\": 1,\n      \"from_address\": \"no-reply@example.com\",\n      \"subject\": \"Your document\",\n      \"body\": \"Please find the attached file.\",\n      \"received_at\": \"2026-02-15T04:05:00.000Z\",\n      \"attachments\": [\n        {\n          \"filename\": \"document.pdf\",\n          \"mime_type\": \"application\u002Fpdf\",\n          \"size\": 102400,\n          \"r2_key\": \"attachments\u002Fabc123\u002Fdocument.pdf\"\n        }\n      ]\n    }\n  ]\n}\n```\n\n### 4. Download Attachments\n\nAttachments are publicly downloadable via the S3-compatible URL:\n\n`https:\u002F\u002Fs3.mailtap.org\u002F{r2_key}`\n\n**Example:**\n\n```bash\ncurl -O \"https:\u002F\u002Fs3.mailtap.org\u002Fattachments\u002Fabc123\u002Fdocument.pdf\"\n```\n\nor\n\n```bash\nwget \"https:\u002F\u002Fs3.mailtap.org\u002Fattachments\u002Fabc123\u002Fdocument.pdf\"\n```\n\n## Recommended Agent Workflow Patterns\n\n**Verification flow:**\n1. Generate email\n2. Use for signup\n3. Poll inbox\n4. Extract verification code\n\n**Attachment flow:**\n1. Poll inbox\n2. If attachments exist → download\n3. Process files\n\n**Error handling:**\n- If `404` → email expired → generate new address\n\n## Example Prompts for Agents\n\n- \"Generate a new temporary email using MailTap\"\n- \"Check inbox for `abc123@mailtap.com` and download attachments\"\n- \"Create temp email, wait up to 2 minutes, extract verification code\"\n\n## Python Helper Library (Enhanced)\n\n```python\nimport requests\nimport time\nimport os\nfrom pathlib import Path\nfrom typing import Optional, Dict, Any\n\nBASE_URL = \"https:\u002F\u002Fapi.mailtap.org\"\nATTACHMENT_BASE = \"https:\u002F\u002Fs3.mailtap.org\"\n\n# Whitelisted attachment types for security\nWHITELISTED_MIME_TYPES = {\n    \"application\u002Fpdf\",\n    \"image\u002Fjpeg\", \"image\u002Fpng\", \"image\u002Fgif\",\n    \"text\u002Fplain\", \"text\u002Fcsv\", \"text\u002Fhtml\",\n    \"application\u002Fmsword\", \"application\u002Fvnd.openxmlformats-officedocument.wordprocessingml.document\",\n    \"application\u002Fvnd.ms-excel\", \"application\u002Fvnd.openxmlformats-officedocument.spreadsheetml.sheet\"\n}\n\nMAX_FILE_SIZE_MB = 10  # Maximum 10MB for security\n\n\ndef generate_email() -> Dict[str, Any]:\n    \"\"\"Generates a new temporary email address.\"\"\"\n    response = requests.get(f\"{BASE_URL}\u002Fpublic\u002Fgenerate\")\n    response.raise_for_status()\n    return response.json()\n\n\ndef get_inbox(address: str) -> Dict[str, Any]:\n    \"\"\"Retrieves the inbox for a given address.\"\"\"\n    response = requests.get(f\"{BASE_URL}\u002Fpublic\u002Finbox\u002F{address}\")\n    if response.status_code == 404:\n        return {\"error\": \"Email not found or expired\"}\n    response.raise_for_status()\n    return response.json()\n\n\ndef wait_for_message(address: str, timeout: int = 120, interval: int = 10) -> Dict[str, Any]:\n    \"\"\"Polls the inbox until a message arrives or timeout is reached.\"\"\"\n    start_time = time.time()\n    while time.time() - start_time \u003C timeout:\n        inbox = get_inbox(address)\n        if \"error\" not in inbox and inbox.get(\"messages\"):\n            return inbox[\"messages\"][-1]\n        time.sleep(interval)\n    return {\"error\": \"Timeout\"}\n\n\ndef is_safe_attachment(attachment: Dict[str, Any]) -> bool:\n    \"\"\"Validates attachment safety based on MIME type and size.\"\"\"\n    mime_type = attachment.get(\"mime_type\", \"\")\n    size_mb = attachment.get(\"size\", 0) \u002F (1024 * 1024)\n    \n    if mime_type not in WHITELISTED_MIME_TYPES:\n        return False\n    if size_mb > MAX_FILE_SIZE_MB:\n        return False\n    return True\n\n\ndef download_attachment(r2_key: str, save_path: Optional[str] = None) -> str:\n    \"\"\"Downloads an attachment from the mailtap S3 storage with security checks.\"\"\"\n    \n    # Parse attachment info from r2_key\n    parts = r2_key.split(\"\u002F\")\n    if len(parts) \u003C 2:\n        raise ValueError(\"Invalid r2_key format\")\n    \n    filename = parts[-1]\n    if not filename or \"..\" in filename:\n        raise ValueError(\"Invalid filename detected\")\n    \n    url = f\"{ATTACHMENT_BASE}\u002F{r2_key}\"\n    \n    # Get attachment metadata first\n    response = requests.head(url, allow_redirects=True)\n    response.raise_for_status()\n    \n    # Validate content type and size\n    content_type = response.headers.get(\"content-type\", \"\")\n    content_length = response.headers.get(\"content-length\")\n    \n    if content_type not in WHITELISTED_MIME_TYPES:\n        raise ValueError(f\"Unsafe MIME type: {content_type}\")\n    \n    if content_length:\n        size_mb = int(content_length) \u002F (1024 * 1024)\n        if size_mb > MAX_FILE_SIZE_MB:\n            raise ValueError(f\"File too large: {size_mb:.1f}MB (max {MAX_FILE_SIZE_MB}MB)\")\n    \n    # Download the file\n    response = requests.get(url, stream=True)\n    response.raise_for_status()\n    \n    if save_path is None:\n        save_path = filename\n    \n    # Ensure safe save path\n    save_path = Path(save_path)\n    save_path = save_path.resolve()\n    \n    # Create directory if needed\n    save_path.parent.mkdir(parents=True, exist_ok=True)\n    \n    with open(save_path, \"wb\") as f:\n        for chunk in response.iter_content(8192):\n            f.write(chunk)\n    \n    return str(save_path)\n\n\ndef list_attachments(address: str) -> list:\n    \"\"\"Lists all attachments in inbox with security validation.\"\"\"\n    inbox = get_inbox(address)\n    if \"error\" in inbox:\n        return []\n    \n    safe_attachments = []\n    for message in inbox.get(\"messages\", []):\n        for attachment in message.get(\"attachments\", []):\n            if is_safe_attachment(attachment):\n                safe_attachments.append(attachment)\n    \n    return safe_attachments\n```\n\n## Security Enhancements\n\n### 1. **Attachment Validation**\n- **MIME Type Whitelisting**: Only allows common safe file types (PDF, images, text, office documents)\n- **Size Limitation**: Maximum 10MB per file to prevent large file attacks\n- **Filename Sanitization**: Prevents path traversal attacks by validating filenames\n\n### 2. **Safe Download Process**\n- **Metadata Validation**: Checks content type and size before downloading\n- **Sandboxed Download**: Uses safe path resolution to prevent directory traversal\n- **Streamed Download**: Downloads in chunks to prevent memory exhaustion\n\n### 3. **Agent Safety Guidelines**\n- **Never auto-execute**: Agents should never automatically execute downloaded files\n- **Validate before use**: Always validate file type and content before processing\n- **Use in sandbox**: For untrusted files, use in isolated environment\n\n## Important Notes & Limitations\n\n- Emails expire automatically after **30 minutes**.\n- Attachments are public.\n- No authentication required.\n- Rate limits are generous for normal usage.\n- **Security-first approach**: All downloads are validated for safety.\n- **No automatic execution**: Agents must manually validate and process files.\n- **User responsibility**: Users should still exercise caution with unknown attachments.\n\n## Example Secure Workflow\n\n```python\n# Secure attachment handling\naddress = \"test123@mailtap.com\"\n\n# Get inbox and list safe attachments\nattachments = list_attachments(address)\n\nfor attachment in attachments:\n    try:\n        # Download with validation\n        file_path = download_attachment(attachment[\"r2_key\"])\n        print(f\"Downloaded safe file: {file_path}\")\n        \n        # Process file (in sandbox if possible)\n        # process_file(file_path)\n        \n    except Exception as e:\n        print(f\"Failed to download {attachment['filename']}: {e}\")\n```\n\n## Source & Verification\n\n- **Official service:** [https:\u002F\u002Fwww.mailtap.org](https:\u002F\u002Fwww.mailtap.org)\n- **API root:** [https:\u002F\u002Fapi.mailtap.org](https:\u002F\u002Fapi.mailtap.org)\n\nThis skill is a transparent wrapper around the public MailTap API with enhanced security measures.\n\n## Disclaimer\n\nUse responsibly and comply with MailTap terms of service. While security measures are implemented, users should still exercise caution when handling email attachments from unknown sources.\n\nCreated and maintained by Web3 Hungry.\nUpdated for security compliance.",{},"master","4aa004da461d820f4ea5499e58eb8d196cf99016","community\u002Fclawhub\u002Fm\u002Fmailtap",0,"https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge","https:\u002F\u002Fskill-explorer-rho.vercel.app","https:\u002F\u002Fgithub.com\u002FLord1Egypt","Unbreakable. Unstoppable. Unmatched⚡.\r\n Speaker of machine tongues 🤖  | World-builder of decentralized dreams 🌐 | Defender of the digital realm🛡️.","2026-06-10 08:21:01",{"source":7,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add Lord1Egypt\u002Fawesome-skill-forge --skill mailtap",{"tool":37,"command":38},"bunx","bunx skills add Lord1Egypt\u002Fawesome-skill-forge --skill mailtap",{"tool":40,"command":41},"pnpm","pnpm dlx skills add Lord1Egypt\u002Fawesome-skill-forge --skill mailtap","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fm\u002Fmailtap\u002FSKILL.md",true,[],[46,53,60,67,74,81],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":18},"01M785WKJB99G3STR1NF9NRTJW","youtube-content","YouTube transcripts to summaries, threads, blogs.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fyoutube-content\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":18},"01M785WEFHB0G2S9YA6EPR3H0E","xurl","X\u002FTwitter via xurl CLI: post, search, DM, media, v2 API.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fxurl\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":18},"01M785W98EDN4EFJXJPMQEHCRC","touchdesigner-mcp","Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftouchdesigner-mcp\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M785W5S9FP3QBH2V191E025P","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":18},"01M785W2AS08NSSH9YATCV6FJB","teams-meeting-pipeline","Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fteams-meeting-pipeline\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":18},"01M785VXKW4T34BTP1SCHW1R7F","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fsystematic-debugging\u002FSKILL.md",[],[]]