SurveyMonkey自动化技能Skill SurveyMonkeyAutomation

---

name: SurveyMonkey自动化 description: “通过自然语言命令自动化SurveyMonkey调查的创建、响应收集、收集器管理和调查发现” requires: mcp: - rube

SurveyMonkey自动化

自动化SurveyMonkey调查工作流程——通过自然语言创建调查、列出和搜索现有调查、管理收集器和分发链接、检索响应以及查看调查详情。

工具包文档: composio.dev/toolkits/survey_monkey

---

设置

1. 将Rube MCP服务器添加到您的环境：https://rube.app/mcp
2. 提示时连接您的SurveyMonkey账户（通过Composio的OAuth流程）
3. 开始为SurveyMonkey自动化发出自然语言命令

---

核心工作流程

1. 创建新调查

创建一个新的空调查，可进一步配置问题和页面。

工具： SURVEY_MONKEY_CREATE_SURVEY

关键参数：

• title——向受访者显示的调查标题（必需）
• nickname——可选内部名称，用于组织调查（不显示给受访者）
• language——ISO 639-1语言代码（默认en）；示例：es、fr、de
• footer——是否显示SurveyMonkey品牌页脚（默认true）

创建的调查从一个空页面和无问题开始。使用返回的survey_id与其他操作一起添加内容和配置收集器。

示例提示：

“创建一个标题为’客户满意度2026年第一季度’的新调查”

---

2. 列出和搜索调查

枚举您账户中的所有调查，支持过滤、排序和分页。

工具： SURVEY_MONKEY_GET_SURVEYS

关键参数：

• title——按调查标题搜索（部分匹配）
• sort_by——按title、date_modified或num_responses排序
• sort_order——ASC或DESC
• page/per_page——分页控制（默认每页50，最大100）
• include——附加字段：response_count、date_modified、date_created、question_count、page_count、category、language、folder_id
• folder_id——筛选特定文件夹中的调查
• start_modified_at/end_modified_at——日期范围过滤（格式：YYYY-MM-DDTHH:MM:SS）

示例提示：

“列出我所有按最近修改时间排序的调查，包括响应计数”

---

3. 获取调查详情

检索特定调查的全面元数据，包括配置、问题/页面计数、响应计数以及所有相关URL。

工具： SURVEY_MONKEY_GET_SURVEY_DETAILS

关键参数：

• survey_id——唯一的调查标识符（必需）

返回：标题、语言、question_count、page_count、response_count、预览/编辑/分析/收集的URL、按钮文本和时间戳。

示例提示：

“显示调查123456789的完整详情和响应计数”

---

4. 管理收集器和分发链接

检索调查的收集器（分发渠道）以获取可共享链接并监控响应进度。

工具： SURVEY_MONKEY_GET_COLLECTORS

关键参数：

• survey_id——要获取收集器的调查（必需）
• include——附加字段：type、status、response_count、date_created、date_modified、url
• name——按收集器名称部分匹配过滤
• sort_by——按id、date_modified、type、status或name排序
• sort_order——ASC或DESC
• page/per_page——分页（默认50，最大1000）
• start_date/end_date——按创建日期过滤（格式：YYYY-MM-DDTHH:MM:SS）

示例提示：

“获取调查123456789的所有收集器，包括URL和响应计数”

---

5. 检索调查响应

使用全面的过滤选项获取特定调查的响应数据。

工具： SURVEY_MONKEY_GET_RESPONSES

关键参数：

• survey_id——要检索响应的调查（必需）
• status——按completed、partial、overquota或disqualified过滤
• page/per_page——分页（默认50，最大1000）
• sort_order——ASC或DESC（按date_modified排序）
• start_created_at/end_created_at——按创建日期范围过滤（ISO 8601）
• start_modified_at/end_modified_at——按修改日期范围过滤
• email——按受访者邮箱过滤
• first_name/last_name——按受访者姓名过滤
• ip——按IP地址过滤
• total_time_min/total_time_max/total_time_units——按完成时间过滤

示例提示：

“获取调查123456789过去30天的所有完成响应”

---

6. 完整调查生命周期工作流程

结合工具进行端到端调查管理：

1. 创建： SURVEY_MONKEY_CREATE_SURVEY——创建调查，存储survey_id
2. 分发： SURVEY_MONKEY_GET_COLLECTORS——检索收集器链接以与受访者共享
3. 监控： SURVEY_MONKEY_GET_SURVEY_DETAILS——检查响应计数和调查状态
4. 收集： SURVEY_MONKEY_GET_RESPONSES——检索完成响应，按status=completed过滤
5. 审计： SURVEY_MONKEY_GET_SURVEYS——浏览和查找调查，如果survey_id丢失

示例提示：

“创建一个名为’活动反馈’的调查，然后展示如何分发它”

---

已知陷阱

陷阱	详情
分页必需	SURVEY_MONKEY_GET_COLLECTORS和SURVEY_MONKEY_GET_RESPONSES需要对大型调查管理page/per_page，以避免遗漏数据
状态过滤关键	SURVEY_MONKEY_GET_RESPONSES返回部分、超额和无效条目，除非过滤——使用status=completed获取可靠数据
创建时无共享链接	SURVEY_MONKEY_CREATE_SURVEY不创建分发链接——使用SURVEY_MONKEY_GET_COLLECTORS获取可共享URL
调查ID存储	丢失survey_id会迫使依赖SURVEY_MONKEY_GET_SURVEYS，速度较慢——创建后立即存储ID
问题ID映射	响应中的问题ID和答案格式必须仔细映射；使用SURVEY_MONKEY_GET_SURVEY_DETAILS了解结构
日期格式	日期过滤器使用YYYY-MM-DDTHH:MM:SS格式，而非带时区的ISO 8601
创建时调查为空	新调查从一个空页面和无问题开始——需要进一步配置

---

快速参考

动作	工具标识	关键参数
创建调查	SURVEY_MONKEY_CREATE_SURVEY	title、language、nickname
列出调查	SURVEY_MONKEY_GET_SURVEYS	title、sort_by、include、page
获取调查详情	SURVEY_MONKEY_GET_SURVEY_DETAILS	survey_id
列出收集器	SURVEY_MONKEY_GET_COLLECTORS	survey_id、include、sort_by
获取响应	SURVEY_MONKEY_GET_RESPONSES	survey_id、status、start_created_at

---

由Composio提供支持