spoki-automation

Spoki Automation - 通过 Rube MCP 实现 Composio Spoki 任务自动化

技能概述

Spoki Automation 是一个通过 Rube MCP 集成 Composio Spoki Toolkit 的技能，让你能够从智能体中自动发现工具、管理连接并执行 Spoki 操作，无需硬编码 API 调用。

适用场景

需要自动化 Spoki 营销流程

当你要通过智能体自动执行邮件发送、联系人管理或营销活动创建时，该技能提供动态工具发现和安全的连接管理。

批量处理 Spoki 数据

当你需要批量执行多个 Spoki 操作（如导入联系人、触发活动）时，利用 RUBE_MULTI_EXECUTE_TOOL 和 RUBE_REMOTE_WORKBENCH 可以高效完成。

无 API Key 的 Spoki 集成

当你不想单独管理 Spoki API 凭证时，通过 Rube MCP 服务器添加 https://rube.app/mcp 即可使用，所有认证由 Composio 统一处理。

核心功能

动态工具发现

通过 RUBE_SEARCH_TOOLS 自动获取 Spoki Toolkit 的当前工具列表和输入 schema，避免因 API 变更导致硬编码失效。每次执行前搜索工具，确保使用最新的字段名称和类型。

连接状态管理

使用 RUBE_MANAGE_CONNECTIONS 检查和管理 Spoki 连接状态。只有当连接显示为 ACTIVE 时才能执行工具，否则系统会返回认证链接引导你完成授权。

安全工具执行

通过 RUBE_MULTI_EXECUTE_TOOL 执行已发现的工具，系统会自动验证参数 schema 并管理 session 上下文。支持在单次调用中执行多个工具，并处理分页结果。

常见问题

Rube MCP 需要配置什么吗？

只需在你的 MCP 客户端配置中添加服务器地址 https://rube.app/mcp，无需任何 API Key 或密钥。添加后通过 RUBE_SEARCH_TOOLS 验证连接是否可用即可开始使用。

为什么每次执行前要调用 RUBE_SEARCH_TOOLS？

Composio 工具的 schema 可能随时更新。调用 RUBE_SEARCH_TOOLS 会返回当前的工具列表、输入字段定义、推荐执行计划和已知陷阱，避免你使用过时的参数导致调用失败。

如何处理 Spoki 连接未激活的情况？

调用 RUBE_MANAGE_CONNECTIONS 时，如果 Spoki 连接状态不是 ACTIVE，系统会在响应中返回一个认证链接。访问该链接完成 Spoki 账户授权后，重新检查连接状态即可看到 ACTIVE，之后就能正常执行工具。