instacart

@striderlabs/mcp-instacart

AI エージェントを使って Instacart で食料品を注文

Strider Labs の一部です — パーソナル AI エージェント向けのアクション実行機能を提供します。

2 分で始める

Claude Desktop ユーザー向け

1. Claude Desktop の設定に以下を追加します。

{
  "mcpServers": {
    "instacart": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-instacart"]
    }
  }
}

2. Claude を再起動します。
3. Claude に「明日の朝、いつもの食料品を配達で注文して」と伝えます。

これでエージェントが注文できるようになります。以上です。

---

インストール（NPM）

npm install @striderlabs/mcp-instacart

または、npx を直接使います。

npx @striderlabs/mcp-instacart

機能

• 🛒 名前またはカテゴリーで商品を検索
• 📦 店舗と商品の在庫状況を確認
• 🏪 数量や特別なリクエストを指定してカートに追加
• 💳 配達時間を選択して注文
• 📍 リアルタイムのステータスで注文を追跡
• 🔐 セッションを保持 - 再起動後もログイン状態を維持
• 🔄 MFA を自動処理 - 多要素認証に対応
• 📱 ユーザーごとの認証情報 - セッションを暗号化して保存
• ⭐ 保存済みアイテム - お気に入りをよりすばやく注文

テスト済みの互換性

コンポーネント	バージョン	状態
MCP SDK	^1.0.0	✅
Node.js	18+	✅
Claude Desktop	最新	✅
Claude (API)	claude-3.5-sonnet+	✅
Anthropic SDK	^0.20+	✅

指標

• 週間ダウンロード数： 271（2026 年 4 月 10〜17 日）— 食料品コネクターのトップ（330% 増）
• ステータス： ✅ 本番環境で稼働中
• 信頼性： タスク完了率 85% 以上
• 掲載先： npm、mcpservers.org、ClawHub、PulseMCP、Glama、LobeHub

他の掲載先

• npm： npmjs.com/@striderlabs/mcp-instacart
• Claude Plugins： Claude で「Strider Labs」を検索
• mcpservers.org： Strider Labs Instacart
• Strider Labs 全体： github.com/striderlabsdev/striderlabs

仕組み

エージェント向け

エージェントは以下の機能を使用できます。

// Search for products
products = search_products({
  query: "organic milk",
  location: "San Francisco, CA"
})

// Browse a store's offerings
store_products = get_store_products({
  store_id: "whole_foods_sf",
  category: "Dairy"
})

// Add to cart
add_to_cart({
  product_id: "organic_milk_gallon",
  quantity: 2,
  special_instructions: "Cold stock, please"
})

// Place an order
order = place_order({
  delivery_time: "tomorrow morning",
  delivery_address: "123 Main St, San Francisco, CA",
  special_instructions: "Ring the doorbell twice"
})

// Track delivery
status = track_order({ order_id: order.order_id })

セッション管理

• 各ユーザーの認証情報は暗号化され、永続的に保存されます
• OAuth トークンを自動更新します
• MFA（SMS／メール）に対応します
• エージェントの再起動後もセッションは維持されます

信頼性

• タスク完了率 85% 以上
• UI の変更を自動検出（Instacart の変更に応じてコネクターを更新）
• 障害発生時のフォールバック経路
• 24 時間 365 日の監視とアラート

認証

MCP サーバーは永続的なブラウザープロファイル（~/.strider/instacart/browser-profile）を使用するため、サーバーを再起動してもログインセッションが自動的に維持されます。

初回ログイン

1. MCP サーバーの設定で INSTACART_HEADLESS=false を設定し、ブラウザーウィンドウを表示します。

{
  "mcpServers": {
    "instacart": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-instacart"],
      "env": { "INSTACART_HEADLESS": "false" }
    }
  }
}

2. Claude／MCP クライアントを再起動します。
3. Claude に instacart_login の実行を依頼します — 実際のブラウザーウィンドウが開きます。
4. そのウィンドウ内で Instacart にログインします。
5. instacart_status を実行して認証を確認します。
6. INSTACART_HEADLESS を削除する（または true に戻す）とともに再起動します — 保存済みプロファイルによってログイン状態が維持されます。

ログイン検出の仕組み

/account に移動し、/login または /authentication へリダイレクトされずにページが表示されることを確認して、認証を検証します（肯定的検出）。これは「ログイン」ボタンがないことを確認する方法よりも信頼性が高い方法です。

設定

環境変数

# Show browser window (required for first-time login)
INSTACART_HEADLESS=false   # default: true (headless)

セルフホスト

# Clone the repo
git clone https://github.com/striderlabsdev/mcp-instacart
cd mcp-instacart

# Install dependencies
npm install

# Start the server
npm start

# Your agent can now connect to localhost:3000

アーキテクチャ

接続方法

このコネクターは、Instacart に公開 API がないため、ブラウザー自動化（Playwright）を使って Instacart を操作します。これが安全で信頼性の高い方法である理由は次のとおりです。

• ユーザーが管理： エージェントがアクセスするのは、ご自身の Instacart アカウントのみです
• セッションベース： ログインセッションは安全に保存し、パスワードは保存しません
• 変更を検知： Instacart の UI の変更を検知し、すぐに通知します
• フィンガープリント対策： ボット検出を回避するため、現実的なブラウザープロファイルを使用します
• レート制限： 適切な遅延を設け、Instacart のインフラストラクチャに配慮します

セキュリティ

• 認証情報はローカルの .env または安全な保管庫に暗号化して保存されます
• セッションはユーザーごとに分離されます
• 第三者にデータを送信しません
• MIT ライセンス — コードを自分で監査できます

サポート

• 📖 Strider Labs のドキュメント全文
• 🐛 問題を報告
• 💬 ディスカッション
• 🌐 ウェブサイト
• 📧 メール

コントリビュート

コントリビュートを歓迎します！特に、次の分野での貢献をお待ちしています。

• バグの報告と修正
• 機能のリクエスト（新しい店舗、カテゴリなど）
• パフォーマンスの改善
• ドキュメントの拡充

ガイドラインについては、CONTRIBUTING.md をご覧ください。

ライセンス

MIT — 自由に使用、改変、配布できます。詳細については LICENSE をご覧ください。

---

Strider Labs が開発 — AI エージェントを実際に役立つものにします。

GitHub | ウェブサイト | Discord