Kuaidi100 launched China's first MCP-protocol-compatible logistics information service platform. The core API services of Kuaidi100's Baidiy
Nothing to run from here
Vendooly is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
116
tools declared
—
trust score
remote
at its publisher
—
calls last 7d
What it does
Amazon Seller Central, Ads and Vendor Central in ChatGPT & Claude. 106 tools; writes need approval.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user --transport http vendooly-mcp https://mcp.vendooly.com/mcp
# 2 — ask your agent for something these tools do
# list_clients, get_client_status, get_fba_inventory and 113 more
Vendooly costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Publishernot claimed
VEAll 1 server
vendooly1 server
1 category
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Installation
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
Claude Codedeclared by this listing
This is a public server: it answers at its publisher’s own address and this marketplace is not in the path. Claude Code registers it in one command; --scope user makes it available in every project. The transport below is http, as the publisher's own manifest declares it.
claude mcp add --scope user --transport http vendooly-mcp https://mcp.vendooly.com/mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
Free on mcprush, and it answers at its publisher’s own address: this marketplace is not in the path, so there is no key of ours to hold and no card to add.
What it writes
One config entry pointing straight at the publisher’s own address — this marketplace is not in the path, and nothing from this listing executes on your machine.
What you approve
116 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
List the connected Amazon outposts (an outpost = one seller on one marketplace; the account_id of each is what you pass to other tools). Org-scoped.
No parameter schema on file.
Get status/details of the selected Amazon seller account (outpost), including the Amazon Ads connection: ads.ads_status and, for Ads consents granted from 30/7/2026, ads.expires_at / ads.days_left (Amazon expires Ads consent 365 days after it is granted, then Ads stop working until the seller reconnects). If ads.warning is present, tell the user and point them to Marketplaces → Reconnect Ads.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
FBA inventory summaries
| Parameter | Type | Required | Notes |
|---|---|---|---|
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
READ-ONLY. "Check FBA shipments and show me the discrepancies / what to recover": reads the inventory ledger (Receipts) which gives, per shipment, units received and the UNRECONCILED quantity that Amazon itself flags (potential loss), plus an estimated recoverable value (× listing price); and cross-references reimbursements ALREADY granted (lost/damaged/returns) so you do not claim what is already
| Parameter | Type | Required | Notes |
|---|---|---|---|
| days | number | no | Lookback window in days (default 90) |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
READ-ONLY. "How many FBA units did I lose / got damaged, and how many were NOT reimbursed?" — the FBA lost & damaged balance per SKU (what ZoneWizard logistics, Igolai, Getida do). Reads the inventory ledger (Adjustments: lost M/5, found F/N, damaged E/6, other damage H/K/7/U, disposed D) and the reimbursements report (Lost_Warehouse, Damaged_Warehouse, CustomerReturn, reversals) and returns per S
| Parameter | Type | Required | Notes |
|---|---|---|---|
| days | integer | no | Ledger lookback in days (default 90; reimbursements are read over days+60). |
| sku | string | no | Exact SKU filter (optional). |
| only_open | boolean | no | true = only SKUs with open (unreimbursed) units. |
| limit | integer | no | Max SKUs returned (default 100), sorted by open units. |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
READ-ONLY. FBA orders as physically fulfilled by Amazon (report Amazon Fulfilled Shipments, GENERAL variant — no buyer PII): per order, the fulfillment-center-id each item shipped FROM and the derived ship-from country. Use when the user needs to know FROM WHICH COUNTRY an FBA order departed — typical case: choosing the correct VAT regime on manually issued invoices for marketplaces without Amazon
| Parameter | Type | Required | Notes |
|---|---|---|---|
| days | number | no | Shipment-date lookback window in days (1-30, default 7) |
| order_id | string | no | Filter: one Amazon order id (e.g. 402-1234567-1234567) |
| sku | string | no | Filter: exact SKU |
| max_orders | number | no | Max orders returned (default 100, cap 1000) |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
READ-ONLY. List FBA inbound plans (new "Send to Amazon" workflow, Fulfillment Inbound v2024-03-20): inbound plan id, name, status (ACTIVE/SHIPPED/VOIDED), marketplaces, created/updated. This is the API that sees shipments created with the current Amazon flow (the legacy get_inbound_shipments v0 returns nothing for them). Use to list the seller's actual inbound plans/shipments and their status.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| status | string | no | Optional filter: ACTIVE | SHIPPED | VOIDED |
| page_size | number | no | Page size (default/cap 30) |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
ACTION. Crea un PIANO di spedizione FBA ("Send to Amazon", Fulfillment Inbound v2024-03-20): SKU + quantità + indirizzo di ORIGINE (magazzino/fornitore del seller). È il PASSO 1 del flusso: il piano nasce come bozza modificabile, NON parte nessuna spedizione. SEQUENZA COMPLETA (guida l'utente passo-passo): 1) create_inbound_plan → 2) generate_inbound_options kind:"packing" → 3) confirm_inbound_opt
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | no | Nome del piano (max 40 char, opzionale) |
| items | array | yes | — |
| source_address | object | yes | Indirizzo di origine della merce |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
READ-ONLY. Dettaglio di UN piano inbound FBA v2024 (stato, indirizzo origine, righe SKU con quantità/prep/label). Con operation_id (invece di inbound_plan_id) fa il polling di un'operazione asincrona pendente (create/generate/confirm) e ne ritorna stato + problemi. Per l'ELENCO dei piani usa get_inbound_plans.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| inbound_plan_id | string | no | — |
| operation_id | string | no | Alternativa: polla lo stato di un'operazione async |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
ACTION (bozze non vincolanti). Genera E elenca in una sola chiamata le opzioni del piano inbound FBA: kind:"packing" = opzioni di imballo (packing groups); kind:"placement" = opzioni di DESTINAZIONE con split tra centri Amazon e FEE per opzione (inbound placement fee vs Amazon-optimized) — mostra SEMPRE fee e numero spedizioni di ogni opzione all'utente prima di confermare. Richiede il piano creat
| Parameter | Type | Required | Notes |
|---|---|---|---|
| inbound_plan_id | string | yes | — |
| kind | string | yes | — |
| regenerate | boolean | no | true = forza una NUOVA generazione anche se esistono già opzioni |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
ACTION. Conferma un'opzione del piano inbound FBA scelta dall'utente. kind:"packing" + packing_option_id = fissa l'imballo (poi servono le scatole: set_packing_information). kind:"placement" + placement_option_id = IMPEGNO VERO: le spedizioni vengono CREATE con lo split e le fee di quell'opzione (ritorna gli shipment_ids). Conferma SOLO dopo che l'utente ha visto fee e split e ha approvato esplici
| Parameter | Type | Required | Notes |
|---|---|---|---|
| inbound_plan_id | string | yes | — |
| kind | string | yes | — |
| option_id | string | yes | packing_option_id o placement_option_id (da generate_inbound_options) |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
ACTION. Registra le SCATOLE del piano inbound FBA (dopo il packing confermato): per ogni packing group, le scatole con dimensioni in CM, peso in KG, quantità di scatole identiche e contenuto (SKU+quantità per scatola, salvo content_source diverso). Passo obbligatorio PRIMA di generare le opzioni di placement. Chiedi all'utente dimensioni/peso reali: Amazon le verifica in ricezione.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| inbound_plan_id | string | yes | — |
| groupings | array | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
ACTION. Annulla un piano inbound FBA v2024 non ancora spedito (torna VOIDED). Usalo per i ripensamenti su un piano creato per errore o non più necessario. Chiedi conferma esplicita all'utente prima di chiamare.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| inbound_plan_id | string | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Update MFN inventory quantity for a SKU
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sku | string | yes | — |
| quantity | number | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Stato di elaborazione di un feed (es. quelli restituiti da bulk_delete_listings). Amazon lavora i feed in modo asincrono: IN_QUEUE/IN_PROGRESS = ancora in corso, richiama fra un po'. Quando è DONE la risposta porta GIÀ l'esito letto: summary con quante righe Amazon ha processato/accettato/rifiutato, errors_count e warnings_count, e issues_sample con un campione delle righe problematiche (`
| Parameter | Type | Required | Notes |
|---|---|---|---|
| feed_id | string | yes | ID del feed restituito da bulk_update_prices / bulk_update_inventory / bulk_update_listings / bulk_delete_listings / submit_listings_feed (NON il submissionId di update_listing) |
| wait | boolean | no | true = attende fino a ~45s che il feed finisca prima di rispondere |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
List individual orders (last N days): order ids, status, dates and totals only — no buyer data. Live Amazon Orders API, throttled (≈1 req/min): use ONLY when you need order-level rows. For daily sales/orders charts or trends over a period use get_daily_sales; for a single revenue total use get_revenue_summary — both are served from cache and never throttle.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| days_back | number | no | — |
| statuses | array | no | — |
| limit | number | no | Max orders returned (most recent first). Omit for all. |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Items for a specific order
| Parameter | Type | Required | Notes |
|---|---|---|---|
| order_id | string | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
READ-ONLY. Detailed physical FBA customer returns from GET_FBA_FULFILLMENT_CUSTOMER_RETURNS_DATA: SKU, ASIN, return date, quantity, original reason, detailed_disposition, status, fulfillment center and customer_comments. Use for damaged returns (DAMAGED_BY_FC/DAMAGED_BY_CARRIER), incompatibility (NOT_COMPATIBLE), product quality and return investigations. Separate from reimbursements/refunds and n
| Parameter | Type | Required | Notes |
|---|---|---|---|
| days | integer | no | Calendar days, default 30; omit when using start_date/end_date. |
| start_date | string | no | Inclusive return date YYYY-MM-DD, paired with end_date. |
| end_date | string | no | Inclusive return date YYYY-MM-DD, not future. |
| report_id | string | no | Resume or paginate the report returned by this tool, on the same outpost. |
| sku | string | no | Exact SKU filter. |
| asin | string | no | — |
| order_id | string | no | — |
| reason | string | no | Exact original Amazon reason code. |
| detailed_disposition | string | no | Exact original Amazon disposition, distinct from reason and status. |
| limit | integer | no | Rows per page, default 100; summaries cover all filtered rows. |
| offset | integer | no | Next page: pass next_offset with the same report_id and filters. |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
READ-ONLY. Fiscal transactions file for the accountant (VAT/OSS support): one row per order item for sales (VENDITA), refunds (RIMBORSO), A-to-Z claims and chargebacks, with Amazon posted date, marketplace, order id, SKU, quantity, currency, ship-to country, B2B flag (Amazon Business order), net price, VAT (Amazon ChargeType *Tax, separate), shipping and gift wrap with their VAT, promotions, taxab
| Parameter | Type | Required | Notes |
|---|---|---|---|
| start_date | string | yes | Inclusive posted date YYYY-MM-DD (UTC). |
| end_date | string | yes | Inclusive posted date YYYY-MM-DD (UTC), not future. |
| refresh | boolean | no | Regenerate a finished export for the same period instead of returning the cached one. |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
READ-ONLY. Amazon EPR (Extended Producer Responsibility) report for one seller outpost and one CLOSED calendar period, from SP-API GET_EPR_MONTHLY_REPORTS / GET_EPR_QUARTERLY_REPORTS / GET_EPR_ANNUAL_REPORTS (Product Listing role, sellers only). Returns a summary per ship-to country and EPR category/subcategory: units sold, total reported weight (kg) and material weights (paper, glass, aluminum, s
| Parameter | Type | Required | Notes |
|---|---|---|---|
| period_type | string | no | Aggregation of the Amazon report. Default monthly. |
| period | string | no | Closed period: YYYY-MM (monthly), YYYY-Qn e.g. 2026-Q2 (quarterly), YYYY (annual). Default: last closed period of that type. Current/future periods are rejected. |
| country | string | no | Optional ship-to country filter, ISO 2 letters (DE, FR, ES…). Totals then cover only that country. |
| limit | integer | no | How many top ASINs by reported weight to list, default 20. Summaries always cover all rows. |
| refresh | boolean | no | true = ask Amazon for a new report instead of reusing a ready one for the same period. |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Run catalog quality audit
| Parameter | Type | Required | Notes |
|---|---|---|---|
| top_n | number | no | — |
| wait_timeout_sec | number | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Crea/sostituisce una listing (PUT). product_data accetta campi SEMPLICI auto-mappati nel formato attributi SP-API: title, brand, price, quantity, condition, ean/upc/gtin, description, bullets[]. Per agganciare un'offerta a un ASIN GIA' a catalogo usa requirements:"LISTING_OFFER_ONLY" + asin (NON servono title/brand: li fornisce il catalogo). Puoi anche passare attributes gia' strutturati. validate
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sku | string | yes | — |
| product_data | object | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Modifica una listing esistente. SHORTCUT amichevoli (consigliati — costruiscono la struttura attributo corretta, niente schema SP-API a mano): bullets:[...] → bullet_point ("Funzionalità principali", la leva dei punti-elenco su amazon.it/EU, fino a 5 ~100 char l'uno), title → item_name, shipping_template → merchant_shipping_group (modello di spedizione: ID o nome esatto come in Seller Central; il
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sku | string | yes | — |
| bullets | array | no | Punti elenco (bullet_point), fino a 5 |
| title | string | no | Nuovo titolo (item_name) |
| shipping_template | string | no | Modello di spedizione da assegnare (ID o nome come in Seller Central). Elenco: get_product_types product_type="PRODUCT" → shipping_templates |
| patches | array | no | JSON Patch SP-API grezzi (alternativa agli shortcut) |
| product_type | string | no | Product type Amazon (es. WINDOW_SHADE). Opzionale: se manca si legge dalla listing; passalo solo per forzarlo |
| validate_only | boolean | no | true = dry-run, valida senza scrivere |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Fetch one listing (summaries, issues, offers, fulfillment availability). Pass include_data:["attributes"] for the full attribute set.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sku | string | yes | — |
| include_data | array | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Delete a listing
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sku | string | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Cancella offerte IN BLOCCO su un account, filtrando per canale di gestione. USA QUESTO, non delete_listing in ciclo, quando le offerte da eliminare sono più di qualche decina: delete_listing va SKU per SKU e sul rate limit di Amazon migliaia di SKU non finiscono mai, mentre qui si spediscono in feed da 20.000. Due fasi obbligatorie: (1) chiamalo SENZA plan_id → legge dal report Amazon quali SKU ri
| Parameter | Type | Required | Notes |
|---|---|---|---|
| channel | string | no | Quali offerte cancellare (default FBM = solo quelle gestite dal venditore) |
| skus | array | no | Elenco esplicito di SKU: salta il report e ignora channel |
| plan_id | string | no | Piano restituito dalla prima chiamata (fase 2) |
| confirm | boolean | no | true, insieme a plan_id, per eseguire davvero |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Search the Amazon catalog. IMPORTANT: use identifiers (ASIN/EAN/ISBN) for reliable, compact results. Keyword search returns up to 10 items (summaries only) and may be incomplete — prefer identifiers when you know the ASIN or EAN.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| keywords | string | no | — |
| identifiers | string | no | — |
| identifierType | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Get product type definition. product_type is REQUIRED (e.g. PUZZLE, SAFETY_AND_HEALTH, LUGGAGE). By default fetches the JSON Schema server-side and returns allowed enum values per attribute (attribute_enums) + required_attributes — no need to open the S3 link. The schema is personalised for the selected seller: shipping_templates = the seller's shipping templates (modelli di spedizione) as [{id, n
| Parameter | Type | Required | Notes |
|---|---|---|---|
| product_type | string | yes | — |
| locale | string | no | — |
| include_enums | boolean | no | — |
| raw_schema | boolean | no | — |
| attributes | array | no | Attribute names whose structure you need (e.g. ["care_instructions","material"]) |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
List own products from local cache (SKU, ASIN, title, price, stock FBA+MFN, fulfillment channel, velocity = avg units/day last 30d, days_cover = stock/velocity — paginated, default 50 rows, no customer data). Use velocity/days_cover for stock-out risk ("sells 3.2/day, runs out in ~4 days"). Filter channel:"FBM" for merchant-fulfilled only. NB: sorted by sales rank, so unranked FBM items appear in
| Parameter | Type | Required | Notes |
|---|---|---|---|
| limit | number | no | — |
| offset | number | no | — |
| q | string | no | — |
| only_in_stock | boolean | no | — |
| channel | string | no | FBA | FBM |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Catalog detail from local cache
| Parameter | Type | Required | Notes |
|---|---|---|---|
| asin | string | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Live SP-API catalog item lookup
| Parameter | Type | Required | Notes |
|---|---|---|---|
| asin | string | yes | — |
| locale | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
READ-ONLY. Buy Box / Featured Offer price per ASIN (max 20 per Amazon call, auto-batched). Returns buy_box_price (listing) + buy_box_landed_price (incl. shipping), condition, whether you win the Buy Box, and source. Falls back to live offers when Amazon has no competitive price, so it returns far fewer nulls than the raw SP-API. Use for a few ASINs; for a long list use get_buybox_prices.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| asins | array | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
READ-ONLY. BULK Buy Box / Featured Offer export for a LIST of ASINs (up to 100). Returns a clean table per ASIN: buy_box_price (all-in for the customer), lowest_price, offer_count, whether you win the Buy Box, FBA/FBM of the winner, and a reason when there is no Buy Box (suppressed / no offers). Use for "give me the Buy Box price for these ASINs" / export. Note: Amazon rate limits make long lists
| Parameter | Type | Required | Notes |
|---|---|---|---|
| asins | array | yes | List of ASINs (max 100 per call) |
| customer_type | string | no | Consumer (default) or Business for B2B prices |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Your own pricing per SKU
| Parameter | Type | Required | Notes |
|---|---|---|---|
| skus | array | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Estimate Amazon fees (referral + FBA + variable closing) and net proceeds for a given selling price, via the official Amazon Product Fees API (getMyFeesEstimate). Pass asin OR sku, the price, currency and fulfillment_channel (FBA default, or FBM). Returns referral_fee, fba_fee, closing_fee, total_fees and net_proceeds (price minus Amazon fees, before your cost of goods). Use it for real margins: m
| Parameter | Type | Required | Notes |
|---|---|---|---|
| asin | string | no | — |
| sku | string | no | — |
| price | number | yes | — |
| currency | string | no | ISO code, default EUR |
| fulfillment_channel | string | no | FBA (default) or FBM |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Update price for a SKU
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sku | string | yes | — |
| price | number | yes | — |
| currency | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Bulk price updates
| Parameter | Type | Required | Notes |
|---|---|---|---|
| updates | array | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Bulk inventory updates
| Parameter | Type | Required | Notes |
|---|---|---|---|
| updates | array | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Bulk listing attribute updates (title, bullet_point, any patch). updates: [{sku, title?, bullets?: string[], patches?: [...], product_type?, validate_only?}]. product_type is optional: each SKU's product type is read from its listing (results[].product_type_used). Use when you need to update titles or bullets on multiple SKUs at once instead of calling update_listing one by one. Returns {total, ok
| Parameter | Type | Required | Notes |
|---|---|---|---|
| updates | array | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Assegna lo STESSO modello di spedizione (merchant_shipping_group) a molti SKU in una volta, con un feed JSON_LISTINGS_FEED (fino a 5.000 SKU per chiamata, un feed) invece di update_listing SKU per SKU. shipping_template = ID o nome come in Seller Central (elenco: get_product_types product_type="PRODUCT" → shipping_templates). Prima chiama con validate_only:true (valida la modifica su 3 SKU di prov
| Parameter | Type | Required | Notes |
|---|---|---|---|
| skus | array | yes | SKU a cui assegnare il modello |
| shipping_template | string | yes | ID o nome del modello di spedizione |
| validate_only | boolean | no | true = valida su 3 SKU di prova, nessun feed |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
READ-ONLY. Account Health of ONE seller account on ONE marketplace (outpost), read from Amazon's official seller performance report (GET_V2_SELLER_PERFORMANCE_REPORT, same data as Seller Central → Account Health): seller account status (NORMAL/AT_RISK/DEACTIVATED), Account Health Rating status (GREAT/WARNED — Amazon does NOT expose the 0-1000 numeric score via API), each metric with value %, Amazo
| Parameter | Type | Required | Notes |
|---|---|---|---|
| refresh | boolean | no | true = ignore the ~6h cache and request a fresh report from Amazon (use only if the user asks for the very latest data) |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
READ-ONLY. Gated products: BEFORE listing or buying stock, tells whether THIS seller account can sell each ASIN on the outpost's marketplace (or other marketplaces of the same region) in a given condition, using Amazon's Listings Restrictions API (getListingsRestrictions). Per ASIN: libero (no restriction) / serve_approvazione (APPROVAL_REQUIRED, with Amazon's approval_links to Seller Central) / n
| Parameter | Type | Required | Notes |
|---|---|---|---|
| asins | array | no | ASIN da controllare (max 100). Accetta anche una stringa separata da virgole/a capo. |
| identifiers | array | no | In alternativa/aggiunta: codici EAN/UPC/GTIN (es. dal listino fornitore), convertiti in ASIN con il catalogo Amazon del marketplace dell'outpost (max 100 in totale con asins). |
| identifier_type | string | no | Tipo dei codici in identifiers (default EAN). |
| marketplace_ids | array | no | Marketplace da controllare (max 5, stessa region dell'outpost, es. APJ6JRA9NG5V4 = amazon.it, A1PA6795UKMFR9 = amazon.de). Default: il marketplace dell'outpost. |
| condition | string | no | Condizione di vendita (default new_new = Nuovo). |
| reason_locale | string | no | Lingua dei messaggi Amazon (es. it_IT); default = lingua del primo marketplace. |
| include_brand | boolean | no | Default true: legge il brand dal catalogo per raggruppare. false = più veloce, tutto sotto "brand sconosciuto". |
| brands | array | no | MODALITÀ PER MARCHIO (senza asins/identifiers): nomi di marchio da controllare (max 10), quando il fornitore non dà ASIN né EAN. Per ogni marchio lo strumento prende dal catalogo i suoi ASIN più vendu |
| category | string | no | Solo con brands: categoria in parole (es. "giocattoli", "integratori") per limitare il campione a quella categoria del marchio. Il campione è dichiarato come campione di categoria. |
| classification_id | string | no | Solo con brands: id numerico del nodo di categoria Amazon (browse node) per limitare il campione. Alternativo o insieme a category. |
| sample_size | integer | no | Solo con brands: ASIN per marchio nel campione (default 5). |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
READ-ONLY. Issue Amazon di SKU SPECIFICI (una chiamata SP-API per SKU): usalo quando l'utente nomina 1-20 SKU. Per la domanda "quali dei miei articoli NON sono in vendita / sono bloccati / soppressi e perché" NON usare questo in loop: usa list_inactive_listings, che copre tutto il catalogo con una chiamata ogni 20 SKU.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| skus | array | no | — |
| issue_locale | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
READ-ONLY. Elenco CATALOGO-WIDE dei listing che NON sono in vendita, CON IL MOTIVO — la risposta a "quali prodotti sono inattivi/bloccati/soppressi?", "cosa mi ha bloccato Amazon dopo il caricamento?", "perché questo articolo non si vende?". Legge lo stato reale della Listings Items API (BUYABLE / DISCOVERABLE) e gli enforcement dichiarati da Amazon: LISTING_SUPPRESSED (offerta non acquistabile),
| Parameter | Type | Required | Notes |
|---|---|---|---|
| scope | string | no | not_buyable (default) = tutto ciò che il cliente non può comprare |
| changed_since | string | no | Solo listing aggiornati da questa data (YYYY-MM-DD o ISO8601) — "cosa si è rotto dopo il batch di ieri" |
| max_pages | number | no | Pagine da 20 SKU da scorrere (default 25 = 500 SKU, max 50 = cap Amazon) |
| top_n | number | no | Quanti item dettagliati restituire (default 50); by_reason li conta comunque tutti |
| issue_locale | string | no | Lingua dei messaggi Amazon (es. it_IT); default = lingua del marketplace |
| check_fba_stock | boolean | no | Default true: legge FBA Inventory (1 chiamata) per spiegare gli SKU FBA che Amazon non motiva. false = report più rapido, quegli SKU restano "motivo non dichiarato" |
| check_stranded_report | boolean | no | Report Stranded Inventory (~20 s, riusato 20 min) per la causa reale degli stranded. Default automatico: richiesto solo se ci sono SKU stranded; true = forzalo (porta anche gli SKU stranded con offert |
| stranded_wait_sec | number | no | Attesa massima del report stranded in secondi (default 60, max 300); oltre → stranded_report.pending e si riprende al giro dopo |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Audit all listings for Amazon title limit (75 chars, enforced from July/August 2026 — i titoli non conformi vengono RISCRITTI dall'IA di Amazon, solo i brand registrati hanno 14 giorni di review). Returns titles over the limit with excess character count + bullet/highlight counts per SKU, più la fascia at_risk (73–75 char, conformi ma senza margine). L'azione per un titolo troppo lungo è ACCORCIAR
| Parameter | Type | Required | Notes |
|---|---|---|---|
| max_pages | number | no | Pages of 20 listings to scan (default 10 = up to 200 listings) |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Audit compliance/GPSR del catalogo (EU/IT). Per ogni SKU verifica gli attributi compliance REALI del suo product type (schema-aware): manufacturer, rtip_manufacturer_contact_information (contatto fabbricante), country_of_origin, safety_warning, safety_data_sheet_url e — dove il product type li prevede — i GPSR: gpsr_safety_attestation, gpsr_manufacturer_reference, dsa_responsible_party_address (re
| Parameter | Type | Required | Notes |
|---|---|---|---|
| max_pages | number | no | Pagine di 20 listing da scansionare (default 10 = ~200 SKU) |
| mode | string | no | standard (default) = compliance/GPSR curati; full = tutti gli attributi required dello schema del product type + tutte le issue Amazon |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Update Item Highlights on a listing. L'attributo UFFICIALE è title_differentiation (max 125 char, rollout titoli modulari 27/7/2026); item_highlights è il nome legacy visto su alcuni schema US — il tool risolve da solo quale espone lo schema del product type e scrive su quello. ATTENZIONE: non tutti i marketplace/product type lo espongono — dove manca il tool rifiuta con esito chiaro (not_supporte
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sku | string | yes | — |
| highlights | array | yes | Array of highlight strings (frasi brevi separate, totale ≤ 125 char) |
| product_type | string | no | Amazon product type — auto-detected if omitted |
| confirm | boolean | no | true to apply after reviewing the dry-run |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
READ-ONLY. Copertura A+ Content del catalogo: quali ASIN hanno un documento A+ APPROVED (= visibile al cliente) e quali no, con i buchi ORDINATI per peso commerciale (unità vendute a 30 giorni) — quindi "quali pagine che vendono davvero sono senza A+". Segnala anche i documenti REJECTED (lavoro già fatto mai andato online, il recupero più rapido) e quelli in DRAFT/SUBMITTED. LIMITE DA DICHIARARE S
| Parameter | Type | Required | Notes |
|---|---|---|---|
| max_documents | number | no | Max documenti A+ da espandere in ASIN (default 200) |
| max_catalog | number | no | Max SKU di catalogo da scansionare (default 1000) |
| top_n | number | no | Quante righe per lista (default 25) |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
READ-ONLY. Elenco dei documenti A+ Content del seller su questo marketplace, con stato (DRAFT | SUBMITTED | APPROVED | REJECTED), badge e data di aggiornamento. Solo APPROVED è visibile al cliente. Per la domanda "quanto del mio catalogo ha A+" usa audit_aplus_coverage, non questo.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| max_pages | number | no | Pagine di documenti da scorrere (default 10) |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
READ-ONLY. Dettaglio di UN documento A+ (stato, badge, ASIN associati, tipi di modulo). content_reference_key si prende da list_aplus_documents o audit_aplus_coverage. include_content=true restituisce anche i moduli completi. NB: i moduli A+ sono TIPIZZATI (STANDARD_TEXT, STANDARD_COMPARISON_TABLE, …), non HTML libero — un "HTML pronto" generato altrove va rimappato su questi tipi, non incollato.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| content_reference_key | string | yes | — |
| include_content | boolean | no | true = includi i moduli completi |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Read-only aggregated KPI summary for this account (listing counts, 7d revenue total, issue count). Aggregates only, no customer data.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Read-only aggregated KPI summary across all accounts in the org (aggregates only, no customer data)
No parameter schema on file.
Vendor Central OAuth link
| Parameter | Type | Required | Notes |
|---|---|---|---|
| redirect_uri | string | no | — |
| state | string | no | — |
| region | string | no | Vendor Central region (default eu) |
Vendor POs
| Parameter | Type | Required | Notes |
|---|---|---|---|
| days_back | number | no | — |
| include_details | boolean | no | — |
| po_item_state | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Vendor PO details
| Parameter | Type | Required | Notes |
|---|---|---|---|
| po_number | string | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Vendor PO aggregate summary
| Parameter | Type | Required | Notes |
|---|---|---|---|
| days_back | number | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Vendor invoices — SP-API non espone un endpoint di lettura per le fatture vendor retail (solo POST submitInvoices). Questo tool restituisce una spiegazione della limitazione e rimanda a get_vendor_remittances per gli importi stimati e a Vendor Central per le fatture reali.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| days_back | number | no | — |
| ship_from_party_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Vendor: importi stimati dai PO (SP-API non espone remittance reali in lettura)
| Parameter | Type | Required | Notes |
|---|---|---|---|
| days_back | number | no | — |
| summary_only | boolean | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
List Amazon Ads profiles for this account
| Parameter | Type | Required | Notes |
|---|---|---|---|
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
List Amazon Ads portfolios (groups of campaigns with optional shared budget)
| Parameter | Type | Required | Notes |
|---|---|---|---|
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Create an Amazon Ads portfolio to group campaigns (no portfolio-level budget cap; campaigns can then be assigned to it). Same scope as campaigns — no extra authorization needed.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| portfolio | object | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
LIVE: stato corrente delle campagne SP. Campi chiave per campagna: name, campaignId, state, targetingType (AUTO|MANUAL) e daily_budget = budget giornaliero NUMERICO nella valuta del marketplace (es. 50, 150). NON esiste un "bid" a livello campagna (i bid sono su keyword/target). Usa per VERIFICARE prima di agire o per avere nomi/ID. NON ritorna performance: per ACoS/spesa/ROAS/vendite/click usa ex
| Parameter | Type | Required | Notes |
|---|---|---|---|
| state_filter | array | no | — |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Create a SP campaign. campaign.targeting_type: "AUTO" (Amazon sceglie automaticamente i target — NON aggiungere keyword/target manuali; per modulare i bid dei 4 gruppi auto usa ads_create_sp_product_targets con auto_match) oppure "MANUAL" (default; poi attacchi keyword via ads_create_sp_keywords o ASIN via ads_create_sp_product_targets). Placement bidding: passa placement_bidding [{placement, perc
| Parameter | Type | Required | Notes |
|---|---|---|---|
| campaign | object | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Aggiorna una o PIÙ campagne SP. SINGOLA: campaign_id + patches (patches.daily_budget numero → convertito nel payload v3 budget{budgetType:DAILY,budget}; patches.state ENABLED|PAUSED; patches.placement_bidding = MOLTIPLICATORI per placement [{placement, percentage 0-900}] con placement PLACEMENT_TOP|PLACEMENT_REST_OF_SEARCH|PLACEMENT_PRODUCT_PAGE|SITE_AMAZON_BUSINESS (alias top/rest_of_search/produ
| Parameter | Type | Required | Notes |
|---|---|---|---|
| campaign_id | string | no | — |
| patches | object | no | — |
| items | array | no | Batch: [{campaign_id, daily_budget?, state?, placement_bidding?}], max 25 |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
READ-ONLY. Elenca i SEGMENTI DI PUBBLICO utilizzabili per i moltiplicatori di bid delle campagne Sponsored Products (audience bid adjustments, disponibili in IT/DE/FR/ES/UK). source: "amazon" (default: pubblici costruiti da Amazon, es. chi ha già comprato dal brand, chi ha cliccato o messo nel carrello, alta probabilità di acquisto), "amc" (pubblici creati in Amazon Marketing Cloud) o "all". searc
| Parameter | Type | Required | Notes |
|---|---|---|---|
| source | string | no | — |
| search | string | no | Filtro testuale sul nome del pubblico (opzionale) |
| locale | string | no | Lingua dei nomi, es. it_IT, de_DE, en_GB (opzionale) |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Imposta i MOLTIPLICATORI PER SEGMENTO DI PUBBLICO di UNA campagna Sponsored Products (dynamicBidding.shopperCohortBidding): aggiunge o modifica (set=[{audience_id, percentage}]), toglie (remove=[audience_id]) o azzera tutto (clear_all=true). percentage = aumento % del bid, INTERO 0-900: i segmenti possono solo ALZARE il bid, mai abbassarlo. Si applica SOPRA il moltiplicatore di placement (es. bid
| Parameter | Type | Required | Notes |
|---|---|---|---|
| campaign_id | string | yes | — |
| set | array | no | Aggiungi o modifica: [{audience_id, percentage 0-900 intero}] |
| remove | array | no | audience_id da togliere |
| clear_all | boolean | no | true = toglie TUTTI i segmenti della campagna |
| confirm | boolean | no | false/assente = solo anteprima; true = scrive (dopo ok dell'utente) |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Archivia (elimina) una o più campagne SP. È l'UNICO modo di archiviare una campagna: ads_update_sp_campaign accetta solo ENABLED|PAUSED (Amazon rifiuta ARCHIVED sul PUT). IRREVERSIBILE — una campagna archiviata non si riattiva, va ricreata. campaign_ids: [id, ...].
| Parameter | Type | Required | Notes |
|---|---|---|---|
| campaign_ids | array | yes | ID delle campagne da archiviare |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Read-only list of Sponsored Products ad groups (id, name, state, default bid)
| Parameter | Type | Required | Notes |
|---|---|---|---|
| campaign_id | string | no | — |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Create a SP ad group in an existing campaign. Defaults to PAUSED so it can be populated before delivery. IMPORTANTE — un ad group è O keyword-targeted O product-targeted, MAI entrambi: Amazon RIFIUTA (otherError) una keyword in un ad group che ha già product target, e viceversa. Quindi se ti servono SIA keyword SIA target di prodotto, crea DUE ad group separati nella stessa campagna: uno popolato
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ad_group | object | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Update a SP ad group
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ad_group_id | string | yes | — |
| patches | object | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
LIVE: stato corrente delle campagne Sponsored Brands (SB) ESISTENTI (create da Amazon Ads console — Vendooly non crea ancora campagne SB nuove, serve brandEntityId/Brand Registry/asset creativi/moderazione, non implementato). Campi chiave: name, campaignId, state (ENABLED|PAUSED|ARCHIVED), daily_budget, costType (CPC|vCPM), bidding (placement/bidOptimization), brandEntityId. NON ritorna performanc
| Parameter | Type | Required | Notes |
|---|---|---|---|
| state_filter | array | no | — |
| campaign_id_filter | array | no | — |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Aggiorna una o PIÙ campagne Sponsored Brands (SB) ESISTENTI: budget giornaliero, stato (ENABLED|PAUSED) e OTTIMIZZAZIONE DELL'OFFERTA. Per ottimizzare senza tagliare volume NON strozzare il budget: usa i moltiplicatori per posizionamento con patches.bid_adjustments_by_placement=[{placement, percentage}] — placement (enum verificato): TOP_OF_SEARCH | DETAIL_PAGE | HOME | OTHER (alias comodi: top, d
| Parameter | Type | Required | Notes |
|---|---|---|---|
| campaign_id | string | no | — |
| patches | object | no | — |
| items | array | no | Batch: [{campaign_id, daily_budget?, state?, bid_adjustments_by_placement?}], max 25 |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Read-only: elenco ad group Sponsored Brands (SB) — id, nome, stato (ENABLED|PAUSED|ARCHIVED), campagna di appartenenza. Filtra con campaign_id_filter.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| campaign_id_filter | array | no | — |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Aggiorna un ad group Sponsored Brands (SB) ESISTENTE (es. stato ENABLED|PAUSED). NON crea ad group nuovi.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ad_group_id | string | yes | — |
| patches | object | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
LIVE: keyword Sponsored Brands (SB) con BID e stato ATTUALI — la lettura da fare prima di riofferire su SB. Filtra con campaign_id/ad_group_id. NON ritorna performance: per spesa/vendite/ACoS usa execute_sql su fact_keyword_daily. Elenco vuoto = quel brand non ha keyword SB (tipico se le campagne SB usano product targeting o non esistono): dillo, NON inventare keyword.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| campaign_id | string | no | — |
| ad_group_id | string | no | — |
| state_filter | array | no | — |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Aggiorna il BID di una o PIÙ keyword Sponsored Brands. È la leva per OTTIMIZZARE una campagna SB invece di spegnerla o strozzarne il budget. keyword_id si ottiene da ads_list_sb_keywords. SINGOLA: keyword_id + bid. BATCH (consigliato): items=[{keyword_id, bid}], MAX 25. Esito verificato per-id (read-after-write).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| keyword_id | string | no | — |
| bid | number | no | — |
| items | array | no | Batch: [{keyword_id, bid}], max 25 |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Aggiorna lo stato (ENABLED|PAUSED|ARCHIVED) di una o PIÙ keyword Sponsored Brands. SINGOLA: keyword_id + state. BATCH: items=[{keyword_id, state}], MAX 25. Esito verificato per-id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| keyword_id | string | no | — |
| state | string | no | — |
| items | array | no | Batch: [{keyword_id, state}], max 25 |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
LIVE: product target Sponsored Brands (ASIN/categoria/brand) con BID e stato ATTUALI. Il target_id serve per ads_update_sb_target_bid. NON ritorna performance: usa execute_sql sul data-hub. Elenco vuoto = nessun target SB su questo profilo: dillo, NON inventare target.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| campaign_id | string | no | — |
| ad_group_id | string | no | — |
| state_filter | array | no | — |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Aggiorna il BID di uno o PIÙ product target Sponsored Brands. Insieme a ads_update_sb_keyword_bid e ai moltiplicatori per posizionamento di ads_update_sb_campaign è il modo per OTTIMIZZARE SB (invece di limitarsi a spegnere o tagliare il budget). target_id da ads_list_sb_targets. SINGOLA: target_id + bid. BATCH: items=[{target_id, bid}], MAX 25. Esito verificato per-id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| target_id | string | no | — |
| bid | number | no | — |
| items | array | no | Batch: [{target_id, bid}], max 25 |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Aggiorna lo stato (ENABLED|PAUSED|ARCHIVED) di uno o PIÙ product target Sponsored Brands. SINGOLA: target_id + state. BATCH: items=[{target_id, state}], MAX 25. Esito verificato per-id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| target_id | string | no | — |
| state | string | no | — |
| items | array | no | Batch: [{target_id, state}], max 25 |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
LIVE: campagne Sponsored Display (SD) ESISTENTI — name, campaignId, state (enabled|paused|archived), budget giornaliero, tactic (T00020 contestuale | T00030 audiences), costType (cpc|vcpm), bidOptimization. Vendooly non CREA campagne SD (servono audiences/creatives/Brand Registry): legge e aggiorna quelle già create da Amazon Ads console. NON ritorna performance: per ACoS/spesa SD usa execute_sql
| Parameter | Type | Required | Notes |
|---|---|---|---|
| state_filter | array | no | — |
| campaign_id_filter | array | no | — |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Aggiorna una o PIÙ campagne Sponsored Display ESISTENTI: budget giornaliero e/o stato (enabled|paused). SINGOLA: campaign_id + daily_budget/state. BATCH: items=[{campaign_id, daily_budget?, state?}], MAX 25. Esito verificato per-id (read-after-write). NON crea campagne SD.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| campaign_id | string | no | — |
| daily_budget | number | no | — |
| state | string | no | — |
| items | array | no | Batch: [{campaign_id, daily_budget?, state?}], max 25 |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Read-only: ad group Sponsored Display — id, nome, stato, campagna di appartenenza e defaultBid (l'offerta dell'ad group, la leva di ottimizzazione SD). Filtra con campaign_id_filter.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| campaign_id_filter | array | no | — |
| state_filter | array | no | — |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Aggiorna uno o PIÙ ad group Sponsored Display: BID (defaultBid) e/o stato (enabled|paused). Su SD il bid dell'ad group è la leva principale di ottimizzazione. SINGOLA: ad_group_id + bid/state. BATCH: items=[{ad_group_id, bid?, state?}], MAX 25. Esito verificato per-id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ad_group_id | string | no | — |
| bid | number | no | — |
| state | string | no | — |
| items | array | no | Batch: [{ad_group_id, bid?, state?}], max 25 |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
LIVE: keyword SP con bid e stato ATTUALI — per agire o verificare. NON ritorna performance: per spesa/vendite/ACoS o keyword che sprecano usa execute_sql su fact_keyword_daily.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| campaign_id | string | no | — |
| ad_group_id | string | no | — |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Create SP keywords. L'ad group bersaglio deve essere keyword-targeted: se ha GIÀ product target Amazon rifiuta con otherError (un ad group è keyword O product, mai entrambi) → in quel caso crea un ad group dedicato alle keyword. Ogni keyword: { campaign_id, ad_group_id, keyword_text, match_type (BROAD|PHRASE|EXACT), bid }.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| keywords | array | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Aggiorna il bid di una o PIÙ keyword SP. SINGOLA: keyword_id + bid. BATCH (consigliato per agire su molte keyword in una volta — meno chiamate, niente raffica): items=[{keyword_id, bid}], ogni keyword può avere un bid diverso, MAX 25 per chiamata. Esito verificato PER-ID (read-after-write).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| keyword_id | string | no | — |
| bid | number | no | — |
| items | array | no | Batch: [{keyword_id, bid}], max 25 |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Aggiorna lo stato (ENABLED/PAUSED) di una o PIÙ keyword SP. SINGOLA: keyword_id + state. BATCH: items=[{keyword_id, state}], MAX 25 per chiamata. Esito verificato PER-ID.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| keyword_id | string | no | — |
| state | string | no | — |
| items | array | no | Batch: [{keyword_id, state}], max 25 |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
List SP negative keywords
| Parameter | Type | Required | Notes |
|---|---|---|---|
| campaign_id | string | no | — |
| ad_group_id | string | no | — |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Create SP negative keywords
| Parameter | Type | Required | Notes |
|---|---|---|---|
| negatives | array | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Delete SP negative keywords
| Parameter | Type | Required | Notes |
|---|---|---|---|
| keyword_ids | array | yes | — |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
READ-ONLY LIVE. Elenco SP completo di default (all_pages=true), con ASIN/SKU, stato, nomi e stati di campagna e gruppo. Filtri esatti. all_pages=false legge una pagina Amazon: continuare con next_token anche se vuota dopo i filtri ASIN/SKU. Per trovare tutti gli ASIN scoperti usare ads_catalog_coverage.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| campaign_id | string | no | — |
| ad_group_id | string | no | — |
| state_filter | array | no | Default ENABLED e PAUSED |
| asin | string | no | — |
| sku | string | no | — |
| page_size | integer | no | — |
| next_token | string | no | — |
| all_pages | boolean | no | — |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
READ-ONLY. Tutti gli ASIN del catalogo e delle vendite recenti di un outpost, uno per uno, con SKU, titolo, stock, vendite e copertura Sponsored Products LIVE. Incrocia tutte le Product Ads e gli stati campagna/gruppo. Nessun campionamento; dati incompleti o obsoleti producono errore, mai falsi scoperti. Per prodotti venduti senza SP attive usare only_with_sales=true e only_uncovered=true. Richied
| Parameter | Type | Required | Notes |
|---|---|---|---|
| lookback_days | integer | no | — |
| only_in_stock | boolean | no | — |
| only_with_sales | boolean | no | — |
| only_uncovered | boolean | no | Solo sp_covered=false, inclusi gli esauriti se only_in_stock=false |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Create SP product ads
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ads | array | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
List SP targeting clauses — SIA i target MANUAL (ASIN/categoria) SIA i 4 gruppi AUTO che Amazon genera da solo nelle campagne AUTO. Ogni clause ritorna il suo targetId, lo state e (se impostato) il bid. Mappatura gruppi AUTO (expression.type → nome UI): QUERY_HIGH_REL_MATCHES=close-match, QUERY_BROAD_REL_MATCHES=loose-match, ASIN_SUBSTITUTE_RELATED=substitutes, ASIN_ACCESSORY_RELATED=complements.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| campaign_id | string | no | — |
| ad_group_id | string | no | — |
| state_filter | array | no | — |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Create SP targets. MANUAL (campagne MANUAL): ogni target { campaign_id, ad_group_id, bid, e uno tra: asin (ASIN target), category_id (category target), expression (raw v3) }. AUTO (campagne AUTO): per impostare il bid sui 4 gruppi di matching automatico usa { campaign_id, ad_group_id, bid, auto_match: "close"|"loose"|"substitutes"|"complements" } (close=ricerche strettamente correlate, loose=gener
| Parameter | Type | Required | Notes |
|---|---|---|---|
| targets | array | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Aggiorna il bid di uno o PIÙ target SP (MANUAL ASIN/categoria o i 4 gruppi AUTO close/loose/substitutes/complements). Il target_id si ottiene da ads_list_sp_targets; è QUESTA (non ads_create_*) la via per modulare i bid dei gruppi auto su una campagna AUTO già esistente. SINGOLA: target_id + bid. BATCH (consigliato per molti target): items=[{target_id, bid}], ognuno con bid diverso, MAX 25. Esito
| Parameter | Type | Required | Notes |
|---|---|---|---|
| target_id | string | no | — |
| bid | number | no | — |
| items | array | no | Batch: [{target_id, bid}], max 25 |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Aggiorna lo stato (ENABLED/PAUSED) di uno o PIÙ target SP. SINGOLA: target_id + state. BATCH: items=[{target_id, state}], MAX 25. Esito verificato per-id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| target_id | string | no | — |
| state | string | no | — |
| items | array | no | Batch: [{target_id, state}], max 25 |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Delete (archive) SP product targets
| Parameter | Type | Required | Notes |
|---|---|---|---|
| target_ids | array | yes | — |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
List SP negative product targets
| Parameter | Type | Required | Notes |
|---|---|---|---|
| campaign_id | string | no | — |
| ad_group_id | string | no | — |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Create SP negative product targets. Each: { campaign_id, ad_group_id, asin (or raw expression) }.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| targets | array | yes | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Delete (archive) SP negative product targets
| Parameter | Type | Required | Notes |
|---|---|---|---|
| target_ids | array | yes | — |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
Vendor trading terms — SP-API non espone termini commerciali (payment terms, sconti, accordi) in lettura. Questo tool restituisce una spiegazione della limitazione e rimanda a Vendor Central e a get_vendor_remittances per i netCost per PO.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
READ-ONLY operational recap, aggregates only (no customer data): revenue, orders, FBA/FBM split, account health and top products by sales velocity. Use when the user asks "how did it go", "recap", "how am I doing".
| Parameter | Type | Required | Notes |
|---|---|---|---|
| days | number | no | Days to analyze (default 7) |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
Diagnose a sales drop: compares the last N days with the previous period, checks account health and returns likely causes plus suggested actions. Use for "why are my sales dropping?".
| Parameter | Type | Required | Notes |
|---|---|---|---|
| days | number | no | Period width in days (default 7) |
| statuses | array | no | Amazon OrderStatuses to include in the comparison (SP-API enum, e.g. Shipped, Unshipped, PartiallyShipped, Pending, Canceled). Default: all of the former. |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
ACTION. Reprices the given SKUs to win the Buy Box: compares your price with the Buy Box price and proposes a new one (delta below the Buy Box, never below floor). With confirm=false it returns a PREVIEW (before→after); with confirm=true it applies the prices. ALWAYS show the preview and get the user's explicit approval before calling with confirm=true.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| skus | array | yes | — |
| floor | number | no | Hard minimum price |
| delta | number | no | How far below the Buy Box to price (default 0.01) |
| confirm | boolean | no | true = actually apply the prices |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
READ-ONLY, LIVE. Quanto del budget GIORNALIERO ogni campagna ha già consumato OGGI, in percentuale (dato INTRAGIORNALIERO, aggiornato da Amazon ogni ~10-15 min). Serve alla domanda "quali campagne stanno per restare senza budget adesso / sono già andate dark?": a 100% la campagna esce dall'asta fino a mezzanotte. È l'UNICA fonte del dato di oggi — il data-hub (fact_campaign_daily) è giornaliero e
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ad_product | string | no | Tipo di campagne da controllare (default SP) |
| campaign_ids | array | no | Campagne specifiche; se omesso controlla tutte le ENABLED |
| threshold_percent | number | no | Soglia per la lista at_risk (default 80) |
| max_campaigns | number | no | Tetto di campagne da controllare in auto-discovery (default 300) |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
READ-ONLY. Cross-references catalog days of cover (30d cached velocity) with active SP product ads: finds where you are paying for clicks on products close to stock-out. Use for "am I wasting ads budget?", "are ads pushing products that are running out?".
| Parameter | Type | Required | Notes |
|---|---|---|---|
| days_threshold | number | no | Days-of-cover threshold (default 14) |
| profile_id | string | no | — |
| account_id | string/number | no | ID dell'outpost Amazon (= un seller su uno specifico marketplace; vedi list_clients). Opzionale se il token è legato a un solo outpost. |
READ-ONLY. Problemi operativi rilevati OGNI GIORNO dal motore deterministico Vendooly sul Data-Hub (i numeri vengono dal motore dati, non dall'LLM). Regole: buybox_lost (Buy Box persa su ASIN che vendono), buybox_suppressed (Buy Box soppressa), stockout_risk (copertura reale FBA sotto soglia, merce in arrivo inclusa), ads_no_stock (product ad SP attiva su prodotti in esaurimento), negative_margin
| Parameter | Type | Required | Notes |
|---|---|---|---|
| status | string | no | Filtro stato (default open) |
| rule_key | string | no | Solo una regola |
| severity | string | no | — |
| limit | number | no | Max findings (default 50, cap 200) |
List built-in documentation topics (guides and recipes for using Vendooly tools correctly: write confirmation flow, catalog cache fields, rate limits, multi-account, cross analyses). Read the relevant guide BEFORE an operation you are not familiar with.
No parameter schema on file.
Get a built-in documentation topic by name (see list_context_topics).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| topic | string | yes | — |
Invite a colleague to the user's OWN Vendooly organization (the one of this connection — you cannot choose another). Use when the user says "invite this person to my account/team". Only owners/admins can invite. role is admin (sees every seller) or member (sees only the sellers listed in seller_ids; get them from list_team_members → sellers). With send_email=true (default) Vendooly emails the
| Parameter | Type | Required | Notes |
|---|---|---|---|
| string | yes | Email of the person to invite. | |
| role | string | yes | admin = full access; member = only the sellers in seller_ids. |
| seller_ids | array | no | For role=member: seller ids (from list_team_members → sellers) the member may see. |
| send_email | boolean | no | true (default): email the invitation. false: no email, return the invite link. |
| permissions | object | no | For role=member: access level per function, each none | read | write. Keys: sales (max read), catalog, pricing_inventory, ads, account_team (max read). Omitted keys = none. If permissions is omitted e |
| confirm_id | string | no | Token di conferma ritornato dall'anteprima. Ripassa lo STESSO payload + confirm_id per eseguire davvero la scrittura. |
List the people of the user's Vendooly organization (role, status, assigned sellers, per-function permissions) and the seller ids that can be assigned to a member. Owners/admins only.
No parameter schema on file.
Send the user's feedback (a bug, an idea, a question or a general comment) straight to the Vendooly team — they read every one. Use it whenever the user reports a problem, is frustrated, hits an error, or suggests something. ALSO proactively OFFER to send it when something clearly is not working ("vuoi che lo segnali al team Vendooly?") and call it once they agree. Put the user's words in `message
| Parameter | Type | Required | Notes |
|---|---|---|---|
| message | string | yes | The feedback in the user's own words (what happened / what they want). |
| category | string | no | Type of feedback (default other). |
| ai_context | string | no | Short note: what the user was doing, which account/tool, any error message you observed. |
Esegue UNA query SQL di sola lettura sul data-hub storico dell'account (DuckDB, un file per org). È LA STRADA PRIMARIA per OGNI domanda di ANALYTICS, in particolare la PERFORMANCE Amazon Ads: ACoS, ROAS, spesa, click, impression, vendite/ordini per campagna o keyword, keyword che sprecano, campagne zombie, performance PER PLACEMENT — Top of Search / Rest of Search / Product Pages / Amazon Business
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sql | string | yes | La query SQL di lettura. Una sola istruzione, niente ";" multipli. |
| max_rows | integer | no | Righe massime da restituire (default e tetto: 5000). |
Healthcheck
No parameter schema on file.
Free
$0 forever
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Vendooly or to call it, at any volume.
Call allowance · this installenforced at the gateway
Monthly allowance, in calls
—
—
Alert at 80% · then the tool returns a normal MCP error
Used this month: —
—Grade not published
No rule-by-rule report on file for this release
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
This listing is an address its publisher runs, and you connect to it directly — this marketplace is not in the path. The scanner reads packages and public source, and an address is neither. So there is no grade — not a withheld one, an unmeasured one.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 1.0.2.
1.0.2
undated
latestNo release note was published with this version.
—
no reviews yet
Who can review
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Sign in to write one
Any signed-in account that does not publish Vendooly can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
No reviews yet
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.