com.webotee/amazon-product-research-mcp

Official72 tools

by ncosic · Python

Amazon brand, seller, niche & buy-box intelligence inside your own Claude or ChatGPT.

Research Amazon brands, sellers, niches, and buy-box data for competitive analysis.

Topics

amazonamazon-sellerchatgptclaudemcpmodel-context-protocolproduct-researchwebotee

Captured live from the server via tools/list.

evaluate_asin_sourcing

Evaluate a single ASIN for FBA sourcing. Returns composite sourcing score (0-100), 5-dimension breakdown (velocity, gating, friction, margin, brand_posture), estimated 30-day demand (units_30d_final + est_revenue_30d) with its source/badge_band/confidence, a data_coverage flag (full vs velocity_only — so a null demand reads as a coverage gap, not zero sales), star rating + review count (with a rating_coverage flag), brand-level FBA/Amazon dominance, and a red-flag list. Also returns the product brand, title, and price (or price range) plus the ASIN's fulfillment (FBA/FBM/AMZ + amz/fba pct). Use when the user asks 'should I buy this?', 'how fast does this sell?', or shares an ASIN and wants a sourcing recommendation.

Parameters (3)

asinstringrequired
Amazon ASIN, 10-character alphanumeric.
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
qtyinteger
Optional purchase quantity for ROI sizing.

evaluate_brand

Evaluate a brand for portfolio inclusion. Returns brand-level control posture, winner diversity (HHI), Amazon retail dominance %, FBA penetration %, catalog churn rate, total bought-past-month volume, estimated 30-day revenue, avg ship-by days, cross-brand operator count, plus the top 10 ASINs by composite sourcing score (each with product brand, title, price or price range, and fulfillment FBA/FBM/AMZ + amz/fba pct). Use when the user names a brand and asks 'is this worth carrying?', 'how does this brand look?', 'what is the churn rate?', or 'how fast does this brand ship?'.

Parameters (27)

brandstringrequired
Brand name (case-insensitive).
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
distribution_verdict_instring
Comma-separated distribution verdicts to keep, e.g. 'DOMINANT SELLER', 'OPEN DISTRIBUTION', 'HIGH BRAND HEAT'. If the brand's verdict isn't in the list, an empty result is returned.
asinstring
Keep only this ASIN in top_asins.
asin_containsstring
min_composite_scorenumber
max_composite_scorenumber
min_velocitynumber
max_velocitynumber
min_gatingnumber
max_gatingnumber
min_marginnumber
max_marginnumber
min_ratingnumber
max_ratingnumber
min_number_of_ratingsnumber
max_number_of_ratingsnumber
product_brandstring
Exact product brand (case-insensitive) on top_asins.
product_brand_containsstring
product_title_containsstring
min_pricenumber
max_pricenumber
fulfillment_instring
Comma-separated FBA/FBM/AMZ to keep on top_asins.
min_fulfillment_amz_dom_pctnumber
max_fulfillment_amz_dom_pctnumber
min_fulfillment_fba_pen_pctnumber
max_fulfillment_fba_pen_pctnumber

competitive_landscape

Map the competitive landscape for a brand or category root. Returns top 10 sellers by observed buybox days held, top 10 brands by winner-diversity HHI, plus week-over-week deltas. Use when the user asks 'who's winning this category?' or 'who controls the buybox here?'.

Parameters (30)

category_root_idinteger
brandstring
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
seller_namestring
Exact seller name in the sellers list (case-insensitive).
seller_name_containsstring
min_total_observed_buybox_daysnumber
max_total_observed_buybox_daysnumber
min_brand_countnumber
max_brand_countnumber
min_winner_diversitynumber
max_winner_diversitynumber
min_control_scorenumber
max_control_scorenumber
min_amz_retail_dominance_pctnumber
max_amz_retail_dominance_pctnumber
min_unique_sellers_3mnumber
max_unique_sellers_3mnumber
min_catalog_churn_30d_pctnumber
max_catalog_churn_30d_pctnumber
min_bought_past_month_totalnumber
max_bought_past_month_totalnumber
min_seller_churn_30d_pctnumber
max_seller_churn_30d_pctnumber
min_seller_churn_30d_delta_vs_cat_ppnumber
max_seller_churn_30d_delta_vs_cat_ppnumber
min_brand_velocity_90d_units_daynumber
max_brand_velocity_90d_units_daynumber
min_pct_asins_gated_to_3pnumber
max_pct_asins_gated_to_3pnumber
dominant_category_velocity_tier_instring
Comma-separated velocity tiers to keep in the brand list.

risk_assessment

Risk + protection assessment for an ASIN or brand. Returns composite risk score (0-100), recent MAP violation events (≤10, each with the offending ASIN's product brand, title, price or price range and fulfillment FBA/FBM/Amazon), unauthorized seller list (≤10), and 1-3 recommended actions. Use for 'flag risk events on my brand' or 'is this ASIN risky?' style prompts.

Parameters (24)

asinstring
brandstring
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
daysinteger
Lookback window for MAP events. Default 30.
kind_instring
Comma-separated flagged-event kinds to keep (e.g. map_violations,amazon_dominated).
severity_instring
Comma-separated severities to keep (high/medium/low).
min_countnumber
max_countnumber
buybox_sellerstring
Exact offending buy-box seller (case-insensitive).
buybox_seller_containsstring
min_listed_pricenumber
max_listed_pricenumber
event_date_fromstring
YYYY-MM-DD.
event_date_tostring
product_brandstring
Exact product brand (case-insensitive).
product_brand_containsstring
product_title_containsstring
min_pricenumber
max_pricenumber
fulfillment_instring
Comma-separated FBA/FBM/AMZ to keep.
min_fulfillment_amz_dom_pctnumber
max_fulfillment_amz_dom_pctnumber
min_fulfillment_fba_pen_pctnumber
max_fulfillment_fba_pen_pctnumber

xmkt_pricing_compare

Cross-marketplace (Amazon vs Walmart) pricing comparison. Returns matched pairs from mv_product_identity with current Amazon price, current Walmart price, delta %, and a coarse Amazon-FBA profitability check. Each pair also carries the Amazon ASIN's product brand, title and catalog price (or price range) plus fulfillment (FBA/FBM/Amazon). Use for arbitrage / sourcing questions ('cheaper on Walmart?'). Single-ASIN or by-brand.

Parameters (15)

asinstring
brandstring
marketplace_idinteger
Amazon-side marketplace for the comparison (Walmart US is always the other side). 1 = Amazon UK, 2 = Amazon US (default)
min_match_confidencenumber
Only matched pairs with Amazon<->Walmart match confidence >= this.
max_match_confidencenumber
min_amazon_pricenumber
max_amazon_pricenumber
min_walmart_pricenumber
max_walmart_pricenumber
min_delta_pct_amz_vs_wmtnumber
Only pairs whose Amazon-vs-Walmart price delta percentage is >= this.
max_delta_pct_amz_vs_wmtnumber
min_est_arbitrage_profitnumber
max_est_arbitrage_profitnumber
product_title_containsstring
fulfillment_instring
Comma-separated FBA/FBM/AMZ to keep.

gating_repricing_advice

Recommend ungate / arbitrage / avoid for an ASIN, with a 3-bullet rationale citing named metrics (gating_score, amz_retail_dominance_pct, fba_pct, brand_posture). Also returns the ASIN's product brand, title and price (or price range) plus fulfillment (FBA/FBM/Amazon). Use for 'should I try to ungate this?' / 'how should I price this?'.

Parameters (2)

asinstringrequired
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)

find_brands_with_high_seller_churn

Find brands experiencing high seller churn relative to their category. Returns brands where seller_churn_30d_delta_vs_cat_pp >= the specified threshold (default 5pp). Optionally filtered by category. Use when the user asks about 'brands losing sellers', 'high churn brands', or 'seller instability'.

Parameters (13)

categorystring
Category root name to filter (optional).
min_delta_ppnumber
Min delta vs category in percentage points. Default 5.
max_delta_ppnumber
Max delta vs category in percentage points. Omit for no ceiling.
limitinteger
Max results (capped at 10). Default 10.
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
scopestring
tracked = only brands on the user's watchlist; universe = all brands. Default universe.
brandstring
Exact brand match (case-insensitive).
brand_containsstring
min_seller_churn_30d_pctnumber
max_seller_churn_30d_pctnumber
min_brand_velocity_90d_units_daynumber
max_brand_velocity_90d_units_daynumber
dominant_category_velocity_tier_instring
Comma-separated velocity tiers to keep.

categories_amazon_retreating

Find categories where Amazon is retreating — net brand exits exceed entries over 90 days (amazon_expansion_net_90d < 0). Returns categories ordered by retreat magnitude. Use when the user asks 'where is Amazon pulling back?', 'which categories is Amazon leaving?', or 'Amazon retreat opportunities'.

Parameters (15)

limitinteger
Max results (capped at 10). Default 10.
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
category_namestring
Exact category name (case-insensitive).
category_name_containsstring
velocity_tier_instring
Comma-separated velocity tiers to keep.
min_amazon_expansion_net_90dnumber
max_amazon_expansion_net_90dnumber
min_brand_countnumber
max_brand_countnumber
min_asin_countnumber
max_asin_countnumber
min_pct_amazon_plnumber
max_pct_amazon_plnumber
min_amz_retail_dominance_pctnumber
max_amz_retail_dominance_pctnumber

top_velocity_brands

Find top brands by 90-day unit velocity (brand_velocity_90d_units_day). Optional filters: scope (tracked = user's watchlist, universe = all), category, minimum velocity, exclude Amazon private label, exclude gated. Use when the user asks 'fastest selling brands', 'top velocity brands', 'brands I track by velocity', 'what brands move the most units?', or 'best selling brands in [category]'. When the user says 'my brands' or 'brands I track', set scope=tracked.

Parameters (22)

categorystring
Category root name to filter (optional).
min_velocitynumber
Minimum units/day threshold (optional).
exclude_amazon_plboolean
Exclude Amazon private label brands. Default true.
exclude_gatedboolean
Exclude brands gated to 3P sellers. Default true.
limitinteger
Max results (capped at 10). Default 10.
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
scopestring
tracked = only brands on the user's watchlist; universe = all brands. Default universe.
brandstring
Exact brand match (case-insensitive).
brand_containsstring
min_sold_30d_revenuenumber
max_sold_30d_revenuenumber
min_seller_churn_30d_pctnumber
max_seller_churn_30d_pctnumber
min_seller_churn_30d_delta_vs_cat_ppnumber
max_seller_churn_30d_delta_vs_cat_ppnumber
min_control_scorenumber
max_control_scorenumber
min_winner_diversitynumber
max_winner_diversitynumber
min_pct_asins_gated_to_3pnumber
max_pct_asins_gated_to_3pnumber
dominant_category_velocity_tier_instring
Comma-separated velocity tiers to keep.

top_sourcing_picks

Find top sourcing-pick ASINs across the entire catalog with optional filters: max retail price, min retail price, category, brand, exclude gated, exclude Amazon private label. Use when the user asks 'top sourcing picks', 'best ASINs to source', 'ASINs under $X with rising demand', 'fastest growing ASINs', or any cross-cutting question where they have NOT named a specific entity yet. Each pick carries product brand, title and price (or price range) plus fulfillment (FBA/FBM/Amazon) alongside the sourcing scores.

Parameters (30)

max_retail_pricenumber
min_retail_pricenumber
min_velocity_scoreinteger
Minimum velocity sub-score (0-100). >=90 = 'rising demand' (top ~3%%), >=70 = 'moderate growth' (top ~10%%). >=50 covers 97%% of ASINs and is not a meaningful filter.
categorystring
brandstring
exclude_amazon_plboolean
exclude_gatedboolean
limitinteger
Number of products to return (default 10, max 50).
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
scopestring
tracked = only ASINs from brands on the user's watchlist; universe = all. Default universe.
asinstring
Exact ASIN match.
asin_containsstring
min_composite_scorenumber
max_composite_scorenumber
min_gating_risk_scorenumber
max_gating_risk_scorenumber
min_margin_signalnumber
max_margin_signalnumber
min_sold_30d_revenuenumber
max_sold_30d_revenuenumber
min_ratingnumber
max_ratingnumber
min_number_of_ratingsnumber
max_number_of_ratingsnumber
product_title_containsstring
Keyword title search across the WHOLE catalog (FULLTEXT, token-AND any order — may also match the product description), ranked by sourcing score. Broader recall than a literal substring: 'ceiling fan mount' matches titles containing all three words in any order.
fulfillment_instring
Comma-separated FBA/FBM/AMZ to keep.
min_fulfillment_amz_dom_pctnumber
max_fulfillment_amz_dom_pctnumber
min_fulfillment_fba_pen_pctnumber
max_fulfillment_fba_pen_pctnumber

top_expanding_operators

Find sellers (operators) expanding into the most NEW brands in a recent window. Use when the user asks 'operators expanding into new brands', 'sellers growing fastest by brand count', 'who is moving into new brands this month', or any cross-cutting operator question without a specific seller named.

Parameters (19)

window_daysinteger
Days back for 'new' brands (default 30, max 90).
min_new_brandsinteger
Minimum new-brand count to surface (default 3).
limitinteger
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
seller_namestring
Exact seller/operator name (case-insensitive).
seller_name_containsstring
max_new_brands_in_windownumber
min_total_brandsnumber
max_total_brandsnumber
min_total_asinsnumber
max_total_asinsnumber
min_total_observed_buybox_daysnumber
max_total_observed_buybox_daysnumber
min_operator_fba_share_pctnumber
max_operator_fba_share_pctnumber
min_avg_ratingnumber
max_avg_ratingnumber
min_avg_rating_countnumber
max_avg_rating_countnumber

brands_gaining_sellers

Find brands that recently gained the most newly-OBSERVED sellers (sellers whose first-seen date on the brand falls in the window) — an observation signal, NOT confirmed market entry (sparse re-sampling can resurface long-present sellers as 'new'). Optional category filter. Use when the user asks 'brands gaining sellers in [category]', 'brands under hijacker pressure', 'who is seeing new entrants this month', or category-scoped seller-growth signals without naming a specific brand.

Parameters (17)

window_daysinteger
Days back (default 30, max 90).
categorystring
min_new_sellersinteger
Minimum new-seller count to surface (default 2).
limitinteger
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
scopestring
tracked = only brands on the user's watchlist; universe = all brands. Default universe.
max_newly_observed_sellers_in_windownumber
Upper bound on new-seller count (min is min_new_sellers).
brandstring
Exact brand match (case-insensitive).
brand_containsstring
min_total_sellers_3mnumber
max_total_sellers_3mnumber
min_control_scorenumber
max_control_scorenumber
min_seller_churn_30d_pctnumber
max_seller_churn_30d_pctnumber
min_catalog_churn_30d_pctnumber
max_catalog_churn_30d_pctnumber

operator_brands_by_competition

Given one or more operator (seller) names, return the brands they carry ranked by seller competition level. Use when the user asks 'which brands sold by these operators have the least competition', 'out of these operators, show me brands with fewest sellers', 'low-competition brands for operator X', or any follow-up that chains operator names to brand-level competition metrics.

Parameters (14)

operator_namesarrayrequired
List of seller/operator names to look up.
sortstring
Sort by competitor count: 'asc' (least competition first, default) or 'desc'.
limitinteger
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
brandstring
Exact brand (case-insensitive).
brand_containsstring
min_competitor_countnumber
max_competitor_countnumber
min_asin_countnumber
max_asin_countnumber
min_observed_buybox_days_3mnumber
max_observed_buybox_days_3mnumber
min_operator_fba_share_pctnumber
max_operator_fba_share_pctnumber

find_undercompeted_brands

Find brands with low seller competition but real sales presence. The flagship sourcing discovery tool. Use when the user asks 'find brands with few sellers', 'low competition brands', 'undercompeted brands under $50', 'brands I could source with little competition', or any variant of 'find me something to sell'. Pass seed_brand when user mentions a reference brand ('brands like Ninja', 'low competition in the same category as OXO') to constrain results to the same root category.

Parameters (18)

max_sellersinteger
Maximum unique sellers (competition ceiling). Default 20.
min_sellersinteger
Minimum unique sellers (default 10). Drops single-seller / brand-owner-only 'PL junk' so results show proven multi-seller demand (the default 10–20 window: under-competed but real).
min_buybox_daysinteger
Minimum observed buybox days in last 3 months (sales floor). Default 30.
max_avg_pricenumber
Maximum average buybox price in USD. Omit for no price filter.
min_avg_pricenumber
Minimum average buybox price in USD. Omit for no price filter.
seed_brandstring
Reference brand to derive category from. Results stay in the same root category.
category_idinteger
Filter to a specific root category ID. Overrides seed_brand if both given.
include_catchallboolean
Include reseller umbrella brands (PATIKIL, Uxcell, etc.). Default false.
limitinteger
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
brandstring
Exact brand match (case-insensitive).
brand_containsstring
min_asin_countnumber
max_asin_countnumber
min_control_scorenumber
max_control_scorenumber
min_velocity_90dnumber
max_velocity_90dnumber

operator_compare

ASIN-level buy-box head-to-head between two operators (sellers). For the ASINs BOTH carry (contested), returns who holds the buy-box (winner), each operator's buy-box share, their sanitized average prices and the price gap, how many OTHER sellers are on the listing, whether Amazon holds the box, and a `situation` tag (amazon_in_box | reseller_swarm | tied_price | price_gap) — plus operator_a's estimated 30-day revenue-at-risk. Also returns each side's WHITESPACE: high-revenue ASINs that operator wins which the OTHER doesn't carry (expansion targets). Use when the user asks 'compare seller A vs seller B', 'where do these two sellers overlap / compete', 'who wins the buy-box between them', 'show me the head-to-head', or 'what does A sell that B doesn't'. Sortable by revenue-at-risk (default), price gap, or share gap.

Parameters (10)

operator_astringrequired
First operator/seller name (the focal seller — revenue-at-risk + situation are from A's view).
operator_bstringrequired
Second operator/seller name.
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default).
limitinteger
Contested ASINs to return (default 25, max 100). This tool pages.
sortstring
Sort the contested list: revenue_at_risk (operator_a's 30d revenue at risk, default), price_gap (abs A-vs-B price gap), or share_gap (abs buy-box share gap).
min_est_revenue_30dnumber
Only contested ASINs with estimated 30-day listing revenue >= this.
contested_onlyboolean
If true, skip the whitespace sections (only the head-to-head contested list).
include_whitespaceboolean
Include each side's whitespace ASINs (default true).
whitespace_forstring
Which side's whitespace to compute (default both).
brandstring
Optional — scope the comparison to a single brand's ASINs (catalog sizes, contested, and whitespace are all limited to that brand). Omit for all brands.

brand_buybox_trajectory

Show how a brand's buybox concentration has changed over time. Returns weekly seller counts and observed buybox days for the trailing window. Use when the user asks 'is this brand getting more competitive', 'concentration trend for Nike', 'how has seller count changed over time', or 'buybox trajectory'.

Parameters (16)

brandstringrequired
Brand name (case-insensitive).
since_weeksinteger
Weeks of history to return (default 26, max 52).
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
trend_instring
Comma-separated trend labels to keep: CONCENTRATING, DECONCENTRATING, STABLE, INSUFFICIENT_DATA. If the brand's trend isn't in the list, an empty result is returned.
min_seller_count_change_pctnumber
max_seller_count_change_pctnumber
week_start_fromstring
Keep only timeline weeks on/after this YYYY-MM-DD.
week_start_tostring
min_seller_countnumber
Keep only timeline weeks with at least this seller_count.
max_seller_countnumber
min_observed_buybox_daysnumber
max_observed_buybox_daysnumber
min_asins_touchednumber
max_asins_touchednumber
min_observationsnumber
max_observationsnumber

category_undercompeted_brands

Find specific BRANDS within a category that have proven multi-seller demand but are still under-competed (a min-seller floor drops single-seller / brand-owner-only listings). Returns BRANDS — not niches or sub-categories. Use for 'undercompeted brands in <category>', 'low competition brands in Toys', 'which brands can I source in <category>'. Do NOT use for 'under-served niches', 'niches in <category>', or 'find a niche to enter' — those are SUBCATEGORY questions; use find_underserved_niches instead.

Parameters (17)

category_idinteger
Root category ID to search within.
category_namestring
Category name (fuzzy match if category_id not provided).
max_sellersinteger
Maximum unique sellers (default 20).
min_sellersinteger
Minimum unique sellers (default 10). Drops single-seller / brand-owner-only 'PL junk' so results show proven multi-seller demand.
min_buybox_daysinteger
Minimum observed buybox days in last 3 months (default 30).
max_avg_pricenumber
Maximum average price in USD. Omit for no cap.
min_avg_pricenumber
Minimum average price in USD. Omit for no floor.
limitinteger
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
brandstring
Exact brand match (case-insensitive).
brand_containsstring
min_asin_countnumber
max_asin_countnumber
min_control_scorenumber
max_control_scorenumber
min_velocity_90dnumber
max_velocity_90dnumber

unauthorized_sellers

List the sellers winning a brand's buy box — the resellers and arbitrage operators you're up against — each classified (authorized-retailer / arbitrage / Amazon / brand-direct / reseller). If you've saved an authorized list (authorized_seller_set) it instead flags the UNAUTHORIZED sellers. Use when the user asks 'which operators dominate the buy box on <brand>', 'who else is selling my brand', 'unauthorized sellers on Nike', 'find rogue sellers', or any brand buy-box / protection question.

Parameters (17)

brandstringrequired
Brand name (case-insensitive).
authorized_sellersarray
Optional. Authorized seller names — sellers NOT in this list are flagged. If omitted (and none saved), all buy-box-winning sellers are returned, classified.
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
limitinteger
seller_namestring
Exact seller name (case-insensitive).
seller_name_containsstring
min_observed_buybox_daysnumber
max_observed_buybox_daysnumber
min_asins_touchednumber
max_asins_touchednumber
min_avg_pricenumber
max_avg_pricenumber
first_seen_fromstring
YYYY-MM-DD.
first_seen_tostring
last_seen_fromstring
last_seen_tostring
operator_type_instring
Comma-separated classifications to keep (cold path only, when no authorized list is set): e.g. arbitrage, reseller, amazon, brand-direct, authorized-retailer.

operator_new_brands

Show brands an operator recently started selling. Use when the user asks 'what new brands did this seller pick up', 'operator new brands', 'what is Amazon Warehouse selling now that it wasn't before', or any question about an operator expanding their catalog.

Parameters (8)

operator_namestringrequired
Seller/operator name.
since_daysinteger
How far back to look for new brands (default 30, max 180).
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
limitinteger
brandstring
Exact brand (case-insensitive).
brand_containsstring
first_seen_fromstring
YYYY-MM-DD lower bound on first_seen.
first_seen_tostring

operator_lost_brands

Show brands an operator recently stopped selling (churn signal). Use when the user asks 'what brands did this seller drop', 'operator churn', 'brands lost by X', or any question about an operator shrinking their catalog.

Parameters (10)

operator_namestringrequired
Seller/operator name.
since_daysinteger
Window to compare (default 30, max 180). Brands present before but absent in the last since_days.
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
limitinteger
brandstring
Exact brand (case-insensitive).
brand_containsstring
last_seen_week_fromstring
YYYY-MM-DD lower bound on last_seen_week.
last_seen_week_tostring
first_seen_fromstring
first_seen_tostring

operator_category_dominance

Show which product categories an operator dominates. Returns categories ranked by the operator's brand count and observed buybox days in each. Use when the user asks 'what categories does this seller focus on', 'operator category breakdown', 'where does Amazon Warehouse dominate', or any category-scoped operator question.

Parameters (11)

operator_namestringrequired
Seller/operator name.
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
limitinteger
category_namestring
Exact category name (case-insensitive).
category_name_containsstring
min_brand_countnumber
max_brand_countnumber
min_total_asinsnumber
max_total_asinsnumber
min_total_observed_buybox_daysnumber
max_total_observed_buybox_daysnumber

find_single_seller_brands

Find brands where a single operator controls 100 percent of observed buybox days. These are either gated/exclusive or operator-acquired brands. Use when the user asks 'brands with one seller', 'exclusive brands', 'single-seller brands', 'monopoly brands', or any question about brands with no competition.

Parameters (13)

min_asinsinteger
Minimum ASINs to filter out trivially small brands (default 10).
min_buybox_daysinteger
Minimum observed buybox days in last 3 months (default 30).
max_avg_pricenumber
Maximum average price in USD. Omit for no cap.
min_avg_pricenumber
Minimum average price in USD. Omit for no floor.
category_idinteger
Filter to a specific root category. Omit for all.
limitinteger
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
brandstring
Exact brand match (case-insensitive).
brand_containsstring
dominant_sellerstring
Exact dominant-seller name (case-insensitive).
dominant_seller_containsstring
min_control_scorenumber
max_control_scorenumber

operator_xmarket_presence

Check whether an operator sells on Amazon US, Amazon UK, and/or Walmart. Returns per-marketplace brand count, ASIN count, and observed buybox days. Use when the user asks 'does this seller sell on Walmart too', 'cross-marketplace presence', 'is this operator on Amazon UK', or any multi-marketplace operator question.

Parameters (1)

operator_namestringrequired
Seller/operator name.

brand_xmarket

Check whether a brand sells on Amazon US, Amazon UK, and/or Walmart. Returns per-marketplace seller count, ASIN count, observed buybox days, and control score. Use when the user asks 'does this brand sell on Walmart', 'cross-marketplace presence for Nike', 'is this brand on Amazon UK', or any multi-marketplace brand question.

Parameters (10)

brandstringrequired
Brand name (case-insensitive).
marketplace_id_instring
Comma-separated marketplace ids to keep: 1=Amazon UK, 2=Amazon US, 3=Walmart US.
min_seller_countnumber
max_seller_countnumber
min_asin_countnumber
max_asin_countnumber
min_observed_buybox_daysnumber
max_observed_buybox_daysnumber
min_control_scorenumber
max_control_scorenumber

find_new_operators

Find operators (sellers) we FIRST OBSERVED selling recently — their earliest observation in our data falls in the window. An observation signal, NOT confirmed market entry: sparse sampling can surface a long-present seller the first time we see them. Different from top_expanding_operators (existing operators adding brands). Use when the user asks 'new sellers this month', 'who just started selling', 'newly seen operators', or any question about emerging/newly-observed sellers.

Parameters (18)

since_daysinteger
How far back to look (default 30, max 180).
min_brandsinteger
Minimum brands to filter out trivial sellers (default 5).
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
limitinteger
seller_namestring
Exact seller name (case-insensitive).
seller_name_containsstring
earliest_seen_fromstring
YYYY-MM-DD lower bound on earliest-seen date.
earliest_seen_tostring
min_total_asinsnumber
max_total_asinsnumber
min_total_observed_buybox_daysnumber
max_total_observed_buybox_daysnumber
min_operator_fba_share_pctnumber
max_operator_fba_share_pctnumber
min_avg_ratingnumber
max_avg_ratingnumber
min_avg_rating_countnumber
max_avg_rating_countnumber

find_deconcentrating_brands

Find brands where buybox concentration dropped over the last quarter — more sellers are entering, creating opportunity for new entrants. Use when the user asks 'brands losing control', 'deconcentrating brands', 'brands opening up to competition', 'gentrification opportunities', or any question about brands becoming less monopolized.

Parameters (16)

since_weeksinteger
Window to compare (default 12, max 26). Compares first half vs second half.
min_buybox_daysinteger
Minimum observed buybox days to filter out inactive brands (default 30).
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
limitinteger
brandstring
Exact brand match (case-insensitive).
brand_containsstring
min_old_seller_countnumber
max_old_seller_countnumber
min_new_seller_countnumber
max_new_seller_countnumber
min_seller_growth_pctnumber
max_seller_growth_pctnumber
min_asin_countnumber
max_asin_countnumber
min_control_scorenumber
max_control_scorenumber

brand_under_attack

Detect whether a brand is under competitive attack: an elevated NEW-ENTRANT RATE (brand-level newly-observed sellers vs the trailing-month baseline) combined with buy-box churn. Uses brand-level first-seen (a seller's first observation anywhere across the brand's ASINs), which is stable under scraper-coverage growth — not the inflated per-ASIN count. Use when the user asks 'is my brand being targeted', 'brand under attack', 'new sellers flooding my listings', 'is someone targeting this brand'.

Parameters (5)

brandstringrequired
Brand name (case-insensitive).
since_weeksinteger
Window to analyze (default 4, max 12).
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
threat_level_instring
Comma-separated threat levels to keep: HIGH, MODERATE, LOW. If the brand's level isn't in the list, an empty result is returned.
signals_instring
Comma-separated signals that must be present: NEW_ENTRANT_SURGE, HIGH_BUYBOX_CHURN. Matches if the brand has any of them.

operator_top_asins

Show the ASINs an operator wins the buybox on most often, ranked by ESTIMATED 30-day sales by default. For each ASIN it returns the operator's estimated units sold and revenue in the last 30 days (est_units_30d, est_revenue_30d — the product's sales estimate weighted by the operator's buy-box share) plus the operator's BUYBOX SHARE (percent of observed days it held the buybox; normalized, not raw days). Sortable by est_sales (default), observed buybox days won, price, or days seen. Use when the user asks 'what ASINs does this seller win on', 'top ASINs for operator X', 'what does this seller sell the most of', 'best products for this seller', or any ASIN-level operator drill-down. Each ASIN also carries product brand, title, and price (or price range) plus its fulfillment (FBA/FBM/AMZ + amz/fba pct).

Parameters (33)

operator_namestringrequired
Seller/operator name.
sortstring
Sort order: est_sales (estimated 30-day revenue, default), buybox_days (observed buybox days won), price, or days_seen.
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
limitinteger
Number of ASINs to return (default 10, max 50).
min_buybox_share_pctnumber
Only ASINs where the operator's buybox share >= this.
max_buybox_share_pctnumber
min_observed_buybox_daysnumber
max_observed_buybox_daysnumber
min_days_seennumber
max_days_seennumber
min_est_units_30dnumber
max_est_units_30dnumber
min_est_revenue_30dnumber
max_est_revenue_30dnumber
min_buybox_avg_pricenumber
max_buybox_avg_pricenumber
est_basis_instring
Comma-separated sales-estimate sources to keep.
asinstring
Exact ASIN match.
asin_containsstring
first_seen_fromstring
YYYY-MM-DD.
first_seen_tostring
last_seen_fromstring
last_seen_tostring
product_brandstring
Exact product brand (case-insensitive).
product_brand_containsstring
product_title_containsstring
min_pricenumber
max_pricenumber
fulfillment_instring
Comma-separated FBA/FBM/AMZ to keep.
min_fulfillment_amz_dom_pctnumber
max_fulfillment_amz_dom_pctnumber
min_fulfillment_fba_pen_pctnumber
max_fulfillment_fba_pen_pctnumber

operator_top_brands

Show the brands an operator sells the most of, ranked by ESTIMATED 30-day sales by default. For each brand the operator carries it returns the operator's estimated units sold and revenue in the last 30 days (est_units_30d, est_revenue_30d — the estimated sales of the ASINs the operator wins for that brand, weighted by its buy-box share), the number of the brand's ASINs the operator wins, and observed buybox days. Use when the user asks 'what brands does this seller sell the most of', 'top brands for operator X', 'which brands make this seller the most money', or any brand-level operator drill-down by sales. For brand competition (fewest sellers) instead of sales, use operator_brands_by_competition.

Parameters (14)

operator_namestringrequired
Seller/operator name.
sortstring
Sort order: est_sales (estimated 30-day revenue, default), est_units, buybox_days (observed buybox days), or asin_count.
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
limitinteger
brandstring
Exact brand (case-insensitive).
brand_containsstring
min_asin_countnumber
max_asin_countnumber
min_observed_buybox_daysnumber
max_observed_buybox_daysnumber
min_est_units_30dnumber
max_est_units_30dnumber
min_est_revenue_30dnumber
max_est_revenue_30dnumber

brand_similar

Find brands similar to a given brand by category, price tier, and competition level. Use when the user asks 'brands like Nike', 'similar brands to source', 'show me comparable brands', 'what else is in this niche', or any cohort/lookalike question.

Parameters (14)

brandstringrequired
Reference brand name (case-insensitive).
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
limitinteger
min_seller_countnumber
Only similar brands with at least this many unique sellers (3m).
max_seller_countnumber
min_asin_countnumber
max_asin_countnumber
min_buybox_days_3mnumber
max_buybox_days_3mnumber
min_control_scorenumber
max_control_scorenumber
min_avg_pricenumber
max_avg_pricenumber
brand_containsstring
Only keep similar brands whose name contains this substring.

brand_new_asins

Show ASINs that recently appeared for a brand. Use when the user asks 'new products for Nike', 'recently added ASINs', 'what new listings does this brand have', or any question about a brand's recent catalog additions. Each ASIN carries product brand, title, price (or price range) and fulfillment (FBA/FBM/AMZ + amz/fba pct).

Parameters (26)

brandstringrequired
Brand name (case-insensitive).
since_daysinteger
How far back to look (default 30, max 180).
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
limitinteger
asinstring
Exact ASIN match.
asin_containsstring
first_seen_fromstring
YYYY-MM-DD (since_days already bounds the lower edge).
first_seen_tostring
last_seen_fromstring
last_seen_tostring
min_seller_countnumber
max_seller_countnumber
min_latest_pricenumber
max_latest_pricenumber
latest_buybox_sellerstring
Exact most-recent buy-box seller (case-insensitive).
latest_buybox_seller_containsstring
product_brandstring
Exact product brand (case-insensitive).
product_brand_containsstring
product_title_containsstring
min_pricenumber
max_pricenumber
fulfillment_instring
Comma-separated FBA/FBM/AMZ to keep.
min_fulfillment_amz_dom_pctnumber
max_fulfillment_amz_dom_pctnumber
min_fulfillment_fba_pen_pctnumber
max_fulfillment_fba_pen_pctnumber

category_top_growers

Find brands in a category with the biggest recent growth in seller count and observations. Use when the user asks 'fastest growing brands in Toys', 'top growers in this category', 'which brands are trending up', or any category-scoped growth question.

Parameters (19)

category_idinteger
Root category ID.
category_namestring
Category name (fuzzy match if category_id not provided).
since_monthsinteger
Months to compare (default 3, max 6). Compares latest month vs earliest.
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
limitinteger
brandstring
Exact brand match (case-insensitive).
brand_containsstring
min_recent_observationsnumber
max_recent_observationsnumber
min_prior_observationsnumber
max_prior_observationsnumber
min_obs_growth_pctnumber
max_obs_growth_pctnumber
min_recent_sellersnumber
max_recent_sellersnumber
min_prior_sellersnumber
max_prior_sellersnumber
min_seller_growth_pctnumber
max_seller_growth_pctnumber

category_new_entrants

Find brands newly OBSERVED in a category — the first date our daily sampling saw the brand there falls in the window. An observation signal, NOT confirmed first-ever entry (sparse re-sampling can resurface a long-present brand as 'new'). Use when the user asks 'new brands in Electronics', 'what brands just entered this category', 'emerging brands in Toys', 'category new entrants'.

Parameters (17)

category_idinteger
Root category ID.
category_namestring
Category name (fuzzy match if category_id not provided).
since_daysinteger
How far back to look (default 30, max 180).
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
limitinteger
brandstring
Exact brand match (case-insensitive).
brand_containsstring
first_observed_fromstring
YYYY-MM-DD lower bound on first-observed date.
first_observed_tostring
min_seller_countnumber
max_seller_countnumber
min_asin_countnumber
max_asin_countnumber
min_buybox_days_3mnumber
max_buybox_days_3mnumber
min_avg_pricenumber
max_avg_pricenumber

category_metrics

Return the full metric set for ONE category at any depth — a root OR a sub-category niche like 'Terrariums'. Covers demand (30-day revenue, units, velocity tier), competition (heat, diversity, brand/ASIN/seller counts), Amazon presence (retail dominance, private-label share, FBA penetration, 90-day brand expansion), price, ship-by days, and close-outs. Use for 'show me the metrics/stats for category X', 'how big is the X category', or to pull the numbers behind a niche question.

Parameters (3)

category_idinteger
Exact category id (any depth).
category_namestring
Category name (any depth, fuzzy).
marketplace_idinteger
1=UK, 2=US, 3=Walmart. Default 2 (US).

evaluate_category_for_private_label

Assess whether a category or niche (ANY depth — e.g. 'Terrariums') is winnable for a NEW private-label brand. Use for 'is X winnable for private label', 'should I private-label X', 'is the X niche good for a new brand', 'can I launch my own brand in X'. Returns a per-signal pass/fail breakdown and a Strong / Moderate / Weak verdict based on Amazon's footprint, seller fragmentation, demand, and price band.

Parameters (4)

category_idinteger
Exact category id (any depth).
category_namestring
Category/niche name (any depth, fuzzy).
marketplace_idinteger
1=UK, 2=US, 3=Walmart. Default 2 (US).
verdict_instring
Comma-separated verdicts to keep (Strong/Moderate/Weak).

find_underserved_niches

Find UNDER-SERVED NICHES — real SUBCATEGORIES with genuine demand but room to compete, ranked by private-label winnability from 2-year marketplace data. Returns CATEGORIES / sub-categories (e.g. 'Wireless Earbuds', 'Cable Organizers'), NEVER brands. This is the RIGHT tool for ANY niche-discovery question: 'under-served niches', 'niches in <category>', 'find a niche to enter', 'what niche should I sell in', 'underserved categories', 'gaps in <department>', 'where's the opportunity in <category>'. When the user names a department or category (e.g. 'electronics', 'home & kitchen'), pass it as category_name to scope the niches to that area. Do NOT use category_undercompeted_brands or find_undercompeted_brands for niche questions — those return BRANDS, not niches.

Parameters (21)

category_namestring
Department/category to find niches within (e.g. 'electronics', 'home & kitchen', 'pet supplies'). Omit for niches across all departments.
category_idinteger
Root category id to scope to (overrides category_name).
price_minnumber
Minimum average price USD (default 20 — the PL margin band).
price_maxnumber
Maximum average price USD (default 70 — the PL margin band).
competitionstring
'low' (stricter Amazon-presence ceiling) or 'balanced' (default).
unhappy_shoppersboolean
Bias toward niches where shoppers are underwhelmed (a credible dissatisfaction gap = a PL opening). Default false.
limitinteger
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
nichestring
Exact niche (subcategory) name, case-insensitive.
niche_containsstring
pl_winnability_instring
Comma-separated verdicts to keep (Strong/Moderate/Weak).
min_monthly_demand_usdnumber
max_monthly_demand_usdnumber
min_amazon_retail_share_pctnumber
max_amazon_retail_share_pctnumber
min_competing_brandsnumber
max_competing_brandsnumber
min_seller_diversitynumber
max_seller_diversitynumber
min_avg_product_ratingnumber
max_avg_product_ratingnumber

asin_comparables

Find ASINs similar to a given ASIN by brand, price band, and seller count. Use when the user asks 'ASINs like this one', 'similar products', 'comparable ASINs', 'what else is like B08N5WRWNW', or any ASIN-level lookalike question. Each comparable carries product brand, title, price (or price range) and fulfillment (FBA/FBM/AMZ + amz/fba pct).

Parameters (19)

asinstringrequired
Reference ASIN (e.g. B08N5WRWNW).
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
limitinteger
min_seller_countnumber
Only comparables with at least this many distinct sellers.
max_seller_countnumber
min_days_observednumber
max_days_observednumber
buybox_sellerstring
Exact buy-box seller name (case-insensitive).
buybox_seller_containsstring
product_brandstring
Exact product brand (case-insensitive).
product_brand_containsstring
product_title_containsstring
min_pricenumber
max_pricenumber
fulfillment_instring
Comma-separated FBA/FBM/AMZ to keep.
min_fulfillment_amz_dom_pctnumber
max_fulfillment_amz_dom_pctnumber
min_fulfillment_fba_pen_pctnumber
max_fulfillment_fba_pen_pctnumber

asin_buybox_history

Show which sellers have been winning the buybox for an ASIN over time, AND how the competing-seller pool has changed month over month. Returns a per-week breakdown of buybox winners; a monthly distinct-seller-count series (seller_count_monthly, trailing ~6 months) plus a seller_trend label (stable/rising/falling) so you can say whether the seller pool is stable or volatile (more sellers piling on vs consolidating); plus the ASIN's product brand, title and price (or price range) and its fulfillment (FBA/FBM/AMZ). Use when the user asks 'who has been winning buybox on this ASIN', 'buybox history for B08N5WRWNW', 'seller rotation', 'has the buybox owner changed', 'is the seller pool stable or volatile', 'are more sellers piling onto this listing', or any ASIN buybox/seller timeline.

Parameters (27)

asinstringrequired
ASIN to look up (e.g. B08N5WRWNW).
since_weeksinteger
Weeks of history (default 26, max 52).
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
seller_namestring
Exact buy-box seller name (case-insensitive).
seller_name_containsstring
min_observed_buybox_daysnumber
Only sellers with at least this many observed buy-box days.
max_observed_buybox_daysnumber
min_days_seennumber
max_days_seennumber
min_buybox_avg_pricenumber
max_buybox_avg_pricenumber
first_seen_fromstring
YYYY-MM-DD.
first_seen_tostring
last_seen_fromstring
last_seen_tostring
min_seller_countnumber
max_seller_countnumber
product_brandstring
Exact product brand (case-insensitive).
product_brand_containsstring
product_title_containsstring
min_pricenumber
max_pricenumber
fulfillment_instring
Comma-separated FBA/FBM/AMZ to keep.
min_fulfillment_amz_dom_pctnumber
max_fulfillment_amz_dom_pctnumber
min_fulfillment_fba_pen_pctnumber
max_fulfillment_fba_pen_pctnumber

asin_profit_calc

Estimate whether an ASIN can hit a target profit margin given current buybox price, estimated FBA fees, and Amazon referral fee. Use when the user asks 'can I make money on this ASIN', 'profit calculator', 'margin estimate for B08N5WRWNW', 'is this ASIN profitable to sell', or any margin/profit question. Also returns product brand, title, price (or price range) and fulfillment (FBA/FBM/AMZ + amz/fba pct) for the ASIN.

Parameters (4)

asinstringrequired
ASIN to analyze (e.g. B08N5WRWNW).
target_margin_pctnumber
Target profit margin percentage (default 20).
cogsnumber
Your cost of goods in USD. If omitted, the tool estimates breakeven COGS.
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)

watchlist_delta

Show what changed on the user's sourcing watchlist since last check. Returns each tracked ASIN with its score delta plus product identity (brand, title, price or price range) and fulfillment (FBA/FBM/AMZ with amz/fba share). Use when the user asks 'what changed on my watchlist', 'watchlist updates', 'any changes this week', or any watchlist-status question.

Parameters (21)

since_daysinteger
How far back to look for changes (default 7, max 30).
marketplace_idinteger
Marketplace to scope to: 1 = Amazon UK, 2 = Amazon US (default), 3 = Walmart US. One marketplace per call.
limitinteger
min_current_scorenumber
Only tracked ASINs with current sourcing score >= this.
max_current_scorenumber
min_previous_scorenumber
max_previous_scorenumber
min_score_deltanumber
max_score_deltanumber
asinstring
Exact ASIN match.
asin_containsstring
product_brandstring
Exact product brand (case-insensitive).
product_brand_containsstring
product_title_containsstring
min_pricenumber
max_pricenumber
fulfillment_instring
Comma-separated FBA/FBM/AMZ to keep.
min_fulfillment_amz_dom_pctnumber
max_fulfillment_amz_dom_pctnumber
min_fulfillment_fba_pen_pctnumber
max_fulfillment_fba_pen_pctnumber

watchlist_add_rule

Resolve a natural-language watchlist request into concrete ASINs the user can add. Use when the user says 'watch this brand', 'alert me when X loses a seller', 'add Nike to my watchlist', or any watchlist-creation intent. Returns matching ASINs with current scores plus product identity (brand, title, price or price range) and fulfillment (FBA/FBM/AMZ with amz/fba share) so the user can confirm which to add.

Parameters (19)

brandstring
Brand name to find watchable ASINs for.
asinstring
Specific ASIN to add. If provided, brand is ignored.
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
limitinteger
min_composite_scorenumber
Only candidates with sourcing composite score >= this.
max_composite_scorenumber
min_buybox_avg_pricenumber
max_buybox_avg_pricenumber
min_observed_buybox_daysnumber
max_observed_buybox_daysnumber
asin_containsstring
product_title_containsstring
min_pricenumber
max_pricenumber
fulfillment_instring
Comma-separated FBA/FBM/AMZ to keep.
min_fulfillment_amz_dom_pctnumber
max_fulfillment_amz_dom_pctnumber
min_fulfillment_fba_pen_pctnumber
max_fulfillment_fba_pen_pctnumber

watchlist_stats

BULK report of key Amazon stats for the user's WHOLE watchlist in ONE call — every tracked ASIN in the workspace's sourcing watchlist for a marketplace, in a single pass. Use this report instead of looping a per-ASIN tool over the whole watchlist. Each tracked ASIN returns its composite sourcing score, distinct seller count, buy-box leader share, fulfillment (FBA/FBM/AMZ with amz/fba pct), product brand/title and price (or price range). Also returns a top-level summary across the whole watchlist (tracked total, scored count, average score, score buckets, Amazon-dominant / FBA-dominant counts, single-seller vs high-competition counts). Use when the user asks 'show stats for my whole watchlist', 'summarize my watchlist', 'which of my tracked ASINs are single-seller / Amazon-dominant / high-competition', 'score distribution of my watchlist', or any bulk watchlist overview. One call covers the entire watchlist — do NOT call a per-ASIN tool in a loop.

Parameters (20)

marketplace_idinteger
Marketplace to scope to: 1 = Amazon UK, 2 = Amazon US (default), 3 = Walmart US. One marketplace per call.
sortstring
Sort order (all descending): score (composite sourcing score, default), seller_count (distinct sellers), buybox_share (buy-box leader share), amz_dominance, fba_penetration, or price.
limitinteger
min_composite_scorenumber
Only tracked ASINs with composite sourcing score >= this.
max_composite_scorenumber
min_seller_countnumber
Only ASINs with >= this many distinct sellers.
max_seller_countnumber
min_buybox_share_pctnumber
Only ASINs where the buy-box leader's share >= this percent.
max_buybox_share_pctnumber
min_amz_dominance_pctnumber
Only ASINs with Amazon buy-box dominance >= this percent.
max_amz_dominance_pctnumber
min_fba_penetration_pctnumber
Only ASINs with FBA penetration >= this percent.
max_fba_penetration_pctnumber
min_pricenumber
max_pricenumber
fulfillment_instring
Comma-separated FBA/FBM/AMZ to keep.
product_brandstring
Exact product brand (case-insensitive).
product_brand_containsstring
asinstring
Exact ASIN match.
asin_containsstring

watchlist_webwide

Bulk web-wide (open-web / off-Amazon) price + MAP findings across your whole watchlist, in one call — reads already-collected results, does not run a live scan. Returns every tracked ASIN with its open-web source count, cheapest off-Amazon price (+ the domain), how many web sources violate MAP, how many are unauthorized sellers, the Amazon buy-box anchor price, and how much cheaper the web is vs Amazon. ASINs not yet scanned show 0 sources / never-scanned. Use for 'where is my whole watchlist cheaper off Amazon', 'web-wide MAP across everything I track', or 'which tracked products are undercut on the open web'. For a live single-product cross-retailer check use find_product_across_web instead.

Parameters (16)

marketplace_idinteger
Marketplace to scope the watchlist to: 1 = Amazon UK, 2 = Amazon US (default), 3 = Walmart US.
sortstring
Order: web_violations (most MAP breaches first), cheapest_web_price, web_savings_vs_amazon (biggest off-Amazon discount first), last_scan.
limitinteger
min_web_source_countnumber
Only ASINs with at least this many distinct open-web sources.
max_web_source_countnumber
min_web_violation_countnumber
Only ASINs with at least this many MAP-violating web sources.
max_web_violation_countnumber
min_cheapest_web_pricenumber
max_cheapest_web_pricenumber
violations_onlyboolean
Keep only ASINs with one or more web MAP violations.
unauthorized_onlyboolean
Keep only ASINs with one or more unauthorized web sellers.
domain_containsstring
Substring match on the cheapest-source domain.
asinstring
Exact ASIN match.
asin_containsstring
product_brandstring
Exact product brand (case-insensitive).
product_brand_containsstring

map_violations_today

Show active MAP (Minimum Advertised Price) violations for products in the workspace. Use when the user asks 'MAP violations', 'who is selling below MAP', 'price violations today', 'are there any MAP breaches', or any MAP-enforcement question.

Parameters (18)

brandstring
Filter to a specific brand. Omit for all workspace brands.
min_violation_pctnumber
Minimum violation percentage below MAP (default 0, meaning any violation).
limitinteger
max_violation_pctnumber
Maximum violation percentage below MAP.
brand_containsstring
Substring match on brand (use `brand` for an exact match).
product_title_containsstring
retailer_domainstring
Exact retailer domain (case-insensitive).
retailer_domain_containsstring
retailer_namestring
Exact retailer name (case-insensitive).
retailer_name_containsstring
min_observed_price_usdnumber
max_observed_price_usdnumber
min_map_floor_usdnumber
max_map_floor_usdnumber
first_seen_fromstring
YYYY-MM-DD.
first_seen_tostring
last_seen_fromstring
last_seen_tostring

filter_operators_by_fba_share

Return operators whose FBA buybox share is below or above a threshold. FBA share is 0-100 (percentage). Use fba_share < 50 to find FBM-leaning operators (likely carrying real inventory) or fba_share > 80 for FBA-heavy flippers. Supports optional brand filter to narrow to operators selling a specific brand.

Parameters (20)

marketplace_idintegerrequired
1 = Amazon UK, 2 = Amazon US (default)
fba_share_opstringrequired
Comparison operator for FBA share threshold.
fba_share_valuenumberrequired
FBA share threshold (0-100, percentage).
brandstring
Optional — filter to operators selling this brand.
sort_bystring
Sort column (default buybox_days).
limitinteger
seller_namestring
Exact seller/operator name (case-insensitive).
seller_name_containsstring
min_brands_touchednumber
max_brands_touchednumber
min_asins_touchednumber
max_asins_touchednumber
min_observed_buybox_daysnumber
max_observed_buybox_daysnumber
min_sold_30d_revenuenumber
max_sold_30d_revenuenumber
min_avg_ratingnumber
max_avg_ratingnumber
min_avg_rating_countnumber
max_avg_rating_countnumber

filter_brands_by_fba_share

Return brands whose FBA buybox share is below or above a threshold. FBA share is computed as fba_buybox_days / total_buybox_days * 100 (percentage, 0-100). Use fba_share < 40 to find FBM-heavy brands (carriers hold real inventory) or fba_share > 80 for FBA-dominated brands. Supports sort by control_score (heat), unique_sellers, or brand_bought_past_month_30d.

Parameters (18)

marketplace_idintegerrequired
1 = Amazon UK, 2 = Amazon US (default)
fba_share_opstringrequired
Comparison operator for FBA share threshold.
fba_share_valuenumberrequired
FBA share threshold (0-100, percentage).
min_sourcing_scoreinteger
Optional — minimum control_score (heat) filter.
sort_bystring
Sort column (default control_score).
limitinteger
brandstring
Exact brand match (case-insensitive).
brand_containsstring
min_control_scorenumber
max_control_scorenumber
min_winner_diversitynumber
max_winner_diversitynumber
min_unique_sellers_3mnumber
max_unique_sellers_3mnumber
min_asins_touched_3mnumber
max_asins_touched_3mnumber
min_amz_retail_dominance_pctnumber
max_amz_retail_dominance_pctnumber

brands_in_operator_network

Find brands that share operators/sellers with a target brand. Returns brands ranked by how many operators they share. Use when the user asks 'what brands are in X's network?', 'brands related to Ninja', 'who else do Ninja's sellers carry?', 'brands in the same seller network', or 'brand family'. This reveals the operator graph — brands connected through shared distribution channels.

Parameters (12)

brandstringrequired
The target brand to find network connections for.
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
limitinteger
brand_containsstring
Only keep related brands whose name contains this substring.
min_shared_operatorsnumber
Only related brands sharing at least this many operators.
max_shared_operatorsnumber
min_observed_buybox_daysnumber
max_observed_buybox_daysnumber
min_seller_countnumber
max_seller_countnumber
min_control_scorenumber
max_control_scorenumber

search_products

Free-text keyword search over Amazon product titles + descriptions. Use when the user names a PRODUCT TYPE or keywords (e.g. 'stainless steel water bottle', 'cat litter box', 'magnetic phone mount') rather than a specific brand, category, or ASIN. Returns the top matching products ranked by relevance with brand, price, 30-day demand, fulfillment (FBA/Amazon/FBM) and rating. Optional filters narrow the result by any returned field: product_brand, min/max_price, fulfillment_in (FBA/FBM/AMZ), min/max demand, and min/max rating.

Parameters (19)

keywordsstringrequired
Free-text product keywords, e.g. 'stainless steel water bottle'.
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default). Amazon only.
product_brandstring
Exact product brand (case-insensitive).
product_brand_containsstring
min_pricenumber
max_pricenumber
fulfillment_instring
Comma-separated FBA/FBM/AMZ to keep.
min_fulfillment_amz_dom_pctnumber
max_fulfillment_amz_dom_pctnumber
min_fulfillment_fba_pen_pctnumber
max_fulfillment_fba_pen_pctnumber
min_demand_units_30dnumber
max_demand_units_30dnumber
min_demand_revenue_30dnumber
max_demand_revenue_30dnumber
min_ratingnumber
max_ratingnumber
min_rating_countnumber
max_rating_countnumber

collect_asin_now

Pull a LIVE, on-demand snapshot of a single Amazon ASIN right now — current title, price, live offers and the sellers on the listing today — and return it alongside Webotee's historical brand and seller intelligence, including the ASIN's product brand, title and price (or price range) and its fulfillment (FBA/FBM/AMZ). Use when the user gives a specific ASIN and wants its CURRENT/today's data rather than the pre-collected dataset (e.g. 'check ASIN B0... right now', 'who's on this listing today and at what price'). Amazon US only; one ASIN per call.

Parameters (2)

asinstringrequired
The 10-character Amazon ASIN to collect live (US).
marketplace_idinteger
Marketplace (2 = Amazon US). US only.

watchlist_add

Create or add to a saved tracking list the user can monitor over time. list_type is one of asin, brand, seller, niche; name is the user's label for the list; items are the identifiers to track (ASINs, brand names, seller names, or niche keys). Captures a baseline of the current observed state so a later 'what changed' check can show new sellers and score moves. Use when the user says 'track these ASINs', 'add Nike to my brand watchlist', 'start monitoring ...'.

Parameters (4)

list_typestringrequired
asin | brand | seller | niche
namestringrequired
The list's label (e.g. 'Q4 arbitrage candidates').
itemsarrayrequired
Identifiers to add.
marketplace_idinteger
Marketplace (2 = Amazon US).

watchlist_remove

Remove items from a saved tracking list, or delete the whole list. Provide list_type + name; give items to drop just those, or omit items to delete the entire list. Use when the user says 'stop tracking ...', 'remove ... from my watchlist', 'delete my ... list'.

Parameters (3)

list_typestringrequired
namestringrequired
itemsarray
Items to remove; omit to delete the list.

watchlist_list

List the workspace's saved tracking lists (name, type, item count, whether a baseline is set). Use when the user asks 'what am I tracking', 'show my watchlists', 'my saved lists'.

Parameters (5)

list_type_instring
Comma-separated list types to keep (asin/brand/seller/niche).
min_item_countnumber
Only lists with at least this many items.
max_item_countnumber
updated_at_fromstring
YYYY-MM-DD; only lists updated on/after this.
updated_at_tostring

watchlist_diff

Show what changed on a saved tracking list versus its captured baseline — new sellers observed on the tracked ASINs and sourcing-score moves. Each changed ASIN also carries product identity (brand, title, price or price range) and fulfillment (FBA/FBM/AMZ with amz/fba share). Use when the user asks 'what changed on <list>', 'any updates on my watchlist', 'new sellers on the ASINs I track'. Re-run watchlist_add to reset the baseline to the current state.

Parameters (24)

namestringrequired
The list name to diff.
list_typestring
Defaults to asin.
asinstring
Only the change row for this exact ASIN.
asin_containsstring
min_new_sellersnumber
Only ASINs that gained at least this many new sellers.
max_new_sellersnumber
min_dropped_sellersnumber
max_dropped_sellersnumber
min_current_seller_countnumber
max_current_seller_countnumber
min_score_deltanumber
max_score_deltanumber
min_current_scorenumber
max_current_scorenumber
product_brandstring
Exact product brand (case-insensitive).
product_brand_containsstring
product_title_containsstring
min_pricenumber
max_pricenumber
fulfillment_instring
Comma-separated FBA/FBM/AMZ to keep.
min_fulfillment_amz_dom_pctnumber
max_fulfillment_amz_dom_pctnumber
min_fulfillment_fba_pen_pctnumber
max_fulfillment_fba_pen_pctnumber

set_cost_floor

Record the user's cost basis (landed unit cost) for an ASIN so later checks can flag when the buy box drops below their cost and compute true net spread; the saved/cleared confirmation also echoes the ASIN's product brand, title and price (or price range) and its fulfillment (FBA/FBM/AMZ). Use when the user says 'my cost on B0... is $12', 'set my cost basis', 'I pay $X for this'. One ASIN per call; pass cost 0 to clear.

Parameters (3)

asinstringrequired
The 10-character ASIN.
cost_floornumberrequired
Your landed unit cost (marketplace currency). 0 clears it.
marketplace_idinteger
Marketplace (2 = Amazon US).

operator_resells_what

The arbitrage sourcing feed: given an ASIN (or a seller/operator name), find the OTHER ASINs the operators on that listing also resell, ranked by sourcing fit (our composite sourcing score) then estimated 30-day sales. De-duped against the ASINs the user already tracks, so it surfaces NEW candidates. Use when the user says 'what else does this seller carry', 'find more like this from the same operators', 'arbitrage leads from this ASIN's sellers'. Each candidate ASIN also carries product brand, title, and price (or price range) plus its fulfillment (FBA/FBM/AMZ + amz/fba pct). Amazon US/UK. Optional filters (all default to no filter): min/max sourcing_score, est_units_30d, buybox_avg_price; resold_by_contains; the shared product/fulfillment block (product_brand, product_title_contains, min/max_price, fulfillment_in, amz/fba pct).

Parameters (21)

asinstring
An ASIN whose operators to expand from.
operator_namestring
Or a seller/operator name directly.
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
limitinteger
min_sourcing_scorenumber
Only candidates with sourcing score >= this.
max_sourcing_scorenumber
min_est_units_30dnumber
max_est_units_30dnumber
min_buybox_avg_pricenumber
max_buybox_avg_pricenumber
resold_by_containsstring
Keep candidates resold by a seller whose name contains this.
product_brandstring
Exact product brand (case-insensitive).
product_brand_containsstring
product_title_containsstring
min_pricenumber
max_pricenumber
fulfillment_instring
Comma-separated FBA/FBM/AMZ to keep.
min_fulfillment_amz_dom_pctnumber
max_fulfillment_amz_dom_pctnumber
min_fulfillment_fba_pen_pctnumber
max_fulfillment_fba_pen_pctnumber

operator_concentration

Operator concentration (HHI) across a set of ASINs or a brand's catalog — reveals when the same operator quietly controls many of the 'independent' listings. Returns the HHI, a concentration label, and the top operators with how many listings each dominates. Use for private-label fragmentation checks: 'how concentrated is this niche', 'who controls this brand's listings', 'is one operator running most of these'. Amazon US/UK. Optional filters (all default to no filter): min/max hhi (gates the whole analysis by its concentration index); on the top_operators list — operator (exact, case-insensitive) + operator_contains, min/max share_pct, min/max listings_controlled.

Parameters (12)

asinsarray
ASIN set to analyze.
brandstring
Or a brand whose catalog to analyze.
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
limitinteger
min_hhinumber
Only return the analysis if its HHI >= this (else empty top_operators).
max_hhinumber
operatorstring
Keep only this operator (exact, case-insensitive) in top_operators.
operator_containsstring
min_share_pctnumber
max_share_pctnumber
min_listings_controllednumber
max_listings_controllednumber

operator_new_on_brand

Operators newly OBSERVED on a brand in a recent window — counted at BRAND level: a seller's FIRST observation anywhere across the brand's ASINs falls in the window. This is coverage-robust (a long-present seller was almost certainly seen on some ASIN earlier, so they correctly drop out) — a trustworthy directional 'new on the brand' count, not the inflated per-ASIN number. Still first-OBSERVED, not provably first-to-market. Returns each operator with first_observed, how many of the brand's ASINs we've seen them on, and whether still active. Use for 'who's new on <brand>', 'who's newly showing up on my brand', 'recent sellers on <brand>'. Amazon US/UK. since_days already bounds first_observed below; optional filters (all default to no filter): operator (exact, case-insensitive) + operator_contains, first_observed_from/_to, min/max n_asins_on_brand, min/max total_days_seen, min/max observed_buybox_days, still_active (true/false).

Parameters (15)

brandstringrequired
The brand to watch.
since_daysinteger
Window in days (default 30, max 180).
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
limitinteger
operatorstring
Exact operator/seller name (case-insensitive).
operator_containsstring
first_observed_fromstring
YYYY-MM-DD lower bound on first_observed.
first_observed_tostring
min_n_asins_on_brandnumber
max_n_asins_on_brandnumber
min_total_days_seennumber
max_total_days_seennumber
min_observed_buybox_daysnumber
max_observed_buybox_daysnumber
still_activeboolean
Keep only operators last seen within 7 days (true) or not (false).

operator_classifier

Label what kind of operator a seller is — amazon, brand-direct, likely-authorized-retailer, arbitrage, or reseller — from our cross-brand operator signals (how many brands they span, their fulfilment mix, their primary brand). Use when the user asks 'what kind of seller is this', 'is this an authorized retailer or an arbitrage seller', 'classify this operator'. Heuristic label, not a legal determination. Amazon US/UK.

Parameters (2)

operator_namestringrequired
Seller/operator name.
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)

playbook_create

Save a reusable per-model research workflow (a 'playbook') the user can re-run or schedule. Provide a template_key (one of: brand_watch, new_brand_radar, replenishment_watch, arbitrage_feed, defend_my_niche, find_my_next_niche, brand_defense_daily, expansion_radar, dropship_watch, spread_hunter, map_sweep, operator_network_expose, gating_risk_guardian) with its scope, OR custom steps. scope holds the inputs every step shares (e.g. {"brand":"Nike"} or an ASIN). Use when the user says 'save this as a weekly check', 'make a playbook for ...', 'automate this research'.

Parameters (5)

namestringrequired
The playbook's label.
template_keystring
Built-in template to seed from.
scopeobject
Shared inputs for the steps, e.g. {"brand":"Nike"}.
stepsarray
Custom ordered [{tool,args}] (instead of a template).
schedulestring
Run cadence (default = template's or manual).

playbook_list

List the workspace's saved playbooks (name, schedule, last run) and the built-in templates available. Use when the user asks 'what playbooks do I have', 'show my saved workflows', 'what automations are set up'.

Parameters (5)

schedule_instring
Comma-separated cadences to keep (manual/daily/weekly).
template_key_instring
Comma-separated template keys to keep.
activeboolean
Only active (true) or only paused (false) playbooks.
last_run_at_fromstring
YYYY-MM-DD; only playbooks last run on/after this.
last_run_at_tostring

playbook_run_now

Run a saved playbook right now and return its digest (also saved to the in-app inbox). Use when the user says 'run my <name> playbook', 'check my brand watch now', 'run that workflow'.

Parameters (1)

namestringrequired

playbook_schedule

Set how often a saved playbook runs automatically (manual, daily, or weekly). Use when the user says 'run this weekly', 'schedule my playbook daily', 'stop the automatic runs' (manual).

Parameters (2)

namestringrequired
schedulestringrequired

find_product_across_web

Find where one product sits across the open web — a live cross-retailer price check — with every price anchored to Webotee's independently-observed Amazon buy-box. Give ONE identifier (asin, upc, gtin, or title + brand) and a mode: price_compare (default, all retailers vs the Amazon buy-box), cheaper (only sources below the buy-box), dropship (net margin after estimated Amazon fees), or supplier (wholesale-class sources). Returns each source's price, class, spread vs the buy-box, and a durability read from our 16-month history. The Amazon anchor also carries the product brand, title, and price (or price range) plus its fulfillment (FBA/FBM/AMZ + amz/fba pct). One product per call.

Parameters (17)

asinstring
Amazon ASIN (the strongest anchor).
upcstring
UPC code.
gtinstring
GTIN code.
titlestring
Product title (use with brand to resolve the ASIN).
brandstring
Brand (with title).
modestring
price_compare (default) | cheaper | dropship | supplier.
marketplace_idinteger
Marketplace (2 = Amazon US). Default 2.
sourcestring
Exact merchant/source name (case-insensitive).
source_containsstring
currency_instring
Comma-separated currencies to keep (e.g. USD).
source_class_instring
Comma-separated source classes to keep (retailer/marketplace/wholesale).
min_pricenumber
Only web sources priced >= this.
max_pricenumber
min_spread_vs_buyboxnumber
max_spread_vs_buyboxnumber
min_dropship_net_marginnumber
max_dropship_net_marginnumber

webotee_job_status

Check the status of a live Amazon refresh kicked off for an ASIN (returns its current snapshot when ready). job_id is the ASIN. Use after a tool says a live refresh is collecting.

Parameters (2)

job_idstringrequired
The job id (the ASIN being refreshed).
marketplace_idinteger
Marketplace (2 = Amazon US). Default 2.

authorized_seller_set

Save the authorized sellers for a brand you own/manage — the whitelist that makes 'unauthorized seller' detection possible. The brand must already be tracked in this workspace. Use when the user says 'these are my authorized sellers for X', 'add Y to my authorized list', 'set my brand's approved resellers'. Pass the seller names exactly as they appear on Amazon.

Parameters (3)

brandstringrequired
The brand (must be a tracked workspace brand).
sellersarrayrequired
Authorized seller names to save.
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)

authorized_seller_list

List the saved authorized sellers for a brand. Use when the user asks 'who are my authorized sellers for X', 'show my approved resellers', 'what's my whitelist for this brand'.

Parameters (3)

brandstringrequired
The brand.
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
seller_containsstring
Only return saved seller names containing this substring (case-insensitive).

buybox_loss_alert

Find the ASINs where a brand you own has LOST the buy box to a seller outside your authorized list — ranked by estimated revenue at stake — so you can act on the costliest first. Each flagged ASIN carries its product brand, title and price (or price range) plus its fulfillment (FBA/FBM/AMZ). Save your authorized list first (authorized_seller_set) for precise flagging; without it, ASINs where a third-party operator holds the buy box are flagged. Use when the user asks 'where am I losing the buy box on <brand>', 'buy-box loss on my ASINs', 'which of my listings did I lose'.

Parameters (26)

brandstringrequired
The brand you own/manage.
authorized_sellersarray
Optional. Your authorized sellers (else the saved list is used).
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default)
limitinteger
asinstring
Exact ASIN match.
asin_containsstring
buybox_holderstring
Exact current buy-box holder (case-insensitive).
buybox_holder_containsstring
min_observed_buybox_daysnumber
max_observed_buybox_daysnumber
min_est_units_30dnumber
max_est_units_30dnumber
min_buybox_pricenumber
max_buybox_pricenumber
min_est_revenue_at_stake_30dnumber
max_est_revenue_at_stake_30dnumber
product_brandstring
Exact product brand (case-insensitive).
product_brand_containsstring
product_title_containsstring
min_pricenumber
max_pricenumber
fulfillment_instring
Comma-separated FBA/FBM/AMZ to keep.
min_fulfillment_amz_dom_pctnumber
max_fulfillment_amz_dom_pctnumber
min_fulfillment_fba_pen_pctnumber
max_fulfillment_fba_pen_pctnumber

web_search

Search the web (Google, via Serper) for a query — returns title + link + snippet. Use for supplier / wholesale / distributor research and review-gap articles.

Parameters (2)

querystringrequired
The search query.
countinteger
Max results (default 10, cap 20).

shopping_search

Search Google Shopping (via Serper) — returns retail listings with title + price + image + rating + source (Walmart / Target / eBay / …). The retail price / margin reference for a product.

Parameters (1)

querystringrequired
The product query.

alibaba_supplier_search

Find Alibaba supplier / manufacturer listings for a query (via Serper site:alibaba.com) — returns title + rating + a supplier snippet + the Alibaba link. TEXT ONLY: no price or photo are available via this source (the user sees price / MOQ / photos on Alibaba after clicking).

Parameters (1)

querystringrequired
The product / OEM query (brand-free for private label).

find_sourcing_opportunities

Given an Amazon ASIN, diagnose its business model (private-label / wholesale / arbitrage) and find real-world supplier, wholesale and arbitrage matches across the web, then return an HONEST sourcing read: a viability qualifier (green/yellow/red), the specific move + required differentiation, conservative economics, named risks (IP, tariffs, MOQ, saturation, gating, dropship policy) and validation steps. A credible lead generator, not get-rich advice. Scout+.

Parameters (2)

asinstringrequired
The Amazon ASIN (10 chars).
marketplace_idinteger
Marketplace (2 = US). Default 2.

operator_buybox_losses

For ONE operator (seller), find the ASINs where it's losing the buy-box — it carries the listing but holds less than `max_buybox_share_pct` of the buy-box — ranked by estimated 30-day revenue at risk. Each leak returns who's winning the box, the operator's vs the winner's sanitized price and the gap, how many sellers are on the listing, a `situation` (price_gap | tied_price | amazon_in_box | reseller_swarm), a `suggested_action` (reprice_to_win | enable_fba | defend_match_only | evaluate_or_exit), and a `suggested_target_price` when the box is winnable on price. Totals include the recoverable price-gap-only revenue. Use when the user asks 'where is seller X losing the buy-box', 'X's buy-box leaks', 'which ASINs should X reprice', 'where is X leaving money on the table', or 'what's X's revenue at risk'. Sortable by revenue-at-risk (default), price gap, buy-box share, or listing revenue.

Parameters (10)

operator_namestringrequired
Seller/operator name.
marketplace_idinteger
1 = Amazon UK, 2 = Amazon US (default).
max_buybox_share_pctnumber
Only ASINs where the operator holds LESS than this share of the buy-box (0-1; default 0.75 — i.e. it's not dominating).
min_est_revenue_30dnumber
Only ASINs with estimated 30-day listing revenue >= this.
min_pricenumber
Only ASINs whose listing price >= this (skip pennies).
limitinteger
Leaks to return (default 25, max 100). This tool pages.
sortstring
Sort the leaks: revenue_at_risk (default), price_gap_pct (biggest recoverable gap), buybox_share (lowest first), or listing_revenue.
situation_instring
Comma-separated situations to keep (price_gap, tied_price, amazon_in_box, reseller_swarm).
exclude_amazon_in_boxboolean
Drop ASINs where Amazon holds the box (you can't win those).
fulfillment_instring
Comma-separated operator fulfillment to keep (FBA, FBM).

Install

claude_desktop_config.json

{
  "mcpServers": {
    "amazon-product-research-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.webotee.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.