ComposioHQ/Uploadcare-Automation

Uploadcare 自動化

Uploadcareのファイル処理ワークフローを自動化 —— プロジェクトファイルの一覧表示、アップロードの永続保存、ファイルメタデータの取得、ダウンロードURLの発行、ファイルグループの管理 —— すべて自然言語で実現します。

ツールキットドキュメント: composio.dev/toolkits/uploadcare

---

セットアップ

1. Rube MCPサーバーを環境に追加: https://rube.app/mcp
2. プロンプトに従ってUploadcareアカウントを接続（Composio経由のAPIキー認証）
3. Uploadcare自動化のための自然言語コマンドを発行開始

---

コアワークフロー

1. プロジェクトファイルの一覧表示

フィルタリング、ソート、ページネーションを使って、Uploadcareプロジェクトにアップロードされたファイルをブラウズします。

ツール: UPLOADCARE_LIST_FILES

主要パラメータ:

• stored — 保存ステータスでフィルタ: "true"（保存済み）、"false"（未保存）
• removed — 削除ステータスでフィルタ: "true"（削除済み）、"false"（アクティブ）
• ordering — datetime_uploaded（昇順）または -datetime_uploaded（降順）でソート
• limit — 1ページあたりのファイル数、1～1000（デフォルト100）
• offset — 0ベースのページネーションオフセット
• from_date — ISO 8601タイムスタンプ、この日付以降にアップロードされたファイルをフィルタ
• to_date — ISO 8601タイムスタンプ、この日付より前にアップロードされたファイルをフィルタ
• include — レスポンスにファイル総数を含める場合は "total" を設定

プロンプト例:

「アップロードプロジェクト内で、最も最近アップロードされた保存済みファイルを50件リスト表示して」

---

2. ファイルを永続保存

アップロードファイルを永続保存としてマークします。デフォルトではUploadcareファイルは一時的で、24時間後に削除されます。保存しない限り削除されます。

ツール: UPLOADCARE_STORE_FILE

主要パラメータ:

• uuid — 保存するファイルのUUID（必須）; 8-4-4-4-12 の16進形式である必要があります（例: 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-12 の16進数

返される情報: ファイル名、サイズ、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ページあたりのグループ数、1～1000（デフォルト20）
• offset — 0ベースのページネーションオフセット（デフォルト0）
• ordering — datetime_created（昇順）または -datetime_created（降順）でソート

プロンプト例:

「最新のファイルグループを10件リスト表示して」

---

6. ファイルライフサイクルワークフロー

ツールを組み合わせたエンドツーエンドのファイル管理:

1. アップロード: ファイルはUploadcareのアップロードAPIまたはウィジェット経由でアップロード（このツールキットの外部）
2. 保存: UPLOADCARE_STORE_FILE — 自動削除を防ぐためファイルを永続化
3. 検査: UPLOADCARE_GET_FILE_INFO — メタデータを確認、寸法やMIMEタイプをチェック
4. 共有: UPLOADCARE_GET_FILE_DOWNLOAD_URL — 一時ダウンロードリンクを生成
5. ブラウズ: UPLOADCARE_LIST_FILES — ステータスと日付フィルタで全ファイルを監査
6. グループ: 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

---

Powered by Composio