NinjabuyのロゴBusiness
営業に問い合わせる

開発者

AIアシスタント（MCP）

Claude、ChatGPT、CursorをNinjaBuyアカウントに接続し、普通の言葉で質問しましょう：注文はどこか、棚に何があるか、その出品は販売する価値があるか。そしてストアに出品できます。
このページの内容
  1. 1接続
  2. 2ログインとアクセス
  3. 3ここではお金は使われません
  4. 4ツール
  5. 5確認すること

接続

すべてのアシスタントで1つのサーバーアドレス。NinjaBuyアカウントでログインし、貼り付けるキーはありません。

https://www.ninjabuy.com/mcp

Claude

  1. 設定 › コネクタを開き、カスタムコネクタを追加を選びます。
  2. 上のアドレスを貼り付けて追加します。
  3. NinjaBuyの電話番号でログインし、アクセスを許可を選びます。

ChatGPT

  1. 設定で開発者モードをオンにし、カスタムMCPサーバーを追加します。
  2. 上のアドレスを貼り付け、ログイン方法にOAuthを選びます。
  3. NinjaBuyの電話番号でログインし、アクセスを許可を選びます。

Cursor

Cursor Settings › MCP、または~/.cursor/mcp.jsonにサーバーを追加します。初回はCursorがブラウザでNinjaBuyのログインを開きます。

~/.cursor/mcp.json
{
  "mcpServers": {
    "ninjabuy": {
      "url": "https://www.ninjabuy.com/mcp"
    }
  }
}

Claude Codeなどのコマンドラインアシスタント

ターミナル
claude mcp add --transport http ninjabuy https://www.ninjabuy.com/mcp

メニュー名はアシスタントの更新で変わります。「カスタムコネクタ」や「カスタムMCPサーバー」を探してください。

ログインとアクセス

アシスタントはOAuth 2.1でログインします：自身を登録し、あなたをninjabuy.comに送り、あなたは当社の画面で承認します。その画面にはアプリ名と戻り先が表示されます。今接続を依頼したアプリだけを許可してください。各アプリの承認は一度だけです。

  • あなたのアカウントとして動作します。ツールはアカウントIDを取らず、あなたの注文、棚、商品だけを参照します。
  • アクセスは1時間有効で、7日間自動更新されます。その後、アシスタントが再ログインを求めます。
  • 接続を解除するには、アシスタントでコネクタを削除してください。
  • マーケットプレイスを読み取るツール（product、analyze_product、import_product、push_to_shopify）は、APIの1分あたり30回の枠を共有します：レート制限。

ここではお金は使われません

支払い、発送の手配、残高の使用を行うツールはありません。支払いが必要な場合は、それを行うページを応答で示します：カートからのチェックアウト、倉庫ページからの発送。push_to_shopifyは商品を下書きとして出品するので、公開するまで販売は始まりません。

ツール

すべての応答に requestId（お問い合わせ時に記載してください）と warnings（呼び出しは止めなかったが知っておくべきこと）が含まれます。長い応答は約6,000トークンで truncated: true として切り詰められるので、リストでは小さい limit を使ってください。

ツール機能
list_ordersNinjaBuyの注文を一覧表示
orderNinjaBuyの注文1件
warehouseNinjaBuy倉庫の自分の在庫
product商品のバリエーションを読み取る
add_to_cartNinjaBuyのカートに追加
search_products商品を検索
analyze_product商品を分析
import_product商品をインポート
push_to_shopifyShopifyに送信
list_synced_products同期中の商品を一覧表示
set_sync_rule同期ルールを設定

list_orders読み取り専用

アカウントの注文（新しい順）：ステータス、支払いステータス、未払い額、商品、各注文のページ。has_more が true の間は cursor をたどってください。

cursorstring?
前の応答から取得。最初のページでは省略します。
limitnumber?
1〜25。省略時は25。
list_ordersの応答
{
  "orders": [
    {
      "id": "j57a9x2b",
      "number": 1012,
      "kind": "procurement",
      "total": "¥57.00",
      "orderStatus": { "status": "ordered" },
      "paymentStatus": { "status": "paid" },
      "amountDue": null,
      "itemCount": 1,
      "items": [
        {
          "id": "P1012-1",
          "title": "Heavyweight washed hoodie",
          "quantity": 1,
          "options": ["Black", "M"],
          "status": "ordered"
        }
      ],
      "url": "https://www.ninjabuy.com/me/orders/j57a9x2b"
    }
  ],
  "cursor": "eyJvIjoyNX0",
  "has_more": true,
  "requestId": "5f7c2a1e-3b8d-4c61-9a0f-2e4d6b8c1a37",
  "warnings": []
}

order読み取り専用

IDで指定した注文1件：明細と価格、各商品のステータスと到着数、追跡付きの発送。このアカウントのものでないIDでは order は null です。

idstring必須
list_ordersで取得したID。
orderの応答
{
  "order": {
    "id": "j57c4k1m",
    "number": 1019,
    "kind": "shipout",
    "orderStatus": { "status": "ready" },
    "paymentStatus": { "status": "paid" },
    "shipment": {
      "state": "shipped",
      "destinationCountry": "US",
      "weightGrams": 176,
      "trackingNumbers": ["YT2630812345678"],
      "shippedAt": 1793685600000
    },
    "url": "https://www.ninjabuy.com/me/orders/j57c4k1m"
  },
  "requestId": "5f7c2a1e-3b8d-4c61-9a0f-2e4d6b8c1a37",
  "warnings": []
}

warehouse読み取り専用

当社倉庫に到着したすべてのもの：写真、到着数、発送可能数または発送中の数、重さ、申告価格、支払い済みかどうか、無料保管の終了日。

入力なし。

warehouseの応答
{
  "items": [
    {
      "id": "P1012-1",
      "order": 1012,
      "title": "Heavyweight washed hoodie",
      "photos": [
        {
          "type": "image",
          "url": "https://media.ninjabuy.com/qc/P1012-1/1.webp"
        }
      ],
      "received": 1,
      "availableToShip": 1,
      "inShipment": 0,
      "unitWeightGrams": 176,
      "declaredUnitValue": "¥38.00",
      "paid": true,
      "freeStorageUntil": "2026-12-02T03:20:11.000Z"
    }
  ],
  "warehouseUrl": "https://www.ninjabuy.com/me/warehouse",
  "requestId": "5f7c2a1e-3b8d-4c61-9a0f-2e4d6b8c1a37",
  "warnings": []
}

product読み取り専用

あらゆる商品リンク（Taobao、Tmall、Weidian、1688、他の購入代行サービスのリンクや短縮リンク、NinjaBuyの商品ページ）から出品を読み取ります：タイトル、画像、出品者、そしてskuId、ラベル、CN¥価格、在庫付きのすべてのバリエーション。

linkstring必須
商品リンク（最大2,048文字）。
productの応答
{
  "product": {
    "handle": "weidian-7750970856",
    "title": "重磅水洗连帽卫衣",
    "seller": "Ruoyi Studio",
    "variants": [
      {
        "skuId": "5187209554",
        "label": "Black / M",
        "priceMinor": 3800,
        "price": "¥38.00",
        "inStock": true
      },
      {
        "skuId": "5187209555",
        "label": "Black / L",
        "priceMinor": 3800,
        "price": "¥38.00",
        "inStock": false
      }
    ],
    "url": "https://www.ninjabuy.com/products/weidian-7750970856"
  },
  "requestId": "5f7c2a1e-3b8d-4c61-9a0f-2e4d6b8c1a37",
  "warnings": []
}

add_to_cart書き込み

1つの出品のバリエーションをカートに追加し、先に仕入れて棚に置けるようにします。何も購入されません。応答はカートページで、そこでチェックアウトします。

handlestring必須
product から。
lines{ skuId, quantity }[]必須
1〜100明細、数量は1〜9,999。すでにカートにあるバリエーションは数量が加算されます。
add_to_cartの応答
{
  "added": 1,
  "cartUrl": "https://www.ninjabuy.com/cart",
  "requestId": "5f7c2a1e-3b8d-4c61-9a0f-2e4d6b8c1a37",
  "warnings": []
}

search_products読み取り専用

Taobaoまたは1688のキーワード検索。ninjabuy.comと同じ検索です。リンクを貼り付けるとその商品を返します。

querystring必須
2〜120文字、またはリンク。
providerstring?
taobao または 1688。省略時は taobao。
pagenumber?
0〜20。
search_productsの応答
{
  "kind": "products",
  "products": [
    {
      "handle": "taobao-781204556120",
      "title": "Heavyweight cotton hoodie, washed",
      "price": { "amount": "45.00", "currency": "CNY" },
      "marketplace": "taobao",
      "url": "https://www.ninjabuy.com/products/taobao-781204556120"
    }
  ],
  "page": 0,
  "totalCount": 1840,
  "requestId": "5f7c2a1e-3b8d-4c61-9a0f-2e4d6b8c1a37",
  "warnings": []
}

analyze_product読み取り専用

各バリエーションの1回の販売で購入者の玄関に届くまでのコストと、マーケットプレイスで利益を維持する価格。何も保存されません。数値はインポートの分析と同じです。

linkstring必須
商品リンク。
weight_gnumber必須
1個の梱包後の重さ（グラム）。
ship_tostring?
国（2文字）。省略時は US。
lanestring?
saver または fast。
marketplacestring?
ebay、shopify、amazon、tiktok のいずれか。
margin_percentnumber?
目標利益率。省略時は30。
analyze_productの応答
{
  "title": "重磅水洗连帽卫衣",
  "shipTo": "US",
  "marketplace": "ebay",
  "brandHint": null,
  "variants": [
    {
      "sku": "5187209554",
      "label": "Black / M",
      "inStock": true,
      "procurement": "57.00",
      "parcel": "134.52",
      "landedUsd": "27.71",
      "suggestedPrice": "49.99",
      "marginPercent": "30.16"
    }
  ],
  "requestId": "5f7c2a1e-3b8d-4c61-9a0f-2e4d6b8c1a37",
  "warnings": []
}

import_product書き込み

Imports APIと同様に、分析付きで出品をインポートします。無料。送信や再計算に使うインポートを返します。

linkstring必須
商品リンクまたはおすすめ商品シート。
weight_gnumber必須
1個の梱包後の重さ（グラム）。
ship_tostring?
国（2文字）。省略時は US。
lanestring?
saver または fast。
marketplacestring?
ebay、shopify、amazon、tiktok のいずれか。
margin_percentnumber?
目標利益率。省略時は30。
import_productの応答
{
  "import": {
    "id": "imp_2c9d",
    "status": "ready",
    "title": "重磅水洗连帽卫衣",
    "variants": 6,
    "inStock": 5
  },
  "requestId": "5f7c2a1e-3b8d-4c61-9a0f-2e4d6b8c1a37",
  "warnings": []
}

push_to_shopify書き込み

インポートを商品として保存し、Fulfilled by NinjaBuy拠点に在庫を置いた下書きとしてShopifyストアに出品します。再送信すると更新されます。ルールはShopifyに送信と同じです。

import_idstring必須
import_product から。
variants{ sku, price }[]?
残すものとそのUS$価格。省略時は在庫のあるものを推奨価格で。
titlestring?
あなたのタイトル。
shopstring?
複数のストアを連携している場合に必要です。
push_to_shopifyの応答
{
  "product": "prd_8f2k",
  "shopify": {
    "status": "draft",
    "variants": 5,
    "adminUrl": "https://admin.shopify.com/store/acme-goods/products/8812042"
  },
  "skipped": [{ "sku": "5187209555", "reason": "sold_out" }],
  "requestId": "5f7c2a1e-3b8d-4c61-9a0f-2e4d6b8c1a37",
  "warnings": []
}

list_synced_products読み取り専用

最終チェック、コストの変化、在庫付きのあなたの商品。何が動いたかがわかります。

statusstring?
active または paused。
changed_sincestring?
日付：それ以降にコストまたは在庫が変わった商品のみ。
cursorstring?
前の応答から取得。最初のページでは省略します。
limitnumber?
1〜25。省略時は25。
list_synced_productsの応答
{
  "products": [
    {
      "id": "prd_1x0a",
      "title": "Canvas Tote",
      "status": "active",
      "lastCheckedAt": "2026-11-04T02:10:00Z",
      "costChange": {
        "from": "¥42.00",
        "to": "¥48.00",
        "action": "repriced",
        "price": { "from": "$18.99", "to": "$20.99" }
      }
    }
  ],
  "cursor": null,
  "has_more": false,
  "requestId": "5f7c2a1e-3b8d-4c61-9a0f-2e4d6b8c1a37",
  "warnings": []
}

set_sync_rule書き込み

出品者が値上げしたときの対応：利益を維持するよう価格変更、一時停止、または通知のみ。全商品または1商品に。フィールドは同期ルールと同じです。

applies_tostring必須
all、または商品ID。
on_cost_increasestring必須
価格変更、一時停止、または通知。
keep_margin_percentnumber?
reprice の場合。
max_increase_percentnumber?
reprice の場合：これを超えたら一時停止。
set_sync_ruleの応答
{
  "rule": {
    "id": "rule_default",
    "appliesTo": "all",
    "onCostIncrease": {
      "action": "reprice",
      "keepMarginPercent": 40,
      "maxIncreasePercent": 15
    }
  },
  "requestId": "5f7c2a1e-3b8d-4c61-9a0f-2e4d6b8c1a37",
  "warnings": []
}

確認すること

まだ出品者を待っている注文はどれ？

list_orders

2件です：#1012（ウォッシュ加工のパーカー、11月1日購入）と#1015（キャンバストート2個）。どちらも支払い済みで出品者に注文済み。まだどちらも倉庫に届いていません。

このパーカーはeBayで売る価値ある？ weidian.com/item.html?itemID=7750970856、梱包後約180 g。

analyze_product

米国への1回の販売は総コストCN¥191.52、約$27.71です。$49.99ならeBayが約$7.20を取り、あなたの手元に$15.08、利益率30%です。Black / L は売り切れ。タイトルにブランド名はありません。

いいね。Black / M を$49.99でShopifyに出して。タイトルは「Heavyweight Washed Hoodie」で。

import_productpush_to_shopify

完了：acme-goods.myshopify.comに下書きとして作成しました。バリエーション1つ、在庫はFulfilled by NinjaBuyです。写真を確認してから、Shopifyで公開してください。

全商品で利益率40%を維持。ただし一度に15%を超えて値上げしない。

set_sync_rule

全商品に設定。15%を超える値上げなら代わりに商品を一時停止し、list_synced_products で確認できます。