{"id":26648938,"url":"https://github.com/zhima-mochi/mailmole","last_synced_at":"2025-08-07T05:22:38.283Z","repository":{"id":283814045,"uuid":"952850162","full_name":"Zhima-Mochi/mailmole","owner":"Zhima-Mochi","description":"Mailmole is a Go package that provides a unified interface for handling email verification through temporary email services, we call them \"tunnels\". It simplifies the process of receiving verification codes and managing temporary email addresses for testing and automation purposes.","archived":false,"fork":false,"pushed_at":"2025-03-22T10:42:23.000Z","size":139,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-22T11:24:03.154Z","etag":null,"topics":["automation","go","temporary-email","verification-code"],"latest_commit_sha":null,"homepage":"https://zhima-mochi.github.io/mailmole/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Zhima-Mochi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-22T02:18:05.000Z","updated_at":"2025-03-22T10:42:27.000Z","dependencies_parsed_at":"2025-03-22T11:34:23.226Z","dependency_job_id":null,"html_url":"https://github.com/Zhima-Mochi/mailmole","commit_stats":null,"previous_names":["zhima-mochi/mailmole"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zhima-Mochi%2Fmailmole","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zhima-Mochi%2Fmailmole/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zhima-Mochi%2Fmailmole/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zhima-Mochi%2Fmailmole/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Zhima-Mochi","download_url":"https://codeload.github.com/Zhima-Mochi/mailmole/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245377955,"owners_count":20605375,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","go","temporary-email","verification-code"],"created_at":"2025-03-25T00:47:23.287Z","updated_at":"2025-03-25T00:47:23.851Z","avatar_url":"https://github.com/Zhima-Mochi.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mailmole\n\n![Mailmole Logo](./docs/mailmole.jpeg)\n\n\nMailmole is a Go package that provides a unified interface for handling email verification through temporary email services, we call them \"**tunnels**\". It simplifies the process of receiving verification codes and managing temporary email addresses for testing and automation purposes.\n\n## Features\n\n- Unified interface for multiple temporary email services\n- Browser automation support\n- Configurable options for both email and browser settings\n- Easy-to-use API for email verification workflows\n- Support for headless browser mode\n\n## Installation\n\n```bash\ngo get github.com/Zhima-Mochi/mailmole\n```\n\n## Quick Start\n\nHere's a simple example of how to use Mailmole:\n\n```go\npackage main\n\nimport (\n    \"fmt\"\n    \"log\"\n    \"github.com/Zhima-Mochi/mailmole\"\n)\n\nfunc main() {\n    // Create a tunnel agent with options\n    options := \u0026mailmole.TunnelOptions{\n        BrowserOptions: \u0026mailmole.BrowserOptions{\n            Headless: false,\n        },\n    }\n\n    // Create a SmailPro tunnel agent\n    agent, err := mailmole.CreateTunnel(mailmole.SmailProTunnel, options)\n    if err != nil {\n        log.Fatalf(\"Failed to create tunnel agent: %v\", err)\n    }\n\n    // Initialize the tunnel agent\n    err = agent.Init()\n    if err != nil {\n        log.Fatalf(\"Failed to initialize tunnel agent: %v\", err)\n    }\n\n    // Clean up resources when done\n    defer agent.Close()\n\n    // Get the temporary email address\n    email := agent.EmailAddress()\n    fmt.Println(\"Temporary email address:\", email)\n\n    // Get verification code\n    code, err := agent.GetVerificationCode()\n    if err != nil {\n        log.Fatalf(\"Failed to get verification code: %v\", err)\n    }\n    fmt.Println(\"Verification code:\", code)\n}\n```\n\n## Configuration\n\n### TunnelOptions\n\n```go\ntype TunnelOptions struct {\n    // Email to use (optional, for Yopmail)\n    Email string\n    // Browser options\n    BrowserOptions *BrowserOptions\n}\n```\n\n### BrowserOptions\n\n```go\ntype BrowserOptions struct {\n    Headless bool   // Whether to run browser in headless mode\n    URL      string // Custom URL to navigate to\n}\n```\n\n## Supported Services\n\nCurrently supported temporary email services:\n- SmailPro\n- Yopmail\n\nWelcome to contribute more services!\n\n## Dependencies\n\n- Go 1.22 or later\n- github.com/go-rod/rod (for browser automation)\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request. ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhima-mochi%2Fmailmole","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzhima-mochi%2Fmailmole","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhima-mochi%2Fmailmole/lists"}