AI导哈

营销活动管理服务器

Smartlead MCP服务器是一个用于营销活动管理的集成工具，提供创建和管理活动、更新活动设置以及管理活动序列的功能。

  • by lkm1developer
  • JavaScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 lkm1developer/smartlead-mcp-server

使用说明

Smartlead MCP服务器

这是一个用于Smartlead活动管理集成的模型上下文协议（MCP）服务器。它提供了用于创建和管理活动、更新活动设置和管理活动序列的工具。

特性

  • 创建新活动
  • 更新活动日程设置
  • 更新活动常规设置
  • 获取活动详细信息
  • 列出所有具有筛选选项的活动
  • 管理活动电子邮件序列（保存、获取、更新、删除）
  • 管理活动中的电子邮件帐户（添加、更新、删除）
  • 管理营销活动中的潜在客户（添加、更新、删除）

安装

  1. 克隆存储库
  2. 安装依赖项：
npm install
  1. 创建一个 .env 文件基于 .env.example 并添加您的Smartlead API密钥：
SMARTLEAD_API_KEY=your_api_key_here
  1. 构建项目：
npm run build

用法

独立使用

要直接启动服务器，请执行以下操作：

npm start

与Claude整合

要将此MCP服务器与Claude一起使用，您需要将其添加到MCP设置文件中：

  1. 对于Claude VSCode扩展，请将其添加到 c:\Users\<username>\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
  2. 对于Claude桌面应用程序，请将其添加到 %APPDATA%\Claude\claude_desktop_config.json 在Windows上

配置示例：

{
  "mcpServers": {
    "smartlead": {
      "command": "node",
      "args": ["E:/mcp-servers/smartlead/dist/index.js"],
      "env": {
        "SMARTLEAD_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

替换 your_api_key_here 使用您的实际Smartlead API密钥。

配置

可以使用环境变量配置服务器：

  • SMARTLEAD_API_KEY （必需）：您的Smartlead API密钥
  • SMARTLEAD_API_URL （可选）：自定义API URL（默认为https://server.smartlead.ai/api/v1)
  • SMARTLEAD_RETRY_MAX_ATTEMPTS：API调用的最大重试次数（默认值：3）
  • SMARTLEAD_RETRY_INITIAL_DELAY：重试的初始延迟（毫秒）（默认值：1000）
  • SMARTLEAD_RETRY_MAX_DELAY：重试的最大延迟（毫秒）（默认值：10000）
  • SMARTLEAD_RETRY_BACKOFF_FACTOR：重试延迟的回退系数（默认值：2）

可用工具

smartplead_create_campaign

在Smartlead中创建新活动。

参数：

  • name （必填）：活动名称
  • client_id （可选）：活动的客户端ID

smartplead_update_campaign_schedule

更新活动的日程设置。

参数：

  • campaign_id （必填）：要更新的活动ID
  • timezone：活动的时区（例如，“美国/Los_Angeles”）
  • days_of_the_week：一周中发送电子邮件的天数（1-7，其中1是星期一）
  • start_hour：以24小时制开始小时（例如“09:00”）
  • end_hour：以24小时制结束小时（例如“17:00”）
  • min_time_btw_emails：电子邮件之间的最短时间（分钟）
  • max_new_leads_per_day：每天新线索的最大数量
  • schedule_start_time：以ISO格式安排开始时间

smartplead_update_campaign_setting

更新活动的常规设置。

参数：

  • campaign_id （必填）：要更新的活动ID
  • name：活动的新名称
  • status：活动的状态（活动、暂停、完成）
  • settings：其他活动设置

smartplead_get_营销活动

按ID获取特定活动的详细信息。

参数：

  • campaign_id （必填）：要检索的活动ID

smartplead_list_campaigns

列出所有具有可选筛选功能的活动。

参数：

  • status：按状态（活动、暂停、已完成、全部）筛选活动
  • limit：要返回的最大活动数
  • offset：分页偏移量

smartplead_save_campaign_sequence

为带有a/B测试变体的活动保存一系列电子邮件。

参数：

  • campaign_id （必填）：活动ID
  • sequences （必填）：电子邮件序列项数组，每个项都有：
    • id：序列的ID（仅用于更新，创建时省略）
    • seq_number （必填）：序列号（序列中的顺序）
    • seq_delay_details （必填）：延迟设置，包括：
      • delay_in_days （必填）：发送此电子邮件前需要等待几天
    • variant_distribution_type：变异分布类型（MANUAL_EQUAL、MANUAL_PERCENTAGE、AI_EQUAL）
    • lead_distribution_percentage：用于查找获胜者的潜在客户池的样本百分比大小
    • winning_metric_property：用于确定获胜变量的度量（OPEN_RATE、CLICK_RATE、REPLY_RATE、POSITIVE_REPLY_RATE）
    • seq_variants：电子邮件变体数组，每个变体都有：
      • subject （必填）：电子邮件主题行
      • email_body （必填）：电子邮件正文内容（HTML）
      • variant_label （必填）：变体标签（例如“A”、“B”、“C”）
      • id：变量的ID（仅用于更新，创建时省略）
      • variant_distribution_percentage：收到此变体的潜在客户百分比
    • subject：电子邮件主题行（对于简单的跟进，空白表示在同一个线程中）
    • email_body：电子邮件正文内容（HTML）用于简单的跟进

smartplead_get_campaign_sequence

获取活动的电子邮件序列。

参数：

  • campaign_id （必填）：活动ID

smartplead_update_campaign_sequence

按活动顺序更新特定电子邮件。

参数：

  • campaign_id （必填）：活动ID
  • sequence_id （必填）：要更新的序列电子邮件的ID
  • subject：更新了电子邮件主题行
  • body：更新了电子邮件正文内容
  • wait_days：已更新发送此电子邮件前的等待天数

smartplead_delete_campaign_sequence

从活动序列中删除特定电子邮件。

参数：

  • campaign_id （必填）：活动ID
  • sequence_id （必填）：要删除的序列电子邮件的ID

smartplead_add_email_acount_to_活动

将电子邮件帐户添加到活动中。

参数：

  • campaign_id （必填）：活动ID
  • email_account_id （必填）：要添加的电子邮件帐户的ID

smartlead_update_email_account_in_campaign

在活动中更新电子邮件帐户。

参数：

  • campaign_id （必填）：活动ID
  • email_account_id （必填）：要更新的电子邮件帐户的ID
  • settings：此活动中电子邮件帐户的设置

smartplead_delete_email_account_from_campaign

从活动中删除电子邮件帐户。

参数：

  • campaign_id （必填）：活动ID
  • email_account_id （必填）：要删除的电子邮件帐户的ID

smartplead_add_lead_to_活动

为活动添加潜在客户（一次最多100个潜在客户）。

参数：

  • campaign_id （必填）：活动ID
  • lead_list （必填）：潜在客户信息对象数组（最多100个），每个对象包含：
    • email （必填）：负责人的电子邮件地址
    • first_name：负责人的名字
    • last_name：负责人的姓氏
    • company_name：负责人的公司名称
    • phone_number：负责人的电话号码
    • website：负责人网站
    • location：导线位置
    • custom_fields：潜在客户的自定义字段（最多20个字段）
    • linkedin_profile：潜在客户的LinkedIn个人资料URL
    • company_url：潜在客户的公司URL
  • settings：铅添加设置：
    • ignore_global_block_list：如果为真，上传的潜在客户将绕过全局阻止列表
    • ignore_unsubscribe_list：如果为真，潜在客户将绕过与未订阅潜在客户的比较
    • ignore_community_bounce_list：如果为真，上传的潜在客户将绕过在整个用户群中反弹的任何潜在客户
    • ignore_duplicate_leads_in_other_campaign：如果为真，潜在客户不会绕过与其他活动的比较

smartplead_update_lead_in_campaign

更新活动中的潜在客户。

参数：

  • campaign_id （必填）：活动ID
  • lead_id （必填）：要更新的潜在客户ID
  • lead （必填）：更新潜在客户信息，包括：
    • email：负责人的电子邮件地址
    • first_name：负责人的名字
    • last_name：负责人的姓氏
    • company：牵头公司
    • custom_variables：潜在客户的自定义变量

smartplead_delete_lead_from_campaign

从活动中删除潜在客户。

参数：

  • campaign_id （必填）：活动ID
  • lead_id （必填）：要删除的线索的ID

许可证

麻省理工学院

相关 MCP