Developers

Βοηθοί AI (MCP)

Συνδέστε Claude, ChatGPT ή Cursor στον λογαριασμό σας NinjaBuy και ρωτήστε με απλά λόγια: πού είναι μια παραγγελία, τι υπάρχει στο ράφι σας, αν αξίζει να πουλήσετε μια καταχώριση, και βάλτε τη στο κατάστημά σας.

Σε αυτή τη σελίδα

1Σύνδεση
2Σύνδεση και πρόσβαση
3Τίποτα εδώ δεν ξοδεύει χρήματα
4Εργαλεία
5Τι να ρωτήσετε

Σύνδεση

Μία διεύθυνση server για κάθε βοηθό. Συνδέεστε με τον λογαριασμό σας NinjaBuy· δεν υπάρχει κλειδί για επικόλληση.

https://www.ninjabuy.com/mcp

Claude

Ανοίξτε Settings › Connectors και επιλέξτε Add custom connector.
Επικολλήστε την παραπάνω διεύθυνση και προσθέστε τη.
Συνδεθείτε με τον αριθμό τηλεφώνου σας στο NinjaBuy και μετά επιλέξτε Allow access.

ChatGPT

Ενεργοποιήστε το developer mode στις Settings και μετά προσθέστε custom MCP server.
Επικολλήστε την παραπάνω διεύθυνση και επιλέξτε OAuth για τη σύνδεση.
Συνδεθείτε με τον αριθμό τηλεφώνου σας στο NinjaBuy και μετά επιλέξτε Allow access.

Cursor

Προσθέστε τον server στο Cursor Settings › MCP ή στο ~/.cursor/mcp.json. Την πρώτη φορά το Cursor ανοίγει τη σύνδεση NinjaBuy στον browser σας.

~/.cursor/mcp.json

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

Claude Code και άλλοι βοηθοί γραμμής εντολών

Τερματικό

claude mcp add --transport http ninjabuy https://www.ninjabuy.com/mcp

Τα ονόματα των μενού αλλάζουν καθώς ενημερώνονται οι βοηθοί· ψάξτε για «custom connector» ή «custom MCP server».

Ο βοηθός συνδέεται με OAuth 2.1: εγγράφεται μόνος του, σας στέλνει στο ninjabuy.com και τον εγκρίνετε στη δική μας οθόνη, που αναφέρει την εφαρμογή και πού θα σας επιστρέψει. Εγκρίνετε μόνο μια εφαρμογή που μόλις ζητήσατε να συνδέσετε. Εγκρίνετε κάθε εφαρμογή μία φορά.

Ενεργεί ως ο λογαριασμός σας: τα εργαλεία δεν παίρνουν id λογαριασμού και βλέπουν μόνο τις δικές σας παραγγελίες, ράφι και προϊόντα.
Η πρόσβαση διαρκεί μία ώρα και ανανεώνεται για επτά ημέρες· μετά ο βοηθός σάς ζητά να συνδεθείτε ξανά.
Αφαιρέστε τον connector από τον βοηθό σας για να τον αποσυνδέσετε.
Τα εργαλεία που διαβάζουν μια πλατφόρμα (product, analyze_product, import_product, push_to_shopify) μοιράζονται το παράθυρο των 30 ανά λεπτό του API: Όρια ρυθμού.

Τίποτα εδώ δεν ξοδεύει χρήματα

Κανένα εργαλείο δεν πληρώνει, δεν κάνει αποστολή και δεν ξοδεύει το υπόλοιπό σας. Όταν κάτι χρειάζεται πληρωμή, η απάντηση αναφέρει τη σελίδα όπου το κάνετε: ταμείο από το καλάθι, αποστολή από τη σελίδα της αποθήκης σας. Το push_to_shopify καταχωρίζει ένα προϊόν ως πρόχειρο, οπότε τίποτα δεν πωλείται μέχρι να το δημοσιεύσετε.

Εργαλεία

Κάθε απάντηση φέρει requestId (αναφέρετέ το όταν μας γράφετε) και warnings, πράγματα που αξίζει να ξέρετε αλλά δεν σταμάτησαν την κλήση. Μια μεγάλη απάντηση κόβεται γύρω στα 6.000 tokens με truncated: true· τότε οι λίστες παίρνουν μικρότερο limit.

Εργαλείο	Τι κάνει
list_orders	Λίστα των παραγγελιών μου στο NinjaBuy
order	Μία παραγγελία NinjaBuy
warehouse	Η αποθήκη μου στο NinjaBuy
product	Ανάγνωση παραλλαγών προϊόντος
add_to_cart	Προσθήκη στο καλάθι μου στο NinjaBuy
search_products	Αναζήτηση προϊόντων
analyze_product	Ανάλυση προϊόντος
import_product	Εισαγωγή προϊόντος
push_to_shopify	Προώθηση στο Shopify
list_synced_products	Λίστα των συγχρονισμένων προϊόντων μου
set_sync_rule	Ορισμός κανόνα συγχρονισμού

`list_orders`μόνο ανάγνωση

Οι παραγγελίες του λογαριασμού, οι νεότερες πρώτα: κατάσταση, κατάσταση πληρωμής, τι οφείλεται ακόμη, τα προϊόντα και η σελίδα κάθε παραγγελίας. Ακολουθήστε το cursor όσο το has_more είναι true.

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: οι γραμμές και οι τιμές της, η κατάσταση κάθε προϊόντος και πόσα έφτασαν, και η αποστολή με παρακολούθηση. Το order είναι null για id που δεν ανήκει σε αυτόν τον λογαριασμό.

idstringυποχρεωτικό: Ένα id από το list_orders.

Απαντά στο 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`εγγραφή

Βάζει παραλλαγές μιας καταχώρισης στο καλάθι, για αγορά από πριν και φύλαξη στο ράφι σας. Τίποτα δεν αγοράζεται: η απάντηση είναι η σελίδα του καλαθιού, όπου ολοκληρώνετε την αγορά.

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`μόνο ανάγνωση

Πόσο κοστίζει μία πώληση κάθε παραλλαγής ως την πόρτα του αγοραστή, και η τιμή που διατηρεί το περιθώριό σας στην πλατφόρμα σας. Τίποτα δεν αποθηκεύεται. Ίδια ποσά με την ανάλυση εισαγωγής.

linkstringυποχρεωτικό: Ένας σύνδεσμος προϊόντος.
weight_gnumberυποχρεωτικό: Βάρος ενός τεμαχίου συσκευασμένου, σε γραμμάρια.
ship_tostring?: Χώρα δύο γραμμάτων. 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`εγγραφή

Εισάγει μια καταχώριση με την ανάλυσή της, όπως στο API εισαγωγών. Δωρεάν. Επιστρέφει την εισαγωγή για προώθηση ή νέα τιμολόγηση.

linkstringυποχρεωτικό: Ένας σύνδεσμος προϊόντος ή ένα φύλλο ευρημάτων.
weight_gnumberυποχρεωτικό: Βάρος ενός τεμαχίου συσκευασμένου, σε γραμμάρια.
ship_tostring?: Χώρα δύο γραμμάτων. 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`εγγραφή

Αποθηκεύει μια εισαγωγή ως προϊόν και την καταχωρίζει στο κατάστημά σας Shopify ως πρόχειρο, με απόθεμα στην τοποθεσία Fulfilled by NinjaBuy. Μια νέα προώθηση το ενημερώνει. Ίδιοι κανόνες με την Προώθηση στο 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`εγγραφή

Τι να γίνεται όταν ένας πωλητής αυξάνει μια τιμή: νέα τιμή για να διατηρηθεί ένα περιθώριο, παύση ή μόνο ενημέρωση. Για κάθε προϊόν ή για ένα. Ίδια πεδία με τους Κανόνες συγχρονισμού.

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

Δύο: #1012 (το washed φούτερ, αγοράστηκε 1 Νοε) και #1015 (δύο υφασμάτινες τσάντες). Και οι δύο είναι πληρωμένες και παραγγελμένες από τον πωλητή· καμία δεν έχει φτάσει ακόμη στην αποθήκη.

Αξίζει να πουλήσω αυτό το φούτερ στο eBay; weidian.com/item.html?itemID=7750970856, περίπου 180 g συσκευασμένο.

analyze_product

Μία πώληση προς τις ΗΠΑ κοστίζει 191,52 CN¥ συνολικά, περίπου $27.71. Στα $49.99 το eBay κρατά περίπου $7.20 και εσείς κρατάτε $15.08, περιθώριο 30%. Το Black / L έχει εξαντληθεί. Καμία λέξη μάρκας στον τίτλο.

Ωραία. Βάλε το Black / M στο Shopify μου στα $49.99, με τίτλο «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.

Σύνδεση#

Claude

ChatGPT

Cursor

Claude Code και άλλοι βοηθοί γραμμής εντολών

Σύνδεση και πρόσβαση#

Τίποτα εδώ δεν ξοδεύει χρήματα#

Εργαλεία#

list_ordersμόνο ανάγνωση

orderμόνο ανάγνωση

warehouseμόνο ανάγνωση

productμόνο ανάγνωση

add_to_cartεγγραφή

search_productsμόνο ανάγνωση

analyze_productμόνο ανάγνωση

import_productεγγραφή

push_to_shopifyεγγραφή

list_synced_productsμόνο ανάγνωση

set_sync_ruleεγγραφή

Τι να ρωτήσετε#