shopify-automation

Rube MCP 経由の Shopify 自動化

Rube MCP 経由で Composio の Shopify ツールキットを使用し、Shopify の操作を自動化します。

ツールキットのドキュメント：composio.dev/toolkits/shopify

前提条件

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

セットアップ

Rube MCP の入手：クライアントの設定で https://rube.app/mcp を MCP サーバーとして追加します。API キーは不要です。エンドポイントを追加するだけで動作します。

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

主なワークフロー

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：ページごとの顧客数
• 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：標準プランでは毎秒 2 リクエスト
• GraphQL：毎秒 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

---

Composio 提供