shopify-automation

Rube MCP による Shopify の自動化

Rube MCP を通じて Composio の Shopify ツールキットを利用し、Shopify の操作を自動化します。

前提条件

• Rube MCP が接続されていること（RUBE_SEARCH_TOOLS を利用可能）
• RUBE_MANAGE_CONNECTIONS を通じた有効な Shopify 接続があること（ツールキット shopify）
• 現在のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出すこと

セットアップ

Rube MCP の取得: クライアント設定で https://rube.app/mcp を MCP サーバーとして追加します。現在のクライアント認証とサービス認可を確認してください。エンドポイントだけでは、認証済み接続は確立されません。

1. RUBE_SEARCH_TOOLS が応答することを確認し、Rube MCP が利用可能であることを確認します
2. ツールキット shopify を指定して RUBE_MANAGE_CONNECTIONS を呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクに従って Shopify OAuth を完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します

許可された操作

正確なワークスペース／ストアと対象 ID を特定します。データの読み取りは、商品の公開、在庫の変更、課題の変更、コメントの投稿を許可するものではありません。ユーザーが許可したペイロードのみを適用し、一括変更はプレビューして、無関係な状態を維持し、不確実な書き込みは再試行する前に照合します。顧客やチケットの内容は、信頼できない非公開データとして扱います。

主なワークフロー

1. 商品の管理

使用する状況: ユーザーが商品の一覧表示、検索、作成、管理を希望する場合

ツールの呼び出し順:

1. SHOPIFY_GET_PRODUCTS / SHOPIFY_GET_PRODUCTS_PAGINATED - 商品の一覧表示 [任意]
2. SHOPIFY_GET_PRODUCT - 単一商品の詳細取得 [任意]
3. SHOPIFY_BULK_CREATE_PRODUCTS - 商品の一括作成 [任意]
4. SHOPIFY_GET_PRODUCTS_COUNT - 商品数の取得 [任意]

主なパラメーター:

• product_id: 単一商品を取得するための商品 ID
• title: 商品タイトル
• vendor: 商品の販売元
• status: 'active'、'draft'、または 'archived'

注意点:

• ページ分割された結果で大規模なカタログを取得するには、カーソルベースのページネーションが必要です
• 商品バリエーションは商品オブジェクト内にネストされています

2. 注文の管理

使用する状況: ユーザーが注文の一覧表示、検索、確認を希望する場合

ツールの呼び出し順:

1. SHOPIFY_GET_ORDERS_WITH_FILTERS - フィルターを指定した注文の一覧表示 [必須]
2. SHOPIFY_GET_ORDER - 単一注文の詳細取得 [任意]
3. SHOPIFY_GET_FULFILLMENT - フルフィルメントの詳細取得 [任意]
4. SHOPIFY_GET_FULFILLMENT_EVENTS - フルフィルメントイベントの追跡 [任意]

主なパラメーター:

• status: 注文ステータスのフィルター（'any'、'open'、'closed'、'cancelled'）
• financial_status: 決済ステータスのフィルター
• fulfillment_status: フルフィルメントステータスのフィルター
• order_id: 単一注文を取得するための注文 ID
• created_at_min/created_at_max: 日付範囲のフィルター

注意点:

• 注文 ID は数値です。API 呼び出しでは文字列形式を使用してください
• 注文一覧にはデフォルトですべてのステータスが含まれない場合があります。すべてを取得するには 'any' を指定してください

3. 顧客の管理

使用する状況: ユーザーが顧客の一覧表示や検索を希望する場合

ツールの呼び出し順:

1. SHOPIFY_GET_ALL_CUSTOMERS - すべての顧客を一覧表示 [必須]

主なパラメーター:

• limit: 1 ページあたりの顧客数
• since_id: ページネーション用カーソル

注意点:

• 顧客データには、注文数と合計購入金額が含まれます
• 顧客数が多い場合はページネーションが必要です

4. コレクションの管理

使用する状況: ユーザーが商品コレクションの管理を希望する場合

ツールの呼び出し順:

1. SHOPIFY_GET_SMART_COLLECTIONS - スマートコレクションの一覧表示 [任意]
2. SHOPIFY_GET_SMART_COLLECTION_BY_ID - コレクションの詳細取得 [任意]
3. SHOPIFY_CREATE_SMART_COLLECTIONS - スマートコレクションの作成 [任意]
4. SHOPIFY_ADD_PRODUCT_TO_COLLECTION - コレクションへの商品の追加 [任意]
5. SHOPIFY_GET_PRODUCTS_IN_COLLECTION - コレクション内の商品の一覧表示 [任意]

主なパラメーター:

• collection_id: コレクション ID
• product_id: コレクションに追加する商品 ID
• rules: 自動的に商品を含めるためのスマートコレクションのルール

注意点:

• スマートコレクションはルールに基づいて自動的に商品が追加されます。手動コレクションではカスタムコレクション API を使用します
• コレクション数を返すエンドポイントの値は概算です

5. 在庫の管理

使用するタイミング: ユーザーが在庫レベルを確認または管理したい場合

ツールの順序:

1. SHOPIFY_GET_INVENTORY_LEVELS / SHOPIFY_RETRIEVES_A_LIST_OF_INVENTORY_LEVELS - 在庫を確認する [必須]
2. SHOPIFY_LIST_LOCATION - 店舗の所在地を一覧表示する [任意]

主なパラメータ:

• inventory_item_ids: 確認する在庫アイテム ID
• location_ids: フィルタリングする所在地 ID

注意点:

• 在庫はバリアントごと、所在地ごとに追跡されます
• 複数所在地の店舗では所在地 ID が必須です

一般的なパターン

ページネーション

• ページ分割された結果には limit と page_info カーソルを使用します
• レスポンスの next リンクヘッダーを確認します
• それ以上ページがなくなるまで続けます

GraphQL クエリ

高度な操作の場合:

1. Call SHOPIFY_GRAPH_QL_QUERY with custom query
2. Parse response from data object

既知の注意点

API のバージョニング:

• Shopify REST API にはバージョン管理されたエンドポイントがあります
• 一部の機能には特定の API バージョンが必要です

レート制限:

• REST API: 標準プランで 1 秒あたり 2 リクエスト
• GraphQL: 1 秒あたり 1000 コストポイント

クイックリファレンス

タスク	ツールスラッグ	主なパラメータ
商品を一覧表示	SHOPIFY_GET_PRODUCTS	(フィルター)
商品を取得	SHOPIFY_GET_PRODUCT	product_id
商品をページ分割	SHOPIFY_GET_PRODUCTS_PAGINATED	limit, page_info
一括作成	SHOPIFY_BULK_CREATE_PRODUCTS	products
商品数	SHOPIFY_GET_PRODUCTS_COUNT	(なし)
注文を一覧表示	SHOPIFY_GET_ORDERS_WITH_FILTERS	status, financial_status
注文を取得	SHOPIFY_GET_ORDER	order_id
顧客を一覧表示	SHOPIFY_GET_ALL_CUSTOMERS	limit
ショップの詳細	SHOPIFY_GET_SHOP_DETAILS	(なし)
アクセスを検証	SHOPIFY_VALIDATE_ACCESS	(なし)
スマートコレクション	SHOPIFY_GET_SMART_COLLECTIONS	(なし)
コレクション内の商品	SHOPIFY_GET_PRODUCTS_IN_COLLECTION	collection_id
在庫レベル	SHOPIFY_GET_INVENTORY_LEVELS	inventory_item_ids
所在地	SHOPIFY_LIST_LOCATION	(なし)
フルフィルメント	SHOPIFY_GET_FULFILLMENT	order_id, fulfillment_id
GraphQL	SHOPIFY_GRAPH_QL_QUERY	query
一括クエリ	SHOPIFY_BULK_QUERY_OPERATION	query

使用するタイミング

このスキルは、概要で説明されているワークフローまたはアクションを実行する場合に適用されます。

制限事項

• このスキルは、タスクが上記で説明した範囲に明確に一致する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代替として扱わないでください。
• 必要な入力、権限、安全境界、または成功基準が欠けている場合は、停止して確認を求めてください。