com.webotee/amazon-product-research-mcp
REMOTE · APP.WEBOTEE.COM · SCANNED AUG 3
Amazon brand, seller, niche & buy-box intelligence inside your own Claude or ChatGPT.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →
Endpoint Security94
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token. View diagnostics → Pass
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
- The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents. View diagnostics → Partial
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability53
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 22707 tokens (~298/item across 76 items; 76 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
- Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage80
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 40% of tool parameters carry a description.Partial
Capabilities60
- Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28. See how to fix → Fail
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
remote · app.webotee.com
claude mcp add --transport http com-webotee-amazon-product-research-mcp https://app.webotee.com/mcp
[mcp_servers.com-webotee-amazon-product-research-mcp] url = "https://app.webotee.com/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"com-webotee-amazon-product-research-mcp": {
"type": "remote",
"url": "https://app.webotee.com/mcp",
"enabled": true
}
}
} openclaw mcp add com-webotee-amazon-product-research-mcp --url https://app.webotee.com/mcp --transport streamable-http
mcp_servers:
com-webotee-amazon-product-research-mcp:
url: "https://app.webotee.com/mcp" {
"mcpServers": {
"com-webotee-amazon-product-research-mcp": {
"type": "http",
"url": "https://app.webotee.com/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 2 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.
- 31 Jul 26 +8
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 −1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 29 Jul 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.
- 27 Jul 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 26 Jul 26 63
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Probed https://app.webotee.com/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=app.webotee.com | CN=YE1,O=Let's Encrypt,C=US | 24 Jul 2026 | 22 Oct 2026 | ECDSA 256 | ECDSA-SHA384 | 550890efae4b73c651bcd2abf2d4d0e823f |
| SANs: app.webotee.com | ||||||
| CN=YE1,O=Let's Encrypt,C=US (CA) | CN=Root YE,O=ISRG,C=US | 3 Sept 2025 | 2 Sept 2028 | ECDSA 384 | ECDSA-SHA384 | 5ddd70dd31f801c85c186a7a04b80afe |
| CN=Root YE,O=ISRG,C=US (CA) | CN=ISRG Root X2,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | ECDSA 384 | ECDSA-SHA384 | 872165fc34b6e5fba8add5b3705fb53a |
| CN=ISRG Root X2,O=Internet Security Research Group,C=US (CA) | CN=ISRG Root X1,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | ECDSA 384 | SHA256-RSA | 6c8f1dc727c7117f7baf853ac980f9cd |
DNSSEC insecure
Validation of app.webotee.com. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| com. | present | 19718 | 13 | Verified |
| webotee.com. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication Enforced and verified
The endpoint asked for a token and published valid RFC 9728 metadata describing how to get one.
| Result | Enforced and verified |
|---|---|
| Enforced | On tool calls |
| HTTP status | 200 |
WWW-Authenticate challenge Bearer resource_metadata="https://app.webotee.com/.well-known/oauth-protected-resource"
Bearer resource_metadata="https://app.webotee.com/.well-known/oauth-protected-resource" | Header | Value |
|---|---|
| strict-transport-security | max-age=15552000 |
| x-content-type-options | nosniff |
| x-frame-options | SAMEORIGIN |
| referrer-policy | strict-origin-when-cross-origin |
Protected resource metadata
| Document | https://app.webotee.com/.well-known/oauth-protected-resource |
|---|---|
| Retrieved | Yes |
| Resource | https://app.webotee.com/mcp |
| Authorisation server | https://app.webotee.com |
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://app.webotee.com/mcp | Verified | 200 | |
| http (plaintext) | http://app.webotee.com/mcp | HTTPS enforced | 301 | https://app.webotee.com/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
alibaba_supplier_search ~87
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).
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | yes | The product / OEM query (brand-free for private label). |
No output schema declared.
No examples provided.
asin_buybox_history ~550
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.
| Name | Type | Req | Description |
|---|---|---|---|
| asin | string | yes | ASIN to look up (e.g. B08N5WRWNW). |
| first_seen_from | string | — | YYYY-MM-DD. |
| first_seen_to | string | — | — |
| fulfillment_in | string | — | Comma-separated FBA/FBM/AMZ to keep. |
| last_seen_from | string | — | — |
| last_seen_to | string | — | — |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| max_buybox_avg_price | number | — | — |
| max_days_seen | number | — | — |
| max_fulfillment_amz_dom_pct | number | — | — |
| max_fulfillment_fba_pen_pct | number | — | — |
| max_observed_buybox_days | number | — | — |
| max_price | number | — | — |
| max_seller_count | number | — | — |
| min_buybox_avg_price | number | — | — |
| min_days_seen | number | — | — |
| min_fulfillment_amz_dom_pct | number | — | — |
| min_fulfillment_fba_pen_pct | number | — | — |
| min_observed_buybox_days | number | — | Only sellers with at least this many observed buy-box days. |
| min_price | number | — | — |
| min_seller_count | number | — | — |
| product_brand | string | — | Exact product brand (case-insensitive). |
| product_brand_contains | string | — | — |
| product_title_contains | string | — | — |
| seller_name | string | — | Exact buy-box seller name (case-insensitive). |
| seller_name_contains | string | — | — |
| since_weeks | integer | — | Weeks of history (default 26, max 52). |
No output schema declared.
No examples provided.
asin_comparables ~364
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).
| Name | Type | Req | Description |
|---|---|---|---|
| asin | string | yes | Reference ASIN (e.g. B08N5WRWNW). |
| buybox_seller | string | — | Exact buy-box seller name (case-insensitive). |
| buybox_seller_contains | string | — | — |
| fulfillment_in | string | — | Comma-separated FBA/FBM/AMZ to keep. |
| limit | integer | — | — |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| max_days_observed | number | — | — |
| max_fulfillment_amz_dom_pct | number | — | — |
| max_fulfillment_fba_pen_pct | number | — | — |
| max_price | number | — | — |
| max_seller_count | number | — | — |
| min_days_observed | number | — | — |
| min_fulfillment_amz_dom_pct | number | — | — |
| min_fulfillment_fba_pen_pct | number | — | — |
| min_price | number | — | — |
| min_seller_count | number | — | Only comparables with at least this many distinct sellers. |
| product_brand | string | — | Exact product brand (case-insensitive). |
| product_brand_contains | string | — | — |
| product_title_contains | string | — | — |
No output schema declared.
No examples provided.
asin_profit_calc ~206
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.
| Name | Type | Req | Description |
|---|---|---|---|
| asin | string | yes | ASIN to analyze (e.g. B08N5WRWNW). |
| cogs | number | — | Your cost of goods in USD. If omitted, the tool estimates breakeven COGS. |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| target_margin_pct | number | — | Target profit margin percentage (default 20). |
No output schema declared.
No examples provided.
authorized_seller_list ~99
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'.
| Name | Type | Req | Description |
|---|---|---|---|
| brand | string | yes | The brand. |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| seller_contains | string | — | Only return saved seller names containing this substring (case-insensitive). |
No output schema declared.
No examples provided.
authorized_seller_set ~134
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.
| Name | Type | Req | Description |
|---|---|---|---|
| brand | string | yes | The brand (must be a tracked workspace brand). |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| sellers | array | yes | Authorized seller names to save. |
No output schema declared.
No examples provided.
brand_buybox_trajectory ~329
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'.
| Name | Type | Req | Description |
|---|---|---|---|
| brand | string | yes | Brand name (case-insensitive). |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| max_asins_touched | number | — | — |
| max_observations | number | — | — |
| max_observed_buybox_days | number | — | — |
| max_seller_count | number | — | — |
| max_seller_count_change_pct | number | — | — |
| min_asins_touched | number | — | — |
| min_observations | number | — | — |
| min_observed_buybox_days | number | — | — |
| min_seller_count | number | — | Keep only timeline weeks with at least this seller_count. |
| min_seller_count_change_pct | number | — | — |
| since_weeks | integer | — | Weeks of history to return (default 26, max 52). |
| trend_in | string | — | 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. |
| week_start_from | string | — | Keep only timeline weeks on/after this YYYY-MM-DD. |
| week_start_to | string | — | — |
No output schema declared.
No examples provided.
brand_new_asins ~419
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).
| Name | Type | Req | Description |
|---|---|---|---|
| asin | string | — | Exact ASIN match. |
| asin_contains | string | — | — |
| brand | string | yes | Brand name (case-insensitive). |
| first_seen_from | string | — | YYYY-MM-DD (since_days already bounds the lower edge). |
| first_seen_to | string | — | — |
| fulfillment_in | string | — | Comma-separated FBA/FBM/AMZ to keep. |
| last_seen_from | string | — | — |
| last_seen_to | string | — | — |
| latest_buybox_seller | string | — | Exact most-recent buy-box seller (case-insensitive). |
| latest_buybox_seller_contains | string | — | — |
| limit | integer | — | — |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| max_fulfillment_amz_dom_pct | number | — | — |
| max_fulfillment_fba_pen_pct | number | — | — |
| max_latest_price | number | — | — |
| max_price | number | — | — |
| max_seller_count | number | — | — |
| min_fulfillment_amz_dom_pct | number | — | — |
| min_fulfillment_fba_pen_pct | number | — | — |
| min_latest_price | number | — | — |
| min_price | number | — | — |
| min_seller_count | number | — | — |
| product_brand | string | — | Exact product brand (case-insensitive). |
| product_brand_contains | string | — | — |
| product_title_contains | string | — | — |
| since_days | integer | — | How far back to look (default 30, max 180). |
No output schema declared.
No examples provided.
brand_similar ~238
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.
| Name | Type | Req | Description |
|---|---|---|---|
| brand | string | yes | Reference brand name (case-insensitive). |
| brand_contains | string | — | Only keep similar brands whose name contains this substring. |
| limit | integer | — | — |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| max_asin_count | number | — | — |
| max_avg_price | number | — | — |
| max_buybox_days_3m | number | — | — |
| max_control_score | number | — | — |
| max_seller_count | number | — | — |
| min_asin_count | number | — | — |
| min_avg_price | number | — | — |
| min_buybox_days_3m | number | — | — |
| min_control_score | number | — | — |
| min_seller_count | number | — | Only similar brands with at least this many unique sellers (3m). |
No output schema declared.
No examples provided.
brand_under_attack ~247
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'.
| Name | Type | Req | Description |
|---|---|---|---|
| brand | string | yes | Brand name (case-insensitive). |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| signals_in | string | — | Comma-separated signals that must be present: NEW_ENTRANT_SURGE, HIGH_BUYBOX_CHURN. Matches if the brand has any of them. |
| since_weeks | integer | — | Window to analyze (default 4, max 12). |
| threat_level_in | string | — | Comma-separated threat levels to keep: HIGH, MODERATE, LOW. If the brand's level isn't in the list, an empty result is returned. |
No output schema declared.
No examples provided.
brand_xmarket ~211
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.
| Name | Type | Req | Description |
|---|---|---|---|
| brand | string | yes | Brand name (case-insensitive). |
| marketplace_id_in | string | — | Comma-separated marketplace ids to keep: 1=Amazon UK, 2=Amazon US, 3=Walmart US. |
| max_asin_count | number | — | — |
| max_control_score | number | — | — |
| max_observed_buybox_days | number | — | — |
| max_seller_count | number | — | — |
| min_asin_count | number | — | — |
| min_control_score | number | — | — |
| min_observed_buybox_days | number | — | — |
| min_seller_count | number | — | — |
No output schema declared.
No examples provided.
brands_gaining_sellers ~361
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.
| Name | Type | Req | Description |
|---|---|---|---|
| brand | string | — | Exact brand match (case-insensitive). |
| brand_contains | string | — | — |
| category | string | — | — |
| limit | integer | — | — |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| max_catalog_churn_30d_pct | number | — | — |
| max_control_score | number | — | — |
| max_newly_observed_sellers_in_window | number | — | Upper bound on new-seller count (min is min_new_sellers). |
| max_seller_churn_30d_pct | number | — | — |
| max_total_sellers_3m | number | — | — |
| min_catalog_churn_30d_pct | number | — | — |
| min_control_score | number | — | — |
| min_new_sellers | integer | — | Minimum new-seller count to surface (default 2). |
| min_seller_churn_30d_pct | number | — | — |
| min_total_sellers_3m | number | — | — |
| scope | string | — | tracked = only brands on the user's watchlist; universe = all brands. Default universe. |
| window_days | integer | — | Days back (default 30, max 90). |
No output schema declared.
No examples provided.
brands_in_operator_network ~238
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.
| Name | Type | Req | Description |
|---|---|---|---|
| brand | string | yes | The target brand to find network connections for. |
| brand_contains | string | — | Only keep related brands whose name contains this substring. |
| limit | integer | — | — |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| max_control_score | number | — | — |
| max_observed_buybox_days | number | — | — |
| max_seller_count | number | — | — |
| max_shared_operators | number | — | — |
| min_control_score | number | — | — |
| min_observed_buybox_days | number | — | — |
| min_seller_count | number | — | — |
| min_shared_operators | number | — | Only related brands sharing at least this many operators. |
No output schema declared.
No examples provided.
buybox_loss_alert ~484
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'.
| Name | Type | Req | Description |
|---|---|---|---|
| asin | string | — | Exact ASIN match. |
| asin_contains | string | — | — |
| authorized_sellers | array | — | Optional. Your authorized sellers (else the saved list is used). |
| brand | string | yes | The brand you own/manage. |
| buybox_holder | string | — | Exact current buy-box holder (case-insensitive). |
| buybox_holder_contains | string | — | — |
| fulfillment_in | string | — | Comma-separated FBA/FBM/AMZ to keep. |
| limit | integer | — | — |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| max_buybox_price | number | — | — |
| max_est_revenue_at_stake_30d | number | — | — |
| max_est_units_30d | number | — | — |
| max_fulfillment_amz_dom_pct | number | — | — |
| max_fulfillment_fba_pen_pct | number | — | — |
| max_observed_buybox_days | number | — | — |
| max_price | number | — | — |
| min_buybox_price | number | — | — |
| min_est_revenue_at_stake_30d | number | — | — |
| min_est_units_30d | number | — | — |
| min_fulfillment_amz_dom_pct | number | — | — |
| min_fulfillment_fba_pen_pct | number | — | — |
| min_observed_buybox_days | number | — | — |
| min_price | number | — | — |
| product_brand | string | — | Exact product brand (case-insensitive). |
| product_brand_contains | string | — | — |
| product_title_contains | string | — | — |
No output schema declared.
No examples provided.
categories_amazon_retreating ~274
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'.
| Name | Type | Req | Description |
|---|---|---|---|
| category_name | string | — | Exact category name (case-insensitive). |
| category_name_contains | string | — | — |
| limit | integer | — | Max results (capped at 10). Default 10. |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| max_amazon_expansion_net_90d | number | — | — |
| max_amz_retail_dominance_pct | number | — | — |
| max_asin_count | number | — | — |
| max_brand_count | number | — | — |
| max_pct_amazon_pl | number | — | — |
| min_amazon_expansion_net_90d | number | — | — |
| min_amz_retail_dominance_pct | number | — | — |
| min_asin_count | number | — | — |
| min_brand_count | number | — | — |
| min_pct_amazon_pl | number | — | — |
| velocity_tier_in | string | — | Comma-separated velocity tiers to keep. |
No output schema declared.
No examples provided.
category_metrics ~178
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.
| Name | Type | Req | Description |
|---|---|---|---|
| category_id | integer | — | Exact category id (any depth). |
| category_name | string | — | Category name (any depth, fuzzy). |
| marketplace_id | integer | — | 1=UK, 2=US, 3=Walmart. Default 2 (US). |
No output schema declared.
No examples provided.
category_new_entrants ~307
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'.
| Name | Type | Req | Description |
|---|---|---|---|
| brand | string | — | Exact brand match (case-insensitive). |
| brand_contains | string | — | — |
| category_id | integer | — | Root category ID. |
| category_name | string | — | Category name (fuzzy match if category_id not provided). |
| first_observed_from | string | — | YYYY-MM-DD lower bound on first-observed date. |
| first_observed_to | string | — | — |
| limit | integer | — | — |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| max_asin_count | number | — | — |
| max_avg_price | number | — | — |
| max_buybox_days_3m | number | — | — |
| max_seller_count | number | — | — |
| min_asin_count | number | — | — |
| min_avg_price | number | — | — |
| min_buybox_days_3m | number | — | — |
| min_seller_count | number | — | — |
| since_days | integer | — | How far back to look (default 30, max 180). |
No output schema declared.
No examples provided.
category_top_growers ~295
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.
| Name | Type | Req | Description |
|---|---|---|---|
| brand | string | — | Exact brand match (case-insensitive). |
| brand_contains | string | — | — |
| category_id | integer | — | Root category ID. |
| category_name | string | — | Category name (fuzzy match if category_id not provided). |
| limit | integer | — | — |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| max_obs_growth_pct | number | — | — |
| max_prior_observations | number | — | — |
| max_prior_sellers | number | — | — |
| max_recent_observations | number | — | — |
| max_recent_sellers | number | — | — |
| max_seller_growth_pct | number | — | — |
| min_obs_growth_pct | number | — | — |
| min_prior_observations | number | — | — |
| min_prior_sellers | number | — | — |
| min_recent_observations | number | — | — |
| min_recent_sellers | number | — | — |
| min_seller_growth_pct | number | — | — |
| since_months | integer | — | Months to compare (default 3, max 6). Compares latest month vs earliest. |
No output schema declared.
No examples provided.
category_undercompeted_brands ~388
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.
| Name | Type | Req | Description |
|---|---|---|---|
| brand | string | — | Exact brand match (case-insensitive). |
| brand_contains | string | — | — |
| category_id | integer | — | Root category ID to search within. |
| category_name | string | — | Category name (fuzzy match if category_id not provided). |
| limit | integer | — | — |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| max_asin_count | number | — | — |
| max_avg_price | number | — | Maximum average price in USD. Omit for no cap. |
| max_control_score | number | — | — |
| max_sellers | integer | — | Maximum unique sellers (default 20). |
| max_velocity_90d | number | — | — |
| min_asin_count | number | — | — |
| min_avg_price | number | — | Minimum average price in USD. Omit for no floor. |
| min_buybox_days | integer | — | Minimum observed buybox days in last 3 months (default 30). |
| min_control_score | number | — | — |
| min_sellers | integer | — | Minimum unique sellers (default 10). Drops single-seller / brand-owner-only 'PL junk' so results show proven multi-seller demand. |
| min_velocity_90d | number | — | — |
No output schema declared.
No examples provided.
collect_asin_now ~180
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.
| Name | Type | Req | Description |
|---|---|---|---|
| asin | string | yes | The 10-character Amazon ASIN to collect live (US). |
| marketplace_id | integer | — | Marketplace (2 = Amazon US). US only. |
No output schema declared.
No examples provided.
competitive_landscape ~483
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?'.
| Name | Type | Req | Description |
|---|---|---|---|
| brand | string | — | — |
| category_root_id | integer | — | — |
| dominant_category_velocity_tier_in | string | — | Comma-separated velocity tiers to keep in the brand list. |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| max_amz_retail_dominance_pct | number | — | — |
| max_bought_past_month_total | number | — | — |
| max_brand_count | number | — | — |
| max_brand_velocity_90d_units_day | number | — | — |
| max_catalog_churn_30d_pct | number | — | — |
| max_control_score | number | — | — |
| max_pct_asins_gated_to_3p | number | — | — |
| max_seller_churn_30d_delta_vs_cat_pp | number | — | — |
| max_seller_churn_30d_pct | number | — | — |
| max_total_observed_buybox_days | number | — | — |
| max_unique_sellers_3m | number | — | — |
| max_winner_diversity | number | — | — |
| min_amz_retail_dominance_pct | number | — | — |
| min_bought_past_month_total | number | — | — |
| min_brand_count | number | — | — |
| min_brand_velocity_90d_units_day | number | — | — |
| min_catalog_churn_30d_pct | number | — | — |
| min_control_score | number | — | — |
| min_pct_asins_gated_to_3p | number | — | — |
| min_seller_churn_30d_delta_vs_cat_pp | number | — | — |
| min_seller_churn_30d_pct | number | — | — |
| min_total_observed_buybox_days | number | — | — |
| min_unique_sellers_3m | number | — | — |
| min_winner_diversity | number | — | — |
| seller_name | string | — | Exact seller name in the sellers list (case-insensitive). |
| seller_name_contains | string | — | — |
No output schema declared.
No examples provided.
evaluate_asin_sourcing ~245
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.
| Name | Type | Req | Description |
|---|---|---|---|
| asin | string | yes | Amazon ASIN, 10-character alphanumeric. |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| qty | integer | — | Optional purchase quantity for ROI sizing. |
No output schema declared.
No examples provided.
evaluate_brand ~500
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?'.
| Name | Type | Req | Description |
|---|---|---|---|
| asin | string | — | Keep only this ASIN in top_asins. |
| asin_contains | string | — | — |
| brand | string | yes | Brand name (case-insensitive). |
| distribution_verdict_in | string | — | 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. |
| fulfillment_in | string | — | Comma-separated FBA/FBM/AMZ to keep on top_asins. |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| max_composite_score | number | — | — |
| max_fulfillment_amz_dom_pct | number | — | — |
| max_fulfillment_fba_pen_pct | number | — | — |
| max_gating | number | — | — |
| max_margin | number | — | — |
| max_number_of_ratings | number | — | — |
| max_price | number | — | — |
| max_rating | number | — | — |
| max_velocity | number | — | — |
| min_composite_score | number | — | — |
| min_fulfillment_amz_dom_pct | number | — | — |
| min_fulfillment_fba_pen_pct | number | — | — |
| min_gating | number | — | — |
| min_margin | number | — | — |
| min_number_of_ratings | number | — | — |
| min_price | number | — | — |
| min_rating | number | — | — |
| min_velocity | number | — | — |
| product_brand | string | — | Exact product brand (case-insensitive) on top_asins. |
| product_brand_contains | string | — | — |
| product_title_contains | string | — | — |
No output schema declared.
No examples provided.
evaluate_category_for_private_label ~193
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.
| Name | Type | Req | Description |
|---|---|---|---|
| category_id | integer | — | Exact category id (any depth). |
| category_name | string | — | Category/niche name (any depth, fuzzy). |
| marketplace_id | integer | — | 1=UK, 2=US, 3=Walmart. Default 2 (US). |
| verdict_in | string | — | Comma-separated verdicts to keep (Strong/Moderate/Weak). |
No output schema declared.
No examples provided.
filter_brands_by_fba_share ~358
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.
| Name | Type | Req | Description |
|---|---|---|---|
| brand | string | — | Exact brand match (case-insensitive). |
| brand_contains | string | — | — |
| fba_share_op | string | yes | Comparison operator for FBA share threshold. |
| fba_share_value | number | yes | FBA share threshold (0-100, percentage). |
| limit | integer | — | — |
| marketplace_id | integer | yes | 1 = Amazon UK, 2 = Amazon US (default) |
| max_amz_retail_dominance_pct | number | — | — |
| max_asins_touched_3m | number | — | — |
| max_control_score | number | — | — |
| max_unique_sellers_3m | number | — | — |
| max_winner_diversity | number | — | — |
| min_amz_retail_dominance_pct | number | — | — |
| min_asins_touched_3m | number | — | — |
| min_control_score | number | — | — |
| min_sourcing_score | integer | — | Optional — minimum control_score (heat) filter. |
| min_unique_sellers_3m | number | — | — |
| min_winner_diversity | number | — | — |
| sort_by | string | — | Sort column (default control_score). |
No output schema declared.
No examples provided.
filter_operators_by_fba_share ~341
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.
| Name | Type | Req | Description |
|---|---|---|---|
| brand | string | — | Optional — filter to operators selling this brand. |
| fba_share_op | string | yes | Comparison operator for FBA share threshold. |
| fba_share_value | number | yes | FBA share threshold (0-100, percentage). |
| limit | integer | — | — |
| marketplace_id | integer | yes | 1 = Amazon UK, 2 = Amazon US (default) |
| max_asins_touched | number | — | — |
| max_avg_rating | number | — | — |
| max_avg_rating_count | number | — | — |
| max_brands_touched | number | — | — |
| max_observed_buybox_days | number | — | — |
| max_sold_30d_revenue | number | — | — |
| min_asins_touched | number | — | — |
| min_avg_rating | number | — | — |
| min_avg_rating_count | number | — | — |
| min_brands_touched | number | — | — |
| min_observed_buybox_days | number | — | — |
| min_sold_30d_revenue | number | — | — |
| seller_name | string | — | Exact seller/operator name (case-insensitive). |
| seller_name_contains | string | — | — |
| sort_by | string | — | Sort column (default buybox_days). |
No output schema declared.
No examples provided.
find_brands_with_high_seller_churn ~295
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'.
| Name | Type | Req | Description |
|---|---|---|---|
| brand | string | — | Exact brand match (case-insensitive). |
| brand_contains | string | — | — |
| category | string | — | Category root name to filter (optional). |
| dominant_category_velocity_tier_in | string | — | Comma-separated velocity tiers to keep. |
| limit | integer | — | Max results (capped at 10). Default 10. |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| max_brand_velocity_90d_units_day | number | — | — |
| max_delta_pp | number | — | Max delta vs category in percentage points. Omit for no ceiling. |
| max_seller_churn_30d_pct | number | — | — |
| min_brand_velocity_90d_units_day | number | — | — |
| min_delta_pp | number | — | Min delta vs category in percentage points. Default 5. |
| min_seller_churn_30d_pct | number | — | — |
| scope | string | — | tracked = only brands on the user's watchlist; universe = all brands. Default universe. |
No output schema declared.
No examples provided.
find_deconcentrating_brands ~282
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.
| Name | Type | Req | Description |
|---|---|---|---|
| brand | string | — | Exact brand match (case-insensitive). |
| brand_contains | string | — | — |
| limit | integer | — | — |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| max_asin_count | number | — | — |
| max_control_score | number | — | — |
| max_new_seller_count | number | — | — |
| max_old_seller_count | number | — | — |
| max_seller_growth_pct | number | — | — |
| min_asin_count | number | — | — |
| min_buybox_days | integer | — | Minimum observed buybox days to filter out inactive brands (default 30). |
| min_control_score | number | — | — |
| min_new_seller_count | number | — | — |
| min_old_seller_count | number | — | — |
| min_seller_growth_pct | number | — | — |
| since_weeks | integer | — | Window to compare (default 12, max 26). Compares first half vs second half. |
No output schema declared.
No examples provided.
find_new_operators ~334
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.
| Name | Type | Req | Description |
|---|---|---|---|
| earliest_seen_from | string | — | YYYY-MM-DD lower bound on earliest-seen date. |
| earliest_seen_to | string | — | — |
| limit | integer | — | — |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| max_avg_rating | number | — | — |
| max_avg_rating_count | number | — | — |
| max_operator_fba_share_pct | number | — | — |
| max_total_asins | number | — | — |
| max_total_observed_buybox_days | number | — | — |
| min_avg_rating | number | — | — |
| min_avg_rating_count | number | — | — |
| min_brands | integer | — | Minimum brands to filter out trivial sellers (default 5). |
| min_operator_fba_share_pct | number | — | — |
| min_total_asins | number | — | — |
| min_total_observed_buybox_days | number | — | — |
| seller_name | string | — | Exact seller name (case-insensitive). |
| seller_name_contains | string | — | — |
| since_days | integer | — | How far back to look (default 30, max 180). |
No output schema declared.
No examples provided.
find_product_across_web ~411
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.
| Name | Type | Req | Description |
|---|---|---|---|
| asin | string | — | Amazon ASIN (the strongest anchor). |
| brand | string | — | Brand (with title). |
| currency_in | string | — | Comma-separated currencies to keep (e.g. USD). |
| gtin | string | — | GTIN code. |
| marketplace_id | integer | — | Marketplace (2 = Amazon US). Default 2. |
| max_dropship_net_margin | number | — | — |
| max_price | number | — | — |
| max_spread_vs_buybox | number | — | — |
| min_dropship_net_margin | number | — | — |
| min_price | number | — | Only web sources priced >= this. |
| min_spread_vs_buybox | number | — | — |
| mode | string | — | price_compare (default) | cheaper | dropship | supplier. |
| source | string | — | Exact merchant/source name (case-insensitive). |
| source_class_in | string | — | Comma-separated source classes to keep (retailer/marketplace/wholesale). |
| source_contains | string | — | — |
| title | string | — | Product title (use with brand to resolve the ASIN). |
| upc | string | — | UPC code. |
No output schema declared.
No examples provided.
find_single_seller_brands ~278
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.
| Name | Type | Req | Description |
|---|---|---|---|
| brand | string | — | Exact brand match (case-insensitive). |
| brand_contains | string | — | — |
| category_id | integer | — | Filter to a specific root category. Omit for all. |
| dominant_seller | string | — | Exact dominant-seller name (case-insensitive). |
| dominant_seller_contains | string | — | — |
| limit | integer | — | — |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| max_avg_price | number | — | Maximum average price in USD. Omit for no cap. |
| max_control_score | number | — | — |
| min_asins | integer | — | Minimum ASINs to filter out trivially small brands (default 10). |
| min_avg_price | number | — | Minimum average price in USD. Omit for no floor. |
| min_buybox_days | integer | — | Minimum observed buybox days in last 3 months (default 30). |
| min_control_score | number | — | — |
No output schema declared.
No examples provided.
find_sourcing_opportunities ~137
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+.
| Name | Type | Req | Description |
|---|---|---|---|
| asin | string | yes | The Amazon ASIN (10 chars). |
| marketplace_id | integer | — | Marketplace (2 = US). Default 2. |
No output schema declared.
No examples provided.
find_undercompeted_brands ~433
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.
| Name | Type | Req | Description |
|---|---|---|---|
| brand | string | — | Exact brand match (case-insensitive). |
| brand_contains | string | — | — |
| category_id | integer | — | Filter to a specific root category ID. Overrides seed_brand if both given. |
| include_catchall | boolean | — | Include reseller umbrella brands (PATIKIL, Uxcell, etc.). Default false. |
| limit | integer | — | — |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| max_asin_count | number | — | — |
| max_avg_price | number | — | Maximum average buybox price in USD. Omit for no price filter. |
| max_control_score | number | — | — |
| max_sellers | integer | — | Maximum unique sellers (competition ceiling). Default 20. |
| max_velocity_90d | number | — | — |
| min_asin_count | number | — | — |
| min_avg_price | number | — | Minimum average buybox price in USD. Omit for no price filter. |
| min_buybox_days | integer | — | Minimum observed buybox days in last 3 months (sales floor). Default 30. |
| min_control_score | number | — | — |
| min_sellers | integer | — | 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_velocity_90d | number | — | — |
| seed_brand | string | — | Reference brand to derive category from. Results stay in the same root category. |
No output schema declared.
No examples provided.
find_underserved_niches ~541
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.
| Name | Type | Req | Description |
|---|---|---|---|
| category_id | integer | — | Root category id to scope to (overrides category_name). |
| category_name | string | — | Department/category to find niches within (e.g. 'electronics', 'home & kitchen', 'pet supplies'). Omit for niches across all departments. |
| competition | string | — | 'low' (stricter Amazon-presence ceiling) or 'balanced' (default). |
| limit | integer | — | — |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
| max_amazon_retail_share_pct | number | — | — |
| max_avg_product_rating | number | — | — |
| max_competing_brands | number | — | — |
| max_monthly_demand_usd | number | — | — |
| max_seller_diversity | number | — | — |
| min_amazon_retail_share_pct | number | — | — |
| min_avg_product_rating | number | — | — |
| min_competing_brands | number | — | — |
| min_monthly_demand_usd | number | — | — |
| min_seller_diversity | number | — | — |
| niche | string | — | Exact niche (subcategory) name, case-insensitive. |
| niche_contains | string | — | — |
| pl_winnability_in | string | — | Comma-separated verdicts to keep (Strong/Moderate/Weak). |
| price_max | number | — | Maximum average price USD (default 70 — the PL margin band). |
| price_min | number | — | Minimum average price USD (default 20 — the PL margin band). |
| unhappy_shoppers | boolean | — | Bias toward niches where shoppers are underwhelmed (a credible dissatisfaction gap = a PL opening). Default false. |
No output schema declared.
No examples provided.
gating_repricing_advice ~132
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?'.
| Name | Type | Req | Description |
|---|---|---|---|
| asin | string | yes | — |
| marketplace_id | integer | — | 1 = Amazon UK, 2 = Amazon US (default) |
No output schema declared.
No examples provided.