Uploadcare 자동화
Uploadcare 파일 처리 워크플로우를 자동화하세요. 프로젝트 파일 목록 조회, 업로드 영구 저장, 파일 메타데이터 검색, 다운로드 URL 생성, 파일 그룹 관리 등을 자연어로 수행할 수 있습니다.
툴킷 문서: composio.dev/toolkits/uploadcare
설정
- Rube MCP 서버를 환경에 추가합니다:
https://rube.app/mcp - 메시지가 표시되면 Uploadcare 계정을 연결합니다 (Composio를 통한 API 키 인증)
- Uploadcare 자동화를 위한 자연어 명령을 입력하기 시작합니다
핵심 워크플로우
1. 프로젝트 파일 목록 조회
필터링, 정렬, 페이지네이션을 사용하여 Uploadcare 프로젝트에 업로드된 파일을 탐색합니다.
툴: UPLOADCARE_LIST_FILES
주요 파라미터:
stored-- 저장 상태로 필터링:"true"(저장됨),"false"(저장 안 됨)removed-- 제거 상태로 필터링:"true"(제거됨),"false"(활성)ordering--datetime_uploaded(오름차순) 또는-datetime_uploaded(내림차순)으로 정렬limit-- 페이지당 파일 수, 1-1000 (기본값 100)offset-- 0부터 시작하는 페이지네이션 오프셋from_date-- ISO 8601 타임스탬프, 이 날짜 이후 업로드된 파일 필터링to_date-- ISO 8601 타임스탬프, 이 날짜 이전 업로드된 파일 필터링include--"total"로 설정하면 응답에 전체 파일 수 포함
예시 프롬프트:
"내 Uploadcare 프로젝트에서 가장 최근에 업로드된 저장된 파일 50개를 나열해줘"
2. 파일 영구 저장
업로드된 파일을 영구 저장됨으로 표시합니다. 기본적으로 Uploadcare 파일은 임시 상태이며 24시간 후 자동 삭제됩니다.
툴: UPLOADCARE_STORE_FILE
주요 파라미터:
uuid-- 저장할 파일의 UUID (필수);8-4-4-4-1216진수 형식이어야 합니다 (예:3e55317b-23d1-4f35-9b4c-b9accb7b53f4)
파일을 업로드한 후에는 항상 저장하여 자동 삭제를 방지하세요.
예시 프롬프트:
"UUID 3e55317b-23d1-4f35-9b4c-b9accb7b53f4인 파일을 영구 저장해줘"
3. 파일 메타데이터 가져오기
특정 파일의 상세 정보(크기, MIME 유형, CDN URL, 이미지 크기 등)를 검색합니다.
툴: UPLOADCARE_GET_FILE_INFO
주요 파라미터:
uuid-- 검사할 파일의 UUID (필수); 형식:8-4-4-4-1216진수
반환값: 파일명, 크기, MIME 유형, CDN URL, 업로드 날짜, 저장 상태, 이미지 정보 (크기, 색상 모드) 등
예시 프롬프트:
"파일 3e0923f2-e05a-4b37-9f0d-343b981c9d70의 메타데이터와 크기를 가져와줘"
4. 임시 다운로드 URL 가져오기
특정 파일에 대한 임시 직접 다운로드 링크를 검색합니다.
툴: UPLOADCARE_GET_FILE_DOWNLOAD_URL
주요 파라미터:
file_id-- 고유 파일 식별자 (필수)
직접 파일 다운로드에 사용할 수 있는 시간 제한 URL을 반환합니다.
예시 프롬프트:
"파일 3e0923f2-e05a-4b37-9f0d-343b981c9d70의 다운로드 링크를 가져와줘"
5. 파일 그룹 탐색
프로젝트의 파일 그룹을 나열합니다. 그룹은 함께 업로드된 파일 모음입니다.
툴: UPLOADCARE_LIST_GROUPS
주요 파라미터:
limit-- 페이지당 그룹 수, 1-1000 (기본값 20)offset-- 0부터 시작하는 페이지네이션 오프셋 (기본값 0)ordering--datetime_created(오름차순) 또는-datetime_created(내림차순)으로 정렬
예시 프롬프트:
"가장 최근 파일 그룹 10개를 나열해줘"
6. 파일 수명 주기 워크플로우
종합적인 파일 관리를 위해 툴을 결합합니다:
- 업로드: Uploadcare의 업로드 API 또는 위젯을 통해 파일 업로드 (이 툴킷 외부)
- 저장:
UPLOADCARE_STORE_FILE-- 자동 삭제를 방지하기 위해 파일을 영구 저장으로 표시 - 검사:
UPLOADCARE_GET_FILE_INFO-- 메타데이터 확인, 크기 및 MIME 유형 검증 - 공유:
UPLOADCARE_GET_FILE_DOWNLOAD_URL-- 임시 다운로드 링크 생성 - 탐색:
UPLOADCARE_LIST_FILES-- 상태 및 날짜 필터로 모든 파일 감사 - 그룹:
UPLOADCARE_LIST_GROUPS-- 일괄 업로드 검토
예시 프롬프트:
"파일 abc-123을 저장한 다음 메타데이터와 다운로드 링크를 가져와줘"
알려진 문제점
| 문제점 | 설명 |
|---|---|
| 저장되지 않은 파일 자동 삭제 | 업로드된 파일은 기본적으로 임시 상태이며 24시간 후 삭제됩니다 -- 영구 보관을 위해 항상 UPLOADCARE_STORE_FILE을 호출하세요 |
| UUID 형식 엄격 | 파일 UUID는 정확한 8-4-4-4-12 16진수 형식이어야 합니다 (예: 3e55317b-23d1-4f35-9b4c-b9accb7b53f4); 잘못된 형식은 거부됩니다 |
| 필터 값은 문자열 | stored와 removed 파라미터는 문자열 값 "true" 또는 "false"를 받으며, 불리언 값이 아닙니다 |
| 임시 다운로드 URL | UPLOADCARE_GET_FILE_DOWNLOAD_URL에서 반환된 URL은 시간 제한이 있으며 만료됩니다 |
| 페이지네이션은 오프셋 기반 | 페이지네이션에 offset + limit을 사용하세요; 커서 기반 페이지네이션 토큰은 없습니다 |
| 업로드 툴 없음 | 파일 업로드는 이 툴킷이 아닌 Uploadcare의 업로드 API 또는 위젯을 통해 이루어집니다 -- 이 툴들은 이미 업로드된 파일을 관리합니다 |
빠른 참조
| 작업 | 툴 슬러그 | 주요 파라미터 |
|---|---|---|
| 파일 목록 조회 | UPLOADCARE_LIST_FILES | stored, ordering, limit, offset |
| 파일 저장 | UPLOADCARE_STORE_FILE | uuid |
| 파일 정보 가져오기 | UPLOADCARE_GET_FILE_INFO | uuid |
| 다운로드 URL 가져오기 | UPLOADCARE_GET_FILE_DOWNLOAD_URL | file_id |
| 그룹 목록 조회 | UPLOADCARE_LIST_GROUPS | limit, offset, ordering |
Composio 제공