SurveyMonkey 자동화
자연어 명령을 통해 SurveyMonkey 설문 워크플로우를 자동화합니다. 설문 생성, 기존 설문 검색 및 필터링, 수집기 및 배포 링크 관리, 응답 검색, 설문 세부 정보 조회 등 모든 작업을 자연어로 수행할 수 있습니다.
툴킷 문서: composio.dev/toolkits/survey_monkey
설정
- 환경에 Rube MCP 서버를 추가합니다:
https://rube.app/mcp - 메시지가 표시되면 SurveyMonkey 계정을 연결합니다 (Composio를 통한 OAuth 흐름)
- SurveyMonkey 자동화를 위한 자연어 명령을 실행하기 시작합니다
핵심 워크플로우
1. 새 설문 조사 생성
질문과 페이지를 추가로 구성할 수 있는 새 빈 설문을 생성합니다.
도구: SURVEY_MONKEY_CREATE_SURVEY
주요 매개변수:
title-- 응답자에게 표시될 설문 제목 (필수)nickname-- 설문 구성을 위한 선택적 내부 이름 (응답자에게 표시되지 않음)language-- ISO 639-1 언어 코드 (기본값en); 예:es,fr,defooter-- SurveyMonkey 브랜딩 푸터 표시 여부 (기본값true)
생성된 설문은 빈 페이지 하나와 질문이 없는 상태로 시작합니다. 반환된
survey_id를 다른 작업과 함께 사용하여 콘텐츠를 추가하고 수집기를 구성하세요.
예시 프롬프트:
"'2026년 1분기 고객 만족도'라는 제목의 새 설문을 생성해줘"
2. 설문 목록 및 검색
계정의 모든 설문을 필터링, 정렬 및 페이지네이션을 지원하여 열거합니다.
도구: SURVEY_MONKEY_GET_SURVEYS
주요 매개변수:
title-- 설문 제목으로 검색 (부분 일치)sort_by--title,date_modified또는num_responses기준 정렬sort_order--ASC또는DESCpage/per_page-- 페이지네이션 컨트롤 (기본값 50, 최대 100)include-- 추가 필드:response_count,date_modified,date_created,question_count,page_count,category,language,folder_idfolder_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,urlname-- 수집기 이름에 대한 부분 일치 필터sort_by--id,date_modified,type,status또는name기준 정렬sort_order--ASC또는DESCpage/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. 전체 설문 생애 주기 워크플로우
종합적인 설문 관리를 위해 도구를 결합합니다:
- 생성:
SURVEY_MONKEY_CREATE_SURVEY-- 설문 생성,survey_id저장 - 배포:
SURVEY_MONKEY_GET_COLLECTORS-- 응답자와 공유할 수집기 링크 검색 - 모니터링:
SURVEY_MONKEY_GET_SURVEY_DETAILS-- 응답 수 및 설문 상태 확인 - 수집:
SURVEY_MONKEY_GET_RESPONSES-- 완료된 응답 검색,status=completed로 필터링 - 감사:
SURVEY_MONKEY_GET_SURVEYS--survey_id를 분실한 경우 설문 찾아보기 및 검색
예시 프롬프트:
"'이벤트 피드백'이라는 설문을 만들고, 배포 방법을 보여줘"
알려진 문제점
| 문제점 | 설명 |
|---|---|
| 페이지네이션 필요 | SURVEY_MONKEY_GET_COLLECTORS 및 SURVEY_MONKEY_GET_RESPONSES는 대규모 설문에서 데이터 누락을 방지하기 위해 page/per_page 관리가 필요합니다 |
| 상태 필터링 중요 | SURVEY_MONKEY_GET_RESPONSES는 필터링하지 않으면 partial, overquota, disqualified 항목을 반환합니다. 신뢰할 수 있는 데이터를 위해 status=completed를 사용하세요 |
| 생성 시 공유 링크 없음 | SURVEY_MONKEY_CREATE_SURVEY는 배포 링크를 생성하지 않습니다. 공유 가능한 URL을 얻으려면 SURVEY_MONKEY_GET_COLLECTORS를 사용하세요 |
| 설문 ID 저장 필요 | survey_id를 분실하면 속도가 느린 SURVEY_MONKEY_GET_SURVEYS에 의존해야 합니다. 생성 직후 ID를 저장하세요 |
| 질문 ID 매핑 | 응답의 질문 ID와 답변 형식을 주의 깊게 매핑해야 합니다. 구조를 이해하려면 SURVEY_MONKEY_GET_SURVEY_DETAILS를 사용하세요 |
| 날짜 형식 | 날짜 필터는 시간대가 포함된 ISO 8601이 아닌 YYYY-MM-DDTHH:MM:SS 형식을 사용합니다 |
| 생성 시 빈 설문 | 새 설문은 빈 페이지 하나와 질문이 없는 상태로 시작합니다. 추가 구성이 필요합니다 |
빠른 참조
| 작업 | 도구 슬러그 | 주요 매개변수 |
|---|---|---|
| 설문 생성 | 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 제공