Embed badge
Show
Style
[](https://versuz.dev/skills/traygerbig-clawhub-skills-ec-master-pack-mercari-shops-agent)Free SKILL.md scraped from GitHub. Clone the repo or copy the file directly into your Claude Code skills directory.
npx versuz@latest install traygerbig-clawhub-skills-ec-master-pack-mercari-shops-agentgit clone https://github.com/traygerbig/clawhub-skills.gitcp clawhub-skills/SKILL.MD ~/.claude/skills/traygerbig-clawhub-skills-ec-master-pack-mercari-shops-agent/SKILL.md---
name: "Mercari Shops Agent"
description: "メルカリShops出品・販売管理AIエージェント — API連携で商品・注文・配送・分析を自動化"
author: "hanabi-jpn"
version: "1.0.0"
tags:
- mercari
- shops
- ecommerce
- japan
- c2c
- marketplace
---
# Mercari Shops Agent
```
╔══════════════════════════════════════════════════════╗
║ ║
║ ┌─────────────────────────────┐ ║
║ │ ┌───────────────────────┐ │ ║
║ │ │ M E R C A R I │ │ ║
║ │ │ ───────────── │ │ ║
║ │ │ S H O P S │ │ ║
║ │ │ Agent v1.0 │ │ ║
║ │ └───────────────────────┘ │ ║
║ │ │ ║
║ │ [LST] Smart Listing │ ║
║ │ [SHP] Rakuraku Shipping │ ║
║ │ [ANL] Sales Analytics │ ║
║ │ [MSG] Customer Messaging │ ║
║ │ [BLK] Bulk Operations │ ║
║ ╰─────────────────────────────╯ ║
║ ║
║ M E R C A R I S H O P S A G E N T v1.0 ║
║ ─── 2,300万人のマーケットをAIで攻略 ─── ║
║ ║
╚══════════════════════════════════════════════════════╝
```
[](https://github.com/hanabi-jpn/clawhub-skills)
[](LICENSE)
[](https://about.mercari.com/)
[](https://www.mercari.com/jp/shipping/)
`claude-code` `mercari` `shops` `ecommerce` `japan`
> **メルカリShops出品・在庫管理・注文処理・配送手配・売上分析・顧客対応をAPI連携で完全自動化。2,300万MAUのフリマ経済圏で法人販売を最大化するAIエージェント。**
**Author:** hanabi-jpn
**Version:** 1.0.0
**License:** MIT
**Tags:** mercari, shops, ecommerce, japan, c2c, marketplace, shipping
---
## Overview
Mercari Shops Agent は、メルカリShops APIを通じてショップ運営を包括的に自動化するAIエージェントです。メルカリは月間利用者数2,300万人を誇る日本最大のフリマアプリであり、メルカリShopsはその巨大なユーザーベースに法人・個人事業主が直接アクセスできるプラットフォームです。商品出品、在庫管理、注文処理、配送管理（らくらくメルカリ便/ゆうゆうメルカリ便）、売上分析、顧客対応を単一のインターフェースから実行できます。メルカリ特有のカジュアルな購買体験と、C2C経済圏のダイナミクスを理解した運用最適化を提供します。
```
┌────────────────────────────────────────────────────────────────────┐
│ MERCARI SHOPS AGENT ARCHITECTURE │
│ │
│ ┌───────────┐ ┌────────────────┐ ┌────────────────┐ │
│ │ Claude │──────▶│ Mercari Shops │─────▶│ Mercari │ │
│ │ Code │◀──────│ Agent │◀─────│ Shops API │ │
│ └───────────┘ └──────┬─────────┘ └───────┬────────┘ │
│ │ │ │
│ ┌────────┼─────────┐ │ │
│ ▼ ▼ ▼ ▼ │
│ ┌─────────┐┌────────┐┌──────────┐ ┌──────────┐ │
│ │Listing ││Order ││Shipping │ │ Webhook │ │
│ │Engine ││Handler ││Manager │ │ Receiver │ │
│ └────┬────┘└───┬────┘└────┬─────┘ └──────────┘ │
│ │ │ │ │
│ ┌────▼─────────▼──────────▼──────────────┐ │
│ │ Smart Pricing Engine │ │
│ │ 相場分析・自動値下げ・売れ筋価格帯提案 │ │
│ └────────────┬────────────────────────────┘ │
│ │ │
│ ┌────────────▼────────────────────────────┐ │
│ │ Customer Communication AI │ │
│ │ 購入者メッセージ・値下げ交渉・Q&A対応 │ │
│ └────────────┬────────────────────────────┘ │
│ │ │
│ ┌────────────▼────────────────────────────┐ │
│ │ Analytics Dashboard │ │
│ │ 売上・閲覧数・いいね数・転換率分析 │ │
│ └────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────────────────┘
```
---
## System Prompt Instructions
You are an agent equipped with **Mercari Shops Agent** for メルカリShops store management. Follow these rules precisely when the user invokes Mercari commands. Always optimize for Mercari's search algorithm, pricing dynamics, and the unique culture of the C2C marketplace.
### Behavioral Guidelines
1. **API認証はWebhook Secretと併せて管理する。** APIキーの有効性を定期的に検証し、Webhook受信用のシークレットキーでリクエストの正当性を検証する。
2. **商品出品はメルカリShopsの出品ガイドラインに厳密に準拠する。** 禁止出品物（偽ブランド品、医薬品、危険物等）のチェックを事前に実行し、違反リスクを排除する。
3. **商品タイトルはメルカリの検索アルゴリズムに最適化する。** 40文字以内で主要キーワードを先頭に配置し、ブランド名・商品特徴・状態を含める。ハッシュタグは商品説明欄で活用する。
4. **価格設定はメルカリ相場を分析して最適化する。** 同カテゴリ・同条件の売切れ商品の販売価格を分析し、売れ筋価格帯を提案する。手数料10%を考慮した利益計算を行う。
5. **商品画像はメルカリの文化に合わせる。** 実物写真が重視されるため、清潔感のある自然光撮影を推奨。最大10枚、1枚目がサムネイルになることを意識した構成を提案する。
6. **らくらくメルカリ便/ゆうゆうメルカリ便を最適に選択する。** 商品サイズ・重量に基づいて最安の配送方法を自動提案する（ネコポス/宅急便コンパクト/宅急便/ゆうパケット等）。
7. **値下げ交渉には定型化された丁寧な対応を行う。** メルカリ文化として値下げ交渉が一般的であるため、ショップポリシーに基づいた返答テンプレートを用意する。
8. **注文処理は出荷期限を厳守する。** メルカリShopsは注文から3-7日以内の発送が求められる。期限管理を自動化し、遅延リスクをアラートする。
9. **売上金の振込申請タイミングを最適化する。** 振込手数料（¥200）を考慮し、売上金が一定額に達したタイミングで振込申請を推奨する。メルペイ残高への自動チャージも案内する。
10. **レビュー評価を維持・向上させる施策を提案する。** 評価4.5以上を目標とし、丁寧な梱包・迅速な発送・メッセージ対応の品質を管理する。
11. **一括出品機能で効率的な商品登録を支援する。** CSVまたはJSONフォーマットでの一括商品登録に対応し、テンプレートを提供する。
12. **メルカリ独自の「いいね」機能を活用する。** いいね数の推移を追跡し、いいね数が多いが売れていない商品には値下げ通知を自動送信する戦略を提案する。
13. **季節性・トレンドに基づく出品タイミングを提案する。** メルカリでの検索トレンドデータを分析し、需要が高まるタイミングでの出品を推奨する。
14. **メルカリShopsの手数料体系を正確に計算する。** 販売手数料10%、振込手数料¥200、各配送方法の送料を考慮した純利益を常に表示する。
15. **ショップページのブランディングを支援する。** ショップ名、ロゴ、ショップ説明文の最適化を提案し、信頼性の高いショップイメージを構築する。
16. **在庫数0の商品はSOLD OUT表示に自動切り替えする。** 在庫管理と連動し、品切れ商品の適切なステータス管理を行う。
### Shipping Cost Reference
メルカリ便の配送料金早見表（出品者負担、全国一律料金）:
**らくらくメルカリ便（ヤマト運輸）:**
| サイズ | 条件 | 料金 |
|--------|------|------|
| ネコポス | A4サイズ、厚さ3cm、1kg以内 | ¥210 |
| 宅急便コンパクト | 専用BOX、厚さ5cm | ¥450 (+専用BOX¥70) |
| 宅急便 60サイズ | 60cm以内、2kg以内 | ¥750 |
| 宅急便 80サイズ | 80cm以内、5kg以内 | ¥850 |
| 宅急便 100サイズ | 100cm以内、10kg以内 | ¥1,050 |
| 宅急便 120サイズ | 120cm以内、15kg以内 | ¥1,200 |
| 宅急便 140サイズ | 140cm以内、20kg以内 | ¥1,450 |
| 宅急便 160サイズ | 160cm以内、25kg以内 | ¥1,700 |
**ゆうゆうメルカリ便（日本郵便）:**
| サイズ | 条件 | 料金 |
|--------|------|------|
| ゆうパケット | A4サイズ、厚さ3cm、1kg以内 | ¥230 |
| ゆうパケットポスト | 専用箱/シール、2kg以内 | ¥215 |
| ゆうパケットプラス | 専用BOX、2kg以内 | ¥455 (+専用BOX¥65) |
| ゆうパック 60サイズ | 60cm以内、25kg以内 | ¥770 |
| ゆうパック 80サイズ | 80cm以内、25kg以内 | ¥870 |
| ゆうパック 100サイズ | 100cm以内、25kg以内 | ¥1,070 |
### Mercari Shops API Endpoint Reference
メルカリShops APIはREST (JSON)形式。APIキー認証を使用。
**商品管理API:**
| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `/v1/items` | 商品出品（新規登録） |
| GET | `/v1/items/{item_id}` | 商品詳細取得 |
| PUT | `/v1/items/{item_id}` | 商品情報更新 |
| DELETE | `/v1/items/{item_id}` | 商品削除（出品取消） |
| GET | `/v1/items` | 商品一覧取得 |
| POST | `/v1/items/bulk` | 一括商品登録 |
| PUT | `/v1/items/{item_id}/stock` | 在庫数更新 |
**注文管理API:**
| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/v1/orders` | 注文一覧取得 |
| GET | `/v1/orders/{order_id}` | 注文詳細取得 |
| POST | `/v1/orders/{order_id}/ship` | 出荷処理（配送手配） |
| POST | `/v1/orders/{order_id}/complete` | 取引完了 |
| POST | `/v1/orders/{order_id}/cancel` | 注文キャンセル |
**配送API:**
| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/v1/shipping/methods` | 利用可能配送方法一覧 |
| POST | `/v1/shipping/label` | 配送ラベル生成 |
| GET | `/v1/shipping/tracking/{order_id}` | 配送追跡情報取得 |
**分析API:**
| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/v1/analytics/sales` | 売上データ取得 |
| GET | `/v1/analytics/items/{item_id}` | 商品別分析（閲覧・いいね・転換率） |
| GET | `/v1/analytics/shop` | ショップ全体分析 |
---
## Environment Variables
| Variable | Description | Required | Default |
|----------|-------------|----------|---------|
| `MERCARI_API_KEY` | メルカリShops APIキー (mcs_で始まる文字列) | Yes | - |
| `MERCARI_SHOP_ID` | ショップID (数値、ショップ管理画面で確認) | Yes | - |
| `MERCARI_WEBHOOK_SECRET` | Webhook検証用シークレットキー (HMAC-SHA256) | Yes | - |
| `MERCARI_WEBHOOK_URL` | Webhook受信エンドポイントURL | No | - |
| `MERCARI_DEFAULT_SHIPPING` | デフォルト配送方法 (rakuraku/yuuyuu) | No | rakuraku |
| `MERCARI_AUTO_PRICE_DOWN` | 自動値下げ機能の有効化 (true/false) | No | false |
| `MERCARI_NOTIFICATION_CHANNEL` | 通知送信先 (discord/lark/slack) | No | - |
API Base: `https://api.mercari-shops.com`
Webhook: HMAC-SHA256署名検証
Authentication: Bearer Token (APIキー)
---
## Commands
### `mercari list [--search <query>] [--status <active|sold|draft>]`
商品一覧を表示します。
```
$ mercari list --status active
╔══════════════════════════════════════════════════════════════════════╗
║ メルカリShops 出品一覧 ║
╠══════════════════════════════════════════════════════════════════════╣
║ 商品ID | 商品名 | 価格 | 在庫 | いいね ║
║───────────┼─────────────────────────────┼─────────┼──────┼─────────║
║ m10234567 | 北海道産 天然はちみつ 500g | ¥2,480 | 34 | 128 ║
║ m10234568 | 有機抹茶パウダー 100g | ¥1,980 | 67 | 84 ║
║ m10234569 | 手作り味噌キット 1kg | ¥3,280 | 12 | 203 ║
║ m10234570 | 国産もち麦 800g | ¥1,380 | 89 | 56 ║
║ m10234571 | 京都宇治ほうじ茶 200g | ¥1,680 | 45 | 92 ║
╠══════════════════════════════════════════════════════════════════════╣
║ 合計: 5件 | 出品中: 5件 | 総いいね: 563 ║
║ [注目] m10234569: いいね203件だが在庫12個 — 値下げ通知で購入促進 ║
╚══════════════════════════════════════════════════════════════════════╝
```
### `mercari inventory [--low-stock] [--export]`
在庫管理と補充アラートを表示します。
```
$ mercari inventory --low-stock
╔══════════════════════════════════════════════════════════════════════╗
║ 在庫アラート (残り10個以下) ║
╠══════════════════════════════════════════════════════════════════════╣
║ 商品ID | 商品名 | 在庫 | 日販 | 残日数 ║
║───────────┼─────────────────────────┼──────┼───────┼────────────────║
║ m10234572 | 有機ドライフルーツ | 3 | 1.2 | 2.5日(緊急) ║
║ m10234569 | 手作り味噌キット 1kg | 8 | 0.8 | 10.0日 ║
║ m10234573 | 天然酵母パンセット | 5 | 0.5 | 10.0日 ║
╠══════════════════════════════════════════════════════════════════════╣
║ [緊急] m10234572: 在庫3個 — 2日以内に補充必要 ║
║ [注意] m10234569: いいね203件の人気商品 — 早めの補充推奨 ║
║ [情報] 品切れ時はSOLD OUT表示に自動切り替え ║
╚══════════════════════════════════════════════════════════════════════╝
```
### `mercari order [--status <new|shipped|completed>] [--id <order-id>]`
注文一覧と詳細を管理します。
```
$ mercari order --status new
╔══════════════════════════════════════════════════════════════════════╗
║ 新規注文一覧 ║
╠══════════════════════════════════════════════════════════════════════╣
║ 注文ID | 注文日 | 商品 | 金額 | 配送 ║
║───────────────┼────────────┼───────────────────┼────────┼───────────║
║ ord-98765001 | 2026-03-01 | はちみつ500g x1 | ¥2,480 | らくらく ║
║ ord-98765002 | 2026-03-01 | 抹茶パウダー x2 | ¥3,960 | ゆうゆう ║
║ ord-98765003 | 2026-02-28 | 味噌キット x1 | ¥3,280 | らくらく ║
╠══════════════════════════════════════════════════════════════════════╣
║ 合計: 3件 | 発送期限: ord-98765003 → 2026-03-03 ║
║ [要対応] ord-98765003: 発送期限まで残り2日 — 優先出荷してください ║
║ ║
║ 推奨配送方法: ║
║ ord-98765001: 宅急便コンパクト ¥450 (60サイズ以内) ║
║ ord-98765002: ゆうパケットプラス ¥455 (2kg以内) ║
║ ord-98765003: 宅急便 60サイズ ¥750 (味噌キットは重量あり) ║
╚══════════════════════════════════════════════════════════════════════╝
```
### `mercari shipping [--order <order-id>] [--method <rakuraku|yuuyuu>]`
配送手配と追跡を管理します。
```
$ mercari shipping --order ord-98765001
╔══════════════════════════════════════════════════════════════════════╗
║ 配送手配 — ord-98765001 ║
╠══════════════════════════════════════════════════════════════════════╣
║ 注文ID: ord-98765001 ║
║ 商品: 北海道産 天然はちみつ 500g ║
║ 購入者: ****様 (評価★4.8) ║
║ ║
║ 配送方法の比較: ║
║ ┌──────────────────────┬────────┬───────┬────────────────────┐ ║
║ │ 方法 │ 料金 │ 日数 │ 追跡・補償 │ ║
║ ├──────────────────────┼────────┼───────┼────────────────────┤ ║
║ │ ネコポス │ ¥210 │ 1-2日 │ 追跡○ 補償○(税込) │ ║
║ │ 宅急便コンパクト │ ¥450 │ 1-2日 │ 追跡○ 補償○ │ ║
║ │ ゆうパケット │ ¥230 │ 2-3日 │ 追跡○ 補償× │ ║
║ │ ゆうパケットポスト │ ¥215 │ 2-3日 │ 追跡○ 補償× │ ║
║ └──────────────────────┴────────┴───────┴────────────────────┘ ║
║ ║
║ [推奨] 宅急便コンパクト(¥450) — ガラス瓶のため緩衝材+補償付きが安心 ║
║ [代替] ゆうパケットプラス(¥455) — 郵便局持込なら集荷不要 ║
╚══════════════════════════════════════════════════════════════════════╝
```
### `mercari review [--rating <1-5>] [--period <week|month>]`
購入者評価とフィードバックを分析します。
```
$ mercari review --period month
╔══════════════════════════════════════════════════════════════════════╗
║ ショップ評価分析 — 2026年2月 ║
╠══════════════════════════════════════════════════════════════════════╣
║ 総評価数: 847件 | 平均評価: ★4.7 | 今月新規: 62件 ║
║ ║
║ 評価分布 (今月): ║
║ 良かった: ████████████████████████ 89% (55件) ║
║ 普通: ████ 8% (5件) ║
║ 残念だった:█ 3% (2件) ║
║ ║
║ 好評コメント: ║
║ 「丁寧な梱包でした」(18件) 「迅速な対応ありがとうございます」(12件)║
║ 「商品の品質が良い」(9件) 「また利用したいです」(8件) ║
║ ║
║ 改善コメント: ║
║ 「発送まで少し時間がかかった」(1件) ║
║ 「写真と色味が若干異なった」(1件) ║
║ ║
║ [提案] 発送速度を改善 → 注文翌日出荷を目標に ║
║ [提案] 商品写真に自然光撮影を追加して色味の差を軽減 ║
╚══════════════════════════════════════════════════════════════════════╝
```
### `mercari analytics [--period <day|week|month>] [--item <item-id>]`
売上・閲覧数・いいね数の分析を表示します。
```
$ mercari analytics --period month
╔══════════════════════════════════════════════════════════════════════╗
║ メルカリShops 月次レポート — 2026年2月 ║
╠══════════════════════════════════════════════════════════════════════╣
║ 売上合計: ¥1,247,800 (前月比 +28.3%) ║
║ 手数料(10%): ¥124,780 ║
║ 配送費合計: ¥87,400 ║
║ 純利益: ¥628,420 (利益率 50.4%) ║
║ ║
║ 注文件数: 312件 (前月比 +24.2%) ║
║ 客単価: ¥3,999 (前月比 +3.3%) ║
║ 閲覧数: 42,800PV (前月比 +31.2%) ║
║ いいね数: 1,847件 (前月比 +18.6%) ║
║ 転換率: 0.73% (前月比 +0.04pt) ║
║ ║
║ 売上TOP3: ║
║ 1. 手作り味噌キット 1kg ¥285,600 (87件) 転換率1.1% ║
║ 2. 北海道産 天然はちみつ ¥223,200 (90件) 転換率0.9% ║
║ 3. 有機抹茶パウダー 100g ¥178,200 (90件) 転換率0.8% ║
║ ║
║ [トレンド] 味噌キットが前月比+45% — 春の手作り需要 ║
║ [提案] もち麦のいいね数増加中 → タイムセール活用で転換率向上 ║
╚══════════════════════════════════════════════════════════════════════╝
```
### `mercari bulk-list [--file <csv|json>] [--template]`
一括商品出品を行います。
```
$ mercari bulk-list --file products.csv
╔══════════════════════════════════════════════════════════════════════╗
║ 一括出品処理 ║
╠══════════════════════════════════════════════════════════════════════╣
║ ファイル: products.csv ║
║ 総商品数: 25件 ║
║ ║
║ バリデーション結果: ║
║ 成功: 23件 ║
║ 警告: 1件 (商品名が40文字超過 → 自動トリミング) ║
║ エラー: 1件 (カテゴリコード不正 → 行15: "cat-999") ║
║ ║
║ 処理状況: ║
║ ████████████████████████████░░ 92% (23/25件) ║
║ ║
║ 出品完了: 23件 ║
║ スキップ: 1件 (カテゴリコード修正後に再実行してください) ║
║ 警告修正: 1件 (商品名を40文字にトリミング済み) ║
║ ║
║ [次のステップ] エラー商品の修正: mercari list --status draft ║
╚══════════════════════════════════════════════════════════════════════╝
```
### `mercari price [--item <item-id>] [--strategy <market|quick-sell|premium>]`
価格分析と最適価格を提案します。
```
$ mercari price --item m10234567 --strategy market
╔══════════════════════════════════════════════════════════════════════╗
║ 価格分析 — m10234567 (北海道産 天然はちみつ 500g) ║
╠══════════════════════════════════════════════════════════════════════╣
║ 現在価格: ¥2,480 ║
║ ║
║ メルカリ相場分析 (直近30日の売切れ商品): ║
║ 検索: 「天然はちみつ 500g 国産」 ║
║ 中央値: ¥2,380 ║
║ 平均値: ¥2,520 ║
║ 最安値: ¥1,680 ║
║ 最高値: ¥3,980 ║
║ 売れ筋帯: ¥2,000 - ¥2,800 (全体の68%) ║
║ ║
║ 利益計算 (現在価格¥2,480): ║
║ 販売手数料 (10%): ¥248 ║
║ 配送料 (宅急便): ¥750 ║
║ 原価: ¥800 ║
║ ───────────────────────── ║
║ 純利益: ¥682 (利益率 27.5%) ║
║ ║
║ [推奨] 現在価格¥2,480は売れ筋帯の中間で適正 ║
║ [代替] ¥2,280に値下げ → いいね通知が128人に送信され、販売加速見込み ║
╚══════════════════════════════════════════════════════════════════════╝
```
---
## Workflow Diagram
```
┌─────────────────────────────────────────────────────────────────────┐
│ メルカリShops 日次運用ワークフロー │
│ │
│ 08:00 ┌──────────────────────────────────────────────┐ │
│ │ 1. 新規注文の確認・処理 │ │
│ │ └─ 新規注文の一覧チェック │ │
│ │ └─ 配送方法の最適選択 │ │
│ │ └─ 配送ラベルの生成 │ │
│ │ └─ 梱包・出荷作業 │ │
│ └──────────────────┬───────────────────────────┘ │
│ ▼ │
│ 10:00 ┌──────────────────────────────────────────────┐ │
│ │ 2. 在庫管理 │ │
│ │ └─ 低在庫商品の確認 │ │
│ │ └─ 品切れ商品のSOLD OUT切替 │ │
│ │ └─ 入荷商品の在庫数更新 │ │
│ └──────────────────┬───────────────────────────┘ │
│ ▼ │
│ 12:00 ┌──────────────────────────────────────────────┐ │
│ │ 3. メッセージ・評価対応 │ │
│ │ └─ 購入者からの質問回答 │ │
│ │ └─ 値下げ交渉への対応 │ │
│ │ └─ 取引完了後の評価確認 │ │
│ └──────────────────┬───────────────────────────┘ │
│ ▼ │
│ 15:00 ┌──────────────────────────────────────────────┐ │
│ │ 4. 出品最適化 │ │
│ │ └─ いいね数の多い商品の価格見直し │ │
│ │ └─ 長期売れ残り商品のリフレッシュ │ │
│ │ └─ 新商品の出品 │ │
│ │ └─ 商品写真の追加・差替え │ │
│ └──────────────────┬───────────────────────────┘ │
│ ▼ │
│ 18:00 ┌──────────────────────────────────────────────┐ │
│ │ 5. 日次分析 │ │
│ │ └─ 売上・閲覧・いいね数サマリー │ │
│ │ └─ 転換率の確認 │ │
│ │ └─ 配送完了の確認 │ │
│ │ └─ 翌日のアクション整理 │ │
│ └──────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────┘
```
---
## Error Handling
| Error Code | Meaning | Agent Action |
|------------|---------|--------------|
| `AUTH_INVALID` | APIキーが無効または期限切れ | APIキーの再発行を案内。ショップ管理画面でのキー確認手順を表示 |
| `ITEM_VIOLATION` | 出品ガイドライン違反 | 違反理由を特定し、修正方法を具体的に案内 |
| `ITEM_NOT_FOUND` | 指定商品IDが存在しない | 商品IDの確認を促し、一覧から正しいIDを提示 |
| `STOCK_ZERO` | 在庫0の商品への操作 | SOLD OUT状態であることを通知。在庫補充後に再操作を案内 |
| `ORDER_EXPIRED` | 出荷期限超過 | ペナルティリスクを警告し、即時出荷または購入者への連絡を促す |
| `SHIPPING_OVERSIZE` | 配送サイズ超過 | 別の配送方法を提案。梱包の見直しを案内 |
| `WEBHOOK_INVALID` | Webhook署名検証失敗 | Webhook Secretの再設定を案内 |
| `RATE_LIMIT` | API呼び出し制限超過 | 指数バックオフで自動リトライ（最大30秒） |
| `IMAGE_FORMAT` | 画像フォーマット不正 | 対応フォーマット(JPEG/PNG)への変換を実行 |
| `BULK_PARTIAL` | 一括処理の部分失敗 | 成功/失敗の内訳を表示し、失敗分の修正案を提示 |
---
## FAQ
**Q: メルカリShopsの手数料はいくら？**
A: 販売手数料は売上の10%です。加えて、振込手数料が1回¥200かかります。配送料は配送方法によって異なります（ネコポス¥210、宅急便コンパクト¥450、宅急便60サイズ¥750等）。`mercari price` で全費用込みの純利益を計算できます。
**Q: らくらくメルカリ便とゆうゆうメルカリ便の違いは？**
A: らくらくメルカリ便はヤマト運輸、ゆうゆうメルカリ便は日本郵便が配送します。コンビニ受取が必要な場合はゆうゆうメルカリ便、集荷サービスが必要な場合はらくらくメルカリ便が適しています。`mercari shipping` で最適な方法を自動提案します。
**Q: メルカリShopsとメルカリ個人出品の違いは？**
A: メルカリShopsは法人・個人事業主向けで、在庫管理、複数配送先、ショップページのブランディングが可能です。個人出品は1点もの中心ですが、Shopsは同一商品の複数在庫管理ができます。
**Q: いいね数が多いのに売れない場合の対策は？**
A: `mercari price --strategy quick-sell` で値下げ分析を行います。メルカリでは値下げするといいねしたユーザーに通知が届くため、¥100-300程度の値下げが効果的です。商品説明の見直しや写真の追加も転換率向上に寄与します。
**Q: 値下げ交渉への対応ポリシーは？**
A: ショップ設定で「値下げ不可」「○%まで対応可」「個別相談」を選択できます。エージェントは設定に基づいて自動返答を生成します。例:「お問い合わせありがとうございます。当ショップでは表示価格でのご提供となります。ご了承くださいませ。」
**Q: 売上金の振込タイミングは？**
A: 毎月末締め、翌月10日振込が基本です。申請振込（手数料¥200）で任意タイミングでの振込も可能です。`mercari analytics` で売上金残高を確認し、メルペイ残高への自動チャージも設定できます。
**Q: 出品禁止商品にはどんなものがある？**
A: 偽ブランド品、医薬品、危険物、チケット、現金・金券、アダルト商品等が禁止されています。`mercari list --check-compliance` で出品前にガイドライン適合チェックを行えます。
**Q: 一括出品のCSVフォーマットは？**
A: `mercari bulk-list --template` でテンプレートCSVをダウンロードできます。必須列: 商品名、価格、カテゴリコード、商品説明、在庫数、配送方法、商品状態。画像はURL指定での登録に対応しています。
**Q: 他のECプラットフォームとの在庫連動は？**
A: Amazon Japan Seller、Rakuten Seller、Yahoo Shopping Agentスキルと併用することで、在庫同期が可能です。`mercari sync --enable` で在庫引当を自動化します。
**Q: ショップの評価を上げるにはどうすれば？**
A: 迅速な発送（注文翌日出荷が理想）、丁寧な梱包（緩衝材+お礼メッセージカード）、素早いメッセージ返信が3大要素です。`mercari review` で改善ポイントを分析し、具体的なアクションを提案します。
**Q: タイムセール機能は使える？**
A: メルカリShopsのタイムセール機能に対応しています。`mercari price --strategy quick-sell` で期間限定の値下げ設定が可能です。セール開始時にいいねユーザーへ自動通知が送られ、購入率が通常の3-5倍に向上します。
**Q: メルカリShopsでの売上を伸ばすコツは？**
A: 主なポイントは3つです。(1)商品写真は自然光で10枚フル活用し、1枚目のサムネイルにこだわる。(2)検索されやすい商品名（ブランド名+商品特徴+状態）を40文字以内で設定する。(3)値下げタイミングを戦略的に活用し、いいねユーザーへの通知を最大化する。`mercari analytics` で各施策の効果を測定できます。
**Q: メルカリ便の配送トラブル時の対応は？**
A: 配送トラブル（紛失・破損）はメルカリのあんしん補償でカバーされます。らくらくメルカリ便とゆうゆうメルカリ便はいずれも補償付きです。`mercari order --trouble` でトラブル報告の手順を案内し、メルカリ事務局への問い合わせをサポートします。
**Q: 商品のカテゴリ設定で注意すべき点は？**
A: 正確なカテゴリ設定は検索表示に大きく影響します。メルカリは独自のカテゴリツリーを使用しており、`mercari list --categories` で利用可能なカテゴリ一覧を確認できます。複数カテゴリに該当する場合は、検索ボリュームの大きいカテゴリを優先します。
### Smart Pricing Workflow
メルカリの相場データを分析し、最適な価格戦略を提案するワークフロー:
```
┌───────────────────────────────────────────────────┐
│ スマート価格設定ワークフロー │
│ │
│ Step 1: 相場調査 │
│ └─ 同一カテゴリの売切れ商品価格を収集 │
│ └─ 直近30日の取引価格の中央値・平均値算出 │
│ └─ 売れ筋価格帯の特定 │
│ │
│ Step 2: コスト計算 │
│ └─ 仕入原価の入力 │
│ └─ 販売手数料(10%)の自動計算 │
│ └─ 配送料の自動計算（サイズ別） │
│ └─ 梱包材費用の加算 │
│ │
│ Step 3: 価格戦略の選択 │
│ └─ market: 相場中央値で安定販売 │
│ └─ quick-sell: 相場下限で即時販売 │
│ └─ premium: 付加価値で相場上限を狙う │
│ │
│ Step 4: いいね数連動の値下げ計画 │
│ └─ いいね50以上で値下げ未実施 → ¥100値下げ推奨 │
│ └─ 出品7日経過+いいね20以上 → ¥200値下げ推奨 │
│ └─ 出品14日経過 → リフレッシュ再出品推奨 │
└───────────────────────────────────────────────────┘
```
---
## Data Storage
```
.mercari-shops/
├── config.json # API認証情報とショップ設定
├── cache/
│ ├── items.json # 商品キャッシュ (TTL: 15m)
│ ├── categories.json # カテゴリマスタ (TTL: 24h)
│ ├── shipping-rates.json # 配送料金テーブル (TTL: 7d)
│ └── market-prices/
│ └── {keyword}.json # 相場データ (TTL: 6h)
├── analytics/
│ ├── daily-sales.jsonl # 日次売上データ
│ ├── item-performance.jsonl # 商品別パフォーマンス
│ ├── likes-tracking.jsonl # いいね数推移
│ ├── conversion-rates.jsonl # 転換率データ
│ └── monthly-reports/
│ └── 2026-02.json # 月次レポート
├── orders/
│ ├── pending-shipment.json # 出荷待ち注文
│ ├── shipping-labels/
│ │ └── {order-id}.pdf # 配送ラベル
│ └── completed.jsonl # 完了注文履歴
├── reviews/
│ ├── all-reviews.jsonl # 全評価データ
│ ├── response-templates.json # 返信テンプレート
│ └── sentiment.json # 評価傾向分析
├── messages/
│ ├── auto-replies.json # 自動返信設定
│ └── negotiation-log.jsonl # 値下げ交渉履歴
├── bulk/
│ ├── templates/
│ │ └── products.csv # 一括出品テンプレート
│ └── history/
│ └── {timestamp}.json # 一括処理履歴
├── exports/
│ └── *.csv # エクスポートファイル
└── logs/
├── api-calls.jsonl # API呼び出しログ
├── webhooks.jsonl # Webhook受信ログ
└── errors.jsonl # エラーログ
```
---
## Comparison Table
| Feature | Mercari Shops Agent | BASE | STORES | minne |
|---------|-------------------|------|--------|-------|
| 対象プラットフォーム | メルカリShops | BASE | STORES | minne |
| ユーザーベース | **2,300万MAU** | 200万ショップ | 100万ショップ | 1,300万ユーザー |
| 出店費用 | **無料(手数料10%)** | 無料(手数料6.6%+40) | 無料(手数料5%) | 無料(手数料10.56%) |
| API連携 | **完全対応** | 基本対応 | 基本対応 | 限定的 |
| 在庫管理 | **販売速度予測付き** | 基本在庫管理 | 基本在庫管理 | 基本在庫管理 |
| 配送管理 | **メルカリ便自動最適化** | 独自配送 | 独自配送 | 独自配送 |
| 匿名配送 | **対応(メルカリ便)** | 非対応 | 非対応 | 非対応 |
| 価格分析 | **相場分析+値下げ戦略** | 非対応 | 非対応 | 非対応 |
| レビュー管理 | **AI分析+改善提案** | 基本対応 | 基本対応 | 基本対応 |
| いいね分析 | **通知戦略最適化** | 非対応 | 非対応 | お気に入り |
| 一括出品 | **CSV/JSON対応** | CSV対応 | CSV対応 | CSV対応 |
| 顧客コミュニケーション | **AI自動対応** | 手動 | 手動 | 手動 |
| 売上振込 | 月1回(申請随時) | 月1回(¥750) | 月1回(¥275) | 月1回(¥220) |
| AI搭載 | **Claude Code統合** | 非対応 | 非対応 | 非対応 |
| CLI操作 | **完全対応** | Web UI | Web UI | Web UI |
| C2C文化対応 | **値下げ交渉AI対応** | 非対応 | 非対応 | 非対応 |
---
## メルカリShops Specific Features
- メルカリShops API完全対応
- らくらくメルカリ便（ヤマト運輸）自動選択
- ゆうゆうメルカリ便（日本郵便）自動選択
- 匿名配送対応（出品者・購入者の個人情報保護）
- メルカリ相場分析（売切れ商品の価格帯分析）
- いいね数追跡と値下げ通知戦略
- 値下げ交渉の自動対応（ショップポリシー準拠）
- 一括出品（CSV/JSON）
- 配送ラベル自動生成
- タイムセール機能
- メルペイ残高管理
- ショップページブランディング最適化
- 商品写真の最適構成提案（10枚構成）
- 出品ガイドラインコンプライアンスチェック
- 取引メッセージAI生成
- 評価維持・向上施策の自動提案