mcpField
A
amazon

amazon

github.com/tychohq生産性0131 回インストール30 週間前に更新
リポジトリ

amazon について

amazonは、agent-browserとChromeを使ってAmazonの注文や返品を行うスキルです。再注文と新規購入を区別し、新規購入は確認後に進め、返品には既定の回答と確認手順を用います。

主な機能

  1. 01agent-browserでChromeに接続
  2. 02購入済み商品の再注文
  3. 03新規購入前に商品情報を提示
  4. 04配送先と支払い方法を確認
  5. 05既定の回答に沿って返品を処理

活用シーン

  1. 01以前注文した商品を再購入
  2. 02新規商品の購入内容を確認に回す
  3. 03商品の返金返品を手続き
  4. 04返品の持ち込み場所を選択

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/tychohq/agent-skills --skill amazon

インストール後、Claude Code で/amazonを入力して読み込まれたか確認します。

詳細

Amazonでの注文

前提条件

  • agent-browser CLI がインストールされていること
  • Chrome が --remote-debugging-port=9222 を指定して起動していること（ブラウザーの起動（未起動の場合）を参照）
  • Amazon にログインしていること — ログアウトしている場合は、パスワードマネージャーからパスワードを取得します
  • ヘッドレス環境（Linux/VNC）で実行する場合は、目視で確認できるように VNC ポートを転送します：ssh -L 6080:localhost:6080 <host> → http://localhost:6080/vnc.html

セットアップ

以下の環境変数を設定するか、デフォルト値を設定してください：

# Your default shipping address (verify on checkout)
export AMAZON_SHIPPING_ADDRESS="Your shipping address"
# Your preferred payment method description (verify on checkout)
export AMAZON_PAYMENT_METHOD="Your preferred card"
# Your preferred return drop-off location
export AMAZON_RETURN_DROPOFF="Whole Foods"

注文を確定する前に、配送先住所と支払い方法が正しいことを必ず確認してください。

返品

デフォルトの回答（ユーザーから指定がない限り使用）
  • 返品理由： 「Changed Mind」→「My needs changed」
  • 梱包を開封しましたか： はい
  • 商品は元の梱包に入っていますか： はい
  • 商品を使用しましたか： はい
  • 使用した形跡： なし
  • バッテリーの液漏れ／過熱： いいえ
  • 付属品はすべて揃っていますか： はい
  • 返金方法： 元の支払い方法に返金（交換やギフトカードではありません）
  • 持ち込み場所： AMAZON_RETURN_DROPOFF または Whole Foods を使用
返品の手順
  1. 注文 → 商品を探す → 「Return or replace items」
  2. 「Changed Mind」→「My needs changed」→「Continue」を選択
  3. 上記のデフォルトの回答で商品の状態に関する質問に回答
  4. 「Get Product Support」の提案を進めて通過
  5. 「Refund to original payment method」を選択
  6. 持ち込み場所を選択
  7. 返品を確定
  8. 完了 — QR コードがメールで届きます
コミュニケーションのスタイル
  • 各手順を逐一説明しないでください — 返品の全手順を黙って実行してください
  • **返品が確定してから一度だけユーザーにメッセージを送り、**簡潔に以下を伝えてください：
    • 商品名
    • 返金額
    • 持ち込み場所と期限
  • 問題が発生した場合や確認が必要な場合は、ユーザーに尋ねてください

注文のルール

再注文（以前に注文した商品）
  • 注文履歴に直接移動し、商品を検索
  • 「Buy it again」をクリック
  • 住所と支払い方法を確認
  • 確認を求めずに注文を確定 — スクリーンショットは不要です
新しい商品（注文したことがない商品）
  • 商品を検索するか、商品ページに移動
  • 商品ページのスクリーンショットを送信（価格と商品画像が見えるようにスクロールし、ナビゲーションバーは含めない）
  • カートに追加する前に、ユーザーの確認を待つ
  • 住所と支払い方法を確認
  • 確認後に注文を確定

ワークフロー

ブラウザーに接続
agent-browser connect 9222

必ず新しいタブを開いてください — 他のセッションも同じ Chrome を共有しています。open コマンドを実行するたびに --new-tab を使用してください。

注文履歴を検索
agent-browser open "https://www.amazon.com/gp/your-account/order-history"
agent-browser snapshot -i
# Find search box, fill with item name, click search
再注文の手順
# From order history search results
agent-browser click @[buy-it-again-ref]
# Wait for checkout page
agent-browser snapshot
# Verify correct address and payment method are selected
agent-browser click @[place-order-ref]
スクリーンショットのヒント
  • スクリーンショットを撮る前に、ナビゲーションバーを越えてスクロールする
  • 価格と商品画像の両方が表示されていることを確認する
  • スクリーンショットは一時ディレクトリに保存する
  • キャプションを付けてメッセージツールで送信する

ブラウザーの起動（未起動の場合）

macOS（Chrome ウィンドウを表示して起動）：

open -na "Google Chrome" --args --user-data-dir=$HOME/.config/chrome-agent --no-first-run --remote-debugging-port=9222 https://www.amazon.com

Linux（Xvfb/VNC を使用したヘッドレス環境）：

DISPLAY=:99 google-chrome --user-data-dir=$HOME/.config/chrome-agent --no-first-run --remote-debugging-port=9222 https://www.amazon.com &

Linux（デスクトップ／GUI セッション）：

google-chrome --user-data-dir=$HOME/.config/chrome-agent --no-first-run --remote-debugging-port=9222 https://www.amazon.com &

注意事項

  • ブラウザープロファイルにはログイン状態が $HOME/.config/chrome-agent に保持されます
  • ヘッドレスの Linux では、VNC ディスプレイは通常 :99、ポートは 5999 です（noVNC は 6080）
  • 注文確認は Amazon アカウントに登録されているメールアドレスに届きます
  • CAPTCHA または 2FA では手動操作が必要になる場合があります — ブラウザーウィンドウが表示されている場合（macOS または Linux デスクトップ）は、Chrome ウィンドウで解決するようユーザーに依頼してください

コメント

Markdown 対応