# eBay Shipping Policy MCP

Claude Code から、あなた自身のeBay出品アカウントの「フルフィルメント（シッピング）ポリシー」を操作できるようにするツールです。

## できること

Claude Code 上では `mcp__shipping-policy__<ツール名>` として呼び出されます。

| ツール | 用途 |
|---|---|
| `list_policies` | 全フルフィルメントポリシー一覧を取得 |
| `get_policy_exclusions` | 特定ポリシーの除外国・除外地域を取得 |
| `update_exclusions` | 1つのポリシーの除外を追加・削除・置き換え（dryRun対応） |
| `bulk_update_exclusions` | 名前フィルタで対象を絞った一括更新（dryRun既定） |
| `export_all_excel` | 全ポリシーをピボット形式のExcelに書き出し |
| `import_excel` | Excelを読み込んで差分適用（dryRun既定） |
| `list_shipping_services` | 配送サービス一覧（domestic / international） |
| `reorder_shipping_services` | 配送サービスの並び替え |
| `add_shipping_service` | 配送サービスを追加 |
| `remove_shipping_service` | 配送サービスを削除 |
| `clone_policy` | 既存ポリシーを複製して新規作成 |
| `delete_policy` | 単体ポリシーを削除（dryRun対応） |
| `bulk_delete_policies` | 複数ポリシーを一括削除（dryRun既定） |

### オプション機能（既定オフ）

以下の2つは出品そのものを扱う強い機能のため、この公開版では**既定でオフ**です。

| ツール | 用途 |
|---|---|
| `check_listings` | 重複チェックExcelの解析（eBayステータス確認・タイトル重複・item_id重複の検出） |
| `end_listings` | 出品の一括終了（dryRun既定 `true`） |

有効化する方法: `.env` に `EBAY_ENABLE_LISTING_TOOLS=true` を設定し、Claude Codeを再起動してください。

> **【最重要警告】** `end_listings` は配送ポリシーではなく **eBayの出品そのものを終了** します（元に戻せません）。有効化した場合でも、必ずdryRunで内容を確認してから実行してください。

## 使い方

Claude Codeを開いて、次の1行を貼ってください。

```
https://github.com/naokijodan/ebay-shipping-policy-mcp をセットアップして。まず SETUP.md を読んで手順どおりに進めて
```

あとはAIが `SETUP.md` の手順に沿って、インストール・eBayとの連携設定・Claude Codeへの登録まで進めます。人間が行うのは「eBay Developerサイトでのクリック操作」と「eBayへのログイン」だけです。

## 安全設計について

- APIキーやトークンは **あなたのパソコンの `.env` ファイルだけ** に保存されます。
- 作者を含め、誰もあなたの `.env` の中身を見ることはできません（このリポジトリのどこにも送信されません）。
- `.env` は `.gitignore` に登録されており、git（GitHubへの公開）には絶対に含まれません。
- AIエージェントには「`.env`の中身を表示しない・外部に送らない」ことを`SETUP.md`内で明示しています。
- ポリシーの削除・出品の終了など元に戻せない操作は、eBayのデータを変更する全てのツールで「まず結果をプレビュー（dryRun）→ 内容確認 → 実行」の2段階になっています（`clone_policy`は新規作成のみのためdryRunがありませんが、作成前に名前と複製元を確認してください）。
- `end_listings` は配送ポリシーの管理ツールではなく、**eBayの出品そのものを終了する機能**を含みます。使うときは必ずdryRunを先行させ、内容を確認してから実行してください。

## 必要なもの

- eBayの出品アカウント
- eBay Developer Program への登録（無料。SETUP.mdの案内に従って登録します）
- Mac または Linux
- Node.js 18以上
- Claude Code

## 免責事項

本ツールは自己責任でご利用ください。eBayのAPI仕様やポリシーは予告なく変更されることがあり、その結果として出品や配送設定に影響が出る可能性があります。重要な操作（一括削除・一括終了など）を行う前は、必ずプレビュー結果を確認してから実行してください。

## ライセンス

MIT