doubletick-cli

DoubleTick CLI

用于通过 Gmail 跟踪邮件阅读情况的开源 CLI 和 MCP 服务。了解邮件何时被打开——直接在终端中查看。

可与 DoubleTick 后端配合使用。通过 CLI 跟踪的邮件会与通过 Chrome 扩展跟踪的邮件一同显示。

安装

npm install -g doubletick-cli

快速开始

# 1. Log in with your Gmail account (one-time)
doubletick login

# 2. Send a tracked email
doubletick send --to [email protected] --subject "Q1 Planning" --body "Hi Jane, here are the numbers..."

# 3. Check if they read it
doubletick status --last

命令

doubletick login

通过 Gmail 和 DoubleTick 进行身份验证。打开浏览器以使用 Google 登录。只需设置一次——凭据会保存在本地的 ~/.doubletick/credentials.json 中。

doubletick logout

移除已保存的凭据。

doubletick send

发送跟踪邮件。注入阅读跟踪像素，通过 Gmail API 发送邮件，并注册跟踪记录。

# Send a tracked email (body is markdown by default)
doubletick send --to [email protected] --subject "Hi" --body "Hello **Jane**"

# HTML body instead of markdown
doubletick send --to [email protected] --subject "Hi" --body "<h1>Hello</h1>" --html

# Body from file
doubletick send --to [email protected] --subject "Hi" --body-file ./email.md

# With CC/BCC
doubletick send --to [email protected] --cc "[email protected]" --subject "Hi" --body "Hello"

doubletick status

检查跟踪邮件是否已被打开。

# Most recent tracked email
doubletick status --last

# Find by recipient
doubletick status --to [email protected]

# By tracking ID
doubletick status abc-123

doubletick dashboard

列出所有跟踪邮件及其打开率和统计信息。

doubletick dashboard
doubletick dashboard --limit 50

MCP 服务

DoubleTick 可作为 MCP 服务使用，让 AI Agent（Claude Code、Claude Desktop 等）能够直接发送和跟踪邮件。

设置

添加到 Claude 配置中：

{
  "mcpServers": {
    "doubletick": {
      "command": "npx",
      "args": ["-y", "doubletick-cli"]
    }
  }
}

你必须先运行 doubletick login——MCP 服务会使用相同的已保存凭据。

工具

工具	描述
send_tracked_email	发送带阅读跟踪功能的邮件
check_tracking_status	检查跟踪邮件是否已被打开
list_tracked_emails	列出近期跟踪邮件及其统计信息

工作原理

1. 撰写邮件（文本或 Markdown）
2. CLI 将其转换为 HTML，生成跟踪 ID，并注入 1×1 跟踪像素
3. 通过 Gmail API 发送邮件
4. 将跟踪记录注册到 DoubleTick 后端
5. 收件人打开邮件时，像素会触发并记录打开事件
6. 通过 doubletick status 检查状态

整个 DoubleTick 后端（像素提供、打开事件记录、去重、设备检测）均保持不变。CLI 只是注入像素的新方式，用于在终端或 Agent 工作流中替代 Chrome 扩展。

架构

doubletick CLI / MCP server
  ├── Gmail API        → send emails
  └── DoubleTick API   → register tracks, check status
        ├── GET  /img?t=<id>   → tracking pixel
        ├── POST /track        → register tracked email
        ├── GET  /status?id=   → check opens
        └── GET  /dashboard    → list tracked emails

要求

• Node.js 18+
• Gmail 账户
• DoubleTick 账户（免费套餐：每周跟踪 5 封邮件）

许可证

MIT