tempmail_sdk 1.3.3 → 1.3.5

data/lib/tempmail_sdk/providers/mailtemp_cc.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # mailtemp.cc 渠道实现（PHP POST form-urlencoded API）
+    #
+    # 流程：POST api.php body: action=inbox 创建邮箱（返回 JSON 字符串用户名）
+    #       POST api.php body: action=fetch&inbox={username}&last_id=0 获取邮件列表
+    #       POST api.php body: action=view&id={id}&inbox={username} 获取邮件详情
+    # token 存储 username（@前面的部分），域名固定 neocea.com
+    module MailtempCc
+      CHANNEL = "mailtemp-cc"
+      API_URL = "https://mailtemp.cc/api.php"
+
+      HEADERS = {
+        "Content-Type" => "application/x-www-form-urlencoded",
+        "Accept" => "application/json, text/plain, */*",
+        "Accept-Language" => "zh-CN,zh;q=0.9,en;q=0.8",
+        "Referer" => "https://mailtemp.cc/",
+        "Origin" => "https://mailtemp.cc",
+        "User-Agent" => "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 " \
+                        "(KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36 Edg/146.0.0.0"
+      }.freeze
+
+      module_function
+
+      # 创建 mailtemp.cc 临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post(API_URL, headers: HEADERS, body: "action=inbox", timeout: 15)
+        resp.raise_for_status
+        # 返回值为 JSON 字符串格式（带引号），如 "vindictiverate"
+        username = resp.json
+        username = username.to_s.strip
+        raise "mailtemp-cc: 返回的用户名为空" if username.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: "#{username}@neocea.com", token: username)
+      end
+
+      # 获取 mailtemp.cc 邮件列表
+      # @param email [String]
+      # @param token [String] username
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        token = token.to_s.strip
+        raise "mailtemp-cc: token 为空" if token.empty?
+
+        form = URI.encode_www_form("action" => "fetch", "inbox" => token, "last_id" => "0")
+        resp = Http.post(API_URL, headers: HEADERS, body: form, timeout: 15)
+        resp.raise_for_status
+        items = resp.json
+        return [] unless items.is_a?(Array)
+        return [] if items.empty?
+
+        items.filter_map do |item|
+          next unless item.is_a?(Hash)
+
+          mail_id = item["id"].to_s
+          unless mail_id.empty?
+            detail = view_email(token, mail_id)
+            if detail.is_a?(Hash)
+              item["html"] = detail["body_html"] if detail["body_html"]
+              item["body_html"] = detail["body_html"] if detail["body_html"]
+            end
+          end
+
+          item["from"] ||= item["sender_email"] || item["sender"]
+          item["date"] ||= item["received_at"]
+          item["to"] = email
+          Normalize.normalize_email(item, email)
+        end
+      end
+
+      # 获取单封邮件详情
+      # @param inbox [String] username
+      # @param mail_id [String]
+      # @return [Hash, nil]
+      def view_email(inbox, mail_id)
+        form = URI.encode_www_form("action" => "view", "id" => mail_id, "inbox" => inbox)
+        resp = Http.post(API_URL, headers: HEADERS, body: form, timeout: 15)
+        return nil unless resp.ok?
+
+        resp.json
+      rescue StandardError
+        nil
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/mailticking.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+module TempmailSdk
+  module Providers
+    # Mailticking 渠道实现（www.mailticking.com，旧域名 temporary-mail.net 的更名站）
+    #
+    # 实测协议（三类请求均以 application/json 交流，站点在 Cloudflare 后）：
+    #   1. 建箱 POST /get-mailbox body {"types":["4"]}（4=独立域名，排除 Gmail 别名）
+    #      响应 {"success":true,"email":"xxx@domain","activate_token":"..."}
+    #   2. 激活 POST /activate-email body {"email":..,"source":"api","activate_token":..}
+    #      响应 {"success":true}
+    #   3. 列信 POST /get-emails?lang=en body {"email":..,"code":..}
+    #      空箱实测响应 {"emails":[],"success":true}；空闲超时/被改绑后返回
+    #      {"success":false,"needNewEmail":true,...}，此时返回错误提示换箱。
+    #
+    # 读信正文无公开端点：GetEmails 只具备列表能力，列表字段名采用多候选提取
+    # 策略，命中多少映射多少（Normalize 既有候选字段负责兜底）。
+    module Mailticking
+      CHANNEL = "mailticking"
+      BASE_URL = "https://www.mailticking.com"
+
+      HEADERS = {
+        "Accept" => "application/json",
+        "Accept-Language" => "en-US,en;q=0.9",
+        "Content-Type" => "application/json",
+        "Referer" => "#{BASE_URL}/",
+        "Origin" => BASE_URL,
+        "User-Agent" => "Mozilla/5.0 (Windows NT 10.0; Win64; x64) " \
+                        "AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36"
+      }.freeze
+
+      module_function
+
+      # 执行 JSON POST 请求并解析响应；响应非 2xx 或 success=false 时抛错
+      # @param path [String] 请求路径
+      # @param payload [Hash] JSON 请求体
+      # @return [Hash]
+      def do_post(path, payload)
+        resp = Http.post("#{BASE_URL}#{path}", headers: HEADERS, json: payload, timeout: 15)
+        data = resp.json
+        unless resp.ok?
+          msg = data.is_a?(Hash) ? (data["error"] || data["message"]).to_s : ""
+          msg = resp.body.to_s if msg.empty?
+          raise "mailticking: http #{resp.status_code}: #{msg}"
+        end
+        unless data.is_a?(Hash) && data["success"] == true
+          msg = data.is_a?(Hash) ? (data["error"] || data["message"]).to_s : ""
+          msg = "unknown error" if msg.empty?
+          raise "mailticking: 请求失败: #{msg}"
+        end
+        data
+      end
+
+      # 创建 mailticking 邮箱账号
+      # 请求 type=4（独立域名）固定取独立域名邮箱，建箱后立即激活会话；
+      # token 必须携带 activate_token（列信协议依赖激活会话），不能为空。
+      # @return [EmailInfo]
+      def generate_email
+        box = do_post("/get-mailbox", { "types" => ["4"] })
+        token = box["code"].to_s.strip
+        token = box["email"].to_s.strip if token.empty?
+        email = box["email"].to_s.strip
+        if token.empty? || email.empty?
+          raise "mailticking: get-mailbox 返回空 email/activate_token"
+        end
+
+        # 激活邮箱，使后续列信请求与服务器记录的最新会话一致
+        do_post("/activate-email", {
+                  "email" => email,
+                  "source" => "api",
+                  "activate_token" => token
+                })
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: token)
+      end
+
+      # 获取 mailticking 邮箱的邮件列表
+      # 空箱返回空列表不报错；需要换箱的响应（needNewEmail）返回语义错误。
+      # @param email [String] 邮箱地址
+      # @param token [String] 建箱返回的激活令牌
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        addr = email.to_s.strip
+        tk = token.to_s.strip
+        raise "mailticking: 邮箱地址为空" if addr.empty?
+        raise "mailticking: activate code 为空" if tk.empty?
+
+        resp = Http.post("#{BASE_URL}/get-emails?lang=en",
+                         headers: HEADERS,
+                         json: { "email" => addr, "code" => tk },
+                         timeout: 15)
+        data = resp.json
+        unless resp.ok?
+          msg = data.is_a?(Hash) ? (data["error"] || data["message"]).to_s : ""
+          msg = resp.body.to_s if msg.empty?
+          raise "mailticking: http #{resp.status_code}: #{msg}"
+        end
+        unless data.is_a?(Hash) && data["success"] == true
+          raise "mailticking: 邮箱已过期，请重新建箱" if data.is_a?(Hash) && data["needNewEmail"] == true
+
+          raise "mailticking: get-emails 失败"
+        end
+        emails = data["emails"]
+        return [] unless emails.is_a?(Array)
+
+        emails.filter_map do |raw|
+          next unless raw.is_a?(Hash)
+
+          Normalize.normalize_email(migrated_fields(raw), addr)
+        end
+      end
+
+      # 尽量映射列表字段到统一字段名
+      # 官网首页表格只有 SENDER/SUBJECT/TIME 三列，字段全名缺少可观测证据，
+      # 因此对常见字段做多候选提取；未命中的字段留给 Normalize 自己处理。
+      # @param raw [Hash]
+      # @return [Hash]
+      def migrated_fields(raw)
+        m = raw.dup
+        unless m.key?("from")
+          %w[mail_from from_mail from_email sender_address from_address
+             send_addr mail_addr address_from ho_from fromname fromS].each do |key|
+            v = m[key]
+            if v.is_a?(String) && v.strip != ""
+              m["from"] = v
+              break
+            end
+          end
+        end
+        if !m.key?("sender") && m["from"].is_a?(String) && m["from"].strip != ""
+          m["sender"] = m["from"]
+        end
+        m["id"] = m["mail_id"] if !m.key?("id") && m.key?("mail_id")
+        m["date"] = m["received_at"] if !m.key?("date") && m.key?("received_at")
+        m
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/minuteinbox.rb

@@ -0,0 +1,174 @@
+# frozen_string_literal: true
+
+require "json"
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # minuteinbox.com 渠道实现（PHP session + CSRF token）
+    #
+    # 流程：GET / 获取 PHPSESSID cookie 和 CSRF token（const CSRF="xxx"）
+    #       GET /index/index?csrf_token={csrf} 创建邮箱，返回 {"email":"user@minafter.com"}
+    #       GET /index/refresh 获取邮件列表
+    #       POST /index/email body: id=X 获取邮件详情
+    # token 存储 JSON {"phpsessid":"...","csrf":"..."}
+    module Minuteinbox
+      CHANNEL = "minuteinbox"
+      BASE_URL = "https://www.minuteinbox.com"
+
+      module_function
+
+      # 从 HTML 中提取 CSRF token（格式: const CSRF="xxx"）
+      # @param html [String]
+      # @return [String]
+      def extract_csrf(html)
+        marker = 'CSRF="'
+        idx = html.index(marker)
+        return "" unless idx
+
+        sub = html[(idx + marker.length)..]
+        end_idx = sub.index('"')
+        end_idx ? sub[0...end_idx] : ""
+      end
+
+      # 将 session 序列化为 JSON token
+      # @param phpsessid [String]
+      # @param csrf [String]
+      # @return [String]
+      def encode_session(phpsessid, csrf)
+        JSON.generate("phpsessid" => phpsessid, "csrf" => csrf)
+      end
+
+      # 从 JSON token 反序列化 session
+      # @param token [String]
+      # @return [Array<String>] [phpsessid, csrf]
+      def decode_session(token)
+        data = JSON.parse(token)
+        phpsessid = data["phpsessid"].to_s.strip
+        csrf = data["csrf"].to_s.strip
+        raise "minuteinbox: session token 缺少必要字段" if phpsessid.empty? || csrf.empty?
+
+        [phpsessid, csrf]
+      rescue JSON::ParserError
+        raise "minuteinbox: 无效的 session token"
+      end
+
+      # 创建 minuteinbox.com 临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        hdrs = {
+          "User-Agent" => "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 " \
+                          "(KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36 Edg/146.0.0.0",
+          "Accept" => "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"
+        }
+        r1 = Http.get(BASE_URL + "/", headers: hdrs, timeout: 15)
+        r1.raise_for_status
+
+        csrf = extract_csrf(r1.body)
+        raise "minuteinbox: 未能从首页提取 CSRF token" if csrf.empty?
+
+        phpsessid = ""
+        r1.set_cookies.each do |line|
+          pair = line.split(";", 2).first.to_s.strip
+          next unless pair.start_with?("PHPSESSID=")
+
+          phpsessid = pair.split("=", 2).last.to_s.strip
+          break
+        end
+        raise "minuteinbox: 未获取到 PHPSESSID cookie" if phpsessid.empty?
+
+        create_url = "#{BASE_URL}/index/index?csrf_token=#{URI.encode_uri_component(csrf)}"
+        r2 = Http.get(
+          create_url,
+          headers: hdrs.merge(
+            "X-Requested-With" => "XMLHttpRequest",
+            "Cookie" => "PHPSESSID=#{phpsessid}"
+          ),
+          timeout: 15
+        )
+        r2.raise_for_status
+
+        data = r2.json
+        email = data.is_a?(Hash) ? data["email"].to_s.strip : ""
+        raise "minuteinbox: 获取到的邮箱地址无效" if email.empty? || !email.include?("@")
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: encode_session(phpsessid, csrf))
+      end
+
+      # 获取 minuteinbox.com 邮件列表
+      # @param token [String] JSON session token
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        phpsessid, _csrf = decode_session(token)
+        cookie_hdr = "PHPSESSID=#{phpsessid}"
+        hdrs = {
+          "User-Agent" => "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 " \
+                          "(KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36 Edg/146.0.0.0",
+          "X-Requested-With" => "XMLHttpRequest",
+          "Cookie" => cookie_hdr
+        }
+
+        r = Http.get(BASE_URL + "/index/refresh", headers: hdrs, timeout: 15)
+        r.raise_for_status
+
+        trimmed = r.body.to_s.strip
+        return [] if trimmed == "0" || trimmed.empty? || trimmed == "[]"
+
+        mail_list = r.json
+        return [] unless mail_list.is_a?(Array) && !mail_list.empty?
+
+        mail_list.filter_map do |item|
+          next unless item.is_a?(Hash)
+
+          mail_id = item["id"].to_s
+          detail = fetch_detail(cookie_hdr, mail_id) unless mail_id.empty?
+
+          is_read = item["precteno"] != "new"
+          from = detail&.dig("od") || item["od"] || ""
+          subject = detail&.dig("predmet") || item["predmet"] || ""
+          html_body = detail&.dig("telo") || ""
+          to = detail&.dig("komu") || email
+
+          flat = {
+            "id" => mail_id,
+            "from" => from,
+            "to" => to,
+            "subject" => subject,
+            "html" => html_body,
+            "date" => item["kdy"] || "",
+            "isRead" => is_read
+          }
+          Normalize.normalize_email(flat, email)
+        end
+      end
+
+      # 获取单封邮件详情
+      # @param cookie_hdr [String]
+      # @param mail_id [String]
+      # @return [Hash, nil]
+      def fetch_detail(cookie_hdr, mail_id)
+        return nil if mail_id.empty?
+
+        hdrs = {
+          "User-Agent" => "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 " \
+                          "(KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36 Edg/146.0.0.0",
+          "X-Requested-With" => "XMLHttpRequest",
+          "Content-Type" => "application/x-www-form-urlencoded",
+          "Cookie" => cookie_hdr
+        }
+        resp = Http.post(
+          BASE_URL + "/index/email",
+          headers: hdrs,
+          body: "id=#{URI.encode_uri_component(mail_id)}",
+          timeout: 15
+        )
+        return nil unless resp.ok?
+
+        resp.json
+      rescue StandardError
+        nil
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/moakt.rb

@@ -42,7 +42,7 @@ module TempmailSdk
       TITLE_RE = /<li\s+class="title"\s*>([^<]*)<\/li>/im
       DATE_RE = /<li\s+class="date"[^>]*>[\s\S]*?<span[^>]*>([^<]+)<\/span>/im
       SENDER_RE = /<li\s+class="sender"[^>]*>[\s\S]*?<span[^>]*>([\s\S]*?)<\/span>\s*<\/li>/im
-      BODY_RE = /<div\s+class="email-body"\s*>([\s\S]*?)<\/div>/im
+      BODY_OPEN_RE = /<div\s+class="email-body"\s*>/im
       FROM_ADDR_RE = /<([a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,})>/
       TAG_RE = /<[^>]+>/
 
@@ -161,6 +161,33 @@ module TempmailSdk
         addr
       end
 
+      # 使用栈式深度匹配提取 email-body div 的完整内部 HTML，
+      # 避免非贪婪正则在嵌套 div 时截断正文。
+      def extract_body_html(page)
+        m = page.match(BODY_OPEN_RE)
+        return "" unless m
+
+        start = m.end(0)
+        pos = start
+        depth = 1
+        while pos < page.length && depth > 0
+          next_open = page.index("<div", pos)
+          next_close = page.index("</div>", pos)
+          break unless next_close
+
+          if next_open && next_open < next_close
+            depth += 1
+            pos = next_open + 4
+          else
+            depth -= 1
+            return page[start...next_close].strip if depth.zero?
+
+            pos = next_close + 6
+          end
+        end
+        ""
+      end
+
       # 去除 HTML 标签，压缩为文本
       def strip_tags(s)
         s.gsub(TAG_RE, " ").strip
@@ -200,8 +227,7 @@ module TempmailSdk
         date_s = ""
         date_s = CGI.unescapeHTML(page.match(DATE_RE)[1].strip) if page.match?(DATE_RE)
 
-        body = ""
-        body = page.match(BODY_RE)[1].strip if page.match?(BODY_RE)
+        body = extract_body_html(page)
 
         {
           "id" => mid,

data/lib/tempmail_sdk/providers/mtempmail.rb

@@ -0,0 +1,140 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module TempmailSdk
+  module Providers
+    # Mtempmail 渠道实现（mtempmail.com，公共 key 认证）
+    #
+    # 建箱: POST /api/emails/{apiKey}（空 JSON body）→
+    #   {"status":true,"data":{"email":"...@domain","domain":"..","ip":"..",
+    #    "fingerprint":"..","expire_at":"..","created_at":"..","id":..,"email_token":"..."}}
+    # 读信: GET /api/messages/{apiKey}/{email} →
+    #   {"status":true,"mailbox":"..","email_token":"..","messages":[...]}
+    #   消息为 mailgun 入站 webhook 风格：to/from 为对象数组，
+    #   body 为 [{content_type:"text/html",value:".."},...] 分段。
+    # 邮箱 24 小时有效（过期时间标注不一致，以服务端为准）。
+    module Mtempmail
+      CHANNEL = "mtempmail"
+      BASE_URL = "https://mtempmail.com"
+
+      # 公共固定 API key（mtempmail.com 官方提供）
+      PUBLIC_KEY = "pub_nRn1hUwpdmZvxQNVWDfoXgKyF7dIm9nRIIIt1qDw"
+
+      HEADERS = {
+        "Accept" => "application/json",
+        "User-Agent" => "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 " \
+                        "(KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36 Edg/146.0.0.0"
+      }.freeze
+
+      # 剥离后台拼接的 "• " 前缀（或实收分隔符）
+      BULLET_RE = /^[•·]+\s*/.freeze
+
+      module_function
+
+      # 清洗主题前导分隔符（后台可能以 "• " 开头拼接微件）
+      # @param subject [String]
+      # @return [String]
+      def clean_subject(subject)
+        subject.to_s.strip.sub(BULLET_RE, "")
+      end
+
+      # 拼接正文纯文本（body[].value 按序）
+      # @param parts [Array]
+      # @return [String]
+      def body_text(parts)
+        parts.filter_map { |p| p["value"].to_s unless p.nil? || !p.is_a?(Hash) || p["value"].to_s.empty? }
+             .join("\n")
+      end
+
+      # 提取首个 text/html 段
+      # @param parts [Array]
+      # @return [String]
+      def body_html(parts)
+        parts.each do |p|
+          next unless p.is_a?(Hash) && p["content_type"].to_s == "text/html"
+
+          val = p["value"].to_s
+          return val unless val.empty?
+        end
+        ""
+      end
+
+      # 创建 mtempmail 临时邮箱
+      # POST /api/emails/{apiKey}（空 JSON body）
+      # @return [EmailInfo]
+      def generate_email
+        resp = Http.post("#{BASE_URL}/api/emails/#{PUBLIC_KEY}",
+                         headers: HEADERS.merge("Content-Type" => "application/json"),
+                         json: {}, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        payload = data.is_a?(Hash) ? data["data"] : nil
+        email = payload.is_a?(Hash) ? payload["email"].to_s.strip : ""
+        if (data.is_a?(Hash) && !data["status"]) || email.empty?
+          raise "mtempmail: 建箱响应缺少邮箱"
+        end
+
+        EmailInfo.new(channel: CHANNEL, email: email,
+                      token: payload["email_token"].to_s,
+                      expires_at: payload["expire_at"],
+                      created_at: payload["created_at"])
+      end
+
+      # 读取 mtempmail 收件箱
+      # GET /api/messages/{apiKey}/{email}；token 元数据仅为校验，不参与请求
+      # @param email [String] 邮箱地址
+      # @param token [String] email_token（仅校验非空）
+      # @return [Array<Email>]
+      def get_emails(email, token)
+        addr = email.to_s.strip
+        raise "mtempmail: 邮箱为空" if addr.empty?
+        raise "mtempmail: token 为空" if token.to_s.strip.empty?
+
+        uri = "#{BASE_URL}/api/messages/#{PUBLIC_KEY}/#{URI.encode_www_form_component(addr)}"
+        resp = Http.get(uri, headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        messages = data.is_a?(Hash) ? data["messages"] : nil
+        return [] unless messages.is_a?(Array)
+
+        messages.filter_map do |m|
+          next unless m.is_a?(Hash)
+
+          to_str = flatten_contact(m["to"])
+          row = {
+            "id" => m["id"],
+            "from" => flatten_contact(m["from"]),
+            "to" => to_str.empty? ? addr : to_str,
+            "subject" => clean_subject(m["subject"]),
+            "date" => m["created_at"] || m["date"]
+          }
+          body_parts = m["body"]
+          if body_parts.is_a?(Array)
+            parts = body_parts.select { |p| p.is_a?(Hash) }
+            text = body_text(parts)
+            row["text"] = text unless text.empty?
+            html_part = body_html(parts)
+            row["html"] = html_part unless html_part.empty?
+          end
+          Normalize.normalize_email(row, addr)
+        end
+      end
+
+      # 将 mailgun 风格 [{"full":"Sender <a@b.com>"},{...}] 展平为字符串
+      # 优先取 full 字段，否则回退 address；空列表返回空串
+      # @param contacts [Object]
+      # @return [String]
+      def flatten_contact(contacts)
+        return contacts.to_s unless contacts.is_a?(Array)
+        return "" if contacts.empty?
+
+        first = contacts.first
+        return "" unless first.is_a?(Hash)
+
+        full = first["full"].to_s.strip
+        full.empty? ? first["address"].to_s.strip : full
+      end
+    end
+  end
+end

data/lib/tempmail_sdk/providers/mytempmail_cc.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require "json"
+
+module TempmailSdk
+  module Providers
+    # mytempmail.cc 渠道实现
+    #
+    # 流程：POST /api/address 创建邮箱（JSON body），返回 token + address
+    #       GET /api/mails/{token} 获取邮件列表
+    # 域名固定 nilvaro.com，有效期 600 秒
+    module MytempmailCc
+      CHANNEL = "mytempmail-cc"
+      BASE_URL = "https://api.mytempmail.cc"
+
+      HEADERS = {
+        "Content-Type" => "application/json",
+        "Accept" => "application/json"
+      }.freeze
+
+      CHARS = ("a".."z").to_a.freeze
+
+      module_function
+
+      # 生成随机 8 位小写字母用户名
+      # @return [String]
+      def random_name
+        Array.new(8) { CHARS.sample }.join
+      end
+
+      # 创建 mytempmail.cc 临时邮箱
+      # @return [EmailInfo]
+      def generate_email
+        body = JSON.generate("domain" => "nilvaro.com", "name" => random_name, "expiry" => 600)
+        resp = Http.post(BASE_URL + "/api/address", headers: HEADERS, body: body, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        email = data["address"].to_s.strip
+        token = data["token"].to_s.strip
+        raise "mytempmail-cc: 无效的邮箱响应" if email.empty? || !email.include?("@")
+        raise "mytempmail-cc: 响应中缺少 token" if token.empty?
+
+        EmailInfo.new(channel: CHANNEL, email: email, token: token)
+      end
+
+      # 获取 mytempmail.cc 邮件列表
+      # @param token [String]
+      # @param email [String]
+      # @return [Array<Email>]
+      def get_emails(token, email)
+        token = token.to_s.strip
+        raise "mytempmail-cc: token 为空" if token.empty?
+
+        resp = Http.get("#{BASE_URL}/api/mails/#{token}", headers: HEADERS, timeout: 15)
+        resp.raise_for_status
+        data = resp.json
+        results = data.is_a?(Hash) ? Array(data["results"]) : []
+
+        results.filter_map do |msg|
+          next unless msg.is_a?(Hash)
+
+          flat = {
+            "id" => msg["id"],
+            "from" => msg["from"],
+            "to" => email,
+            "subject" => msg["subject"],
+            "text" => msg["body_text"],
+            "html" => msg["body_html"],
+            "received_at" => msg["received_at"]
+          }
+          Normalize.normalize_email(flat, email)
+        end
+      end
+    end
+  end
+end