Pull and cache ABA keyword_list pages. Specify pages as range like '1-500' or '750-2500'.

USE THIS TOOL WHEN: Building local keyword cache for offline analysis. Run once per page range. Subsequent calls will skip duplicates.

Show current ABA cache state: page coverage, total keywords, category breakdown.

USE THIS TOOL WHEN: Checking if cache covers the page ranges needed for research.

Query cached keywords by category and min search volume.

Args: categories: Comma-separated filter words (e.g. 'bulk,gift,wedding') min_search_volume: Minimum 30-day search volume limit: Max results

USE THIS TOOL WHEN: Exploring what's in the cache for specific product lines.

Show how a product term distributes across cached ABA pages.

Args: term: A category word like 'christmas', 'bulk', 'wedding'

USE THIS TOOL WHEN: Deciding which ABA page ranges to pull for a specific category.

Clear cached keywords. If pages specified (e.g. '1-500'), clears only those.

USE THIS TOOL WHEN: Refreshing stale cache or freeing space.

Build a keyword pool from cached ABA data. No API calls.

Args: categories: Comma-separated filter terms (default: all bulk/gift/party/wedding/...) min_search_volume: Minimum 30d search volume limit: Max pool size

USE THIS TOOL WHEN: Starting a new research session. Must have cache_aba_pull run first.

Run keyword_detail on top pool keywords for market screening. Uses caching + concurrent API calls + smart skip for speed.

Args: pool_keywords: JSON array of keyword objects from pool_build, or 'cached_top' limit: Max keywords to analyze min_search_volume: Skip keywords below this monthly search volume concurrency: Max parallel API calls (1-10)

USE THIS TOOL WHEN: Evaluating which markets have best new-seller opportunity.

Run product_search on candidate markets to discover ASINs.

Args: markets_json: JSON array of market objects from market_screen, or 's_tier'/'a_tier' to use tier filter price_min/max: Override sweetspot price range (0 = use default) reviews_max: Override max reviews (0 = use default 150) fba_only: Only show FBA products

USE THIS TOOL WHEN: Finding specific ASINs in validated markets.

Score a single ASIN on nine dimensions.

Returns total score (0-100), tier (S/A/B/C), dimension breakdown, data completeness and score confidence. Supported scoring versions are v1_legacy and v2_semantic (default). Set include_detail=True to get full product detail fields.

USE THIS TOOL WHEN: Evaluating a specific ASIN's viability.

Score multiple ASINs and rank by total score. Uses concurrent API calls.

Args: asins_json: JSON array of ASIN objects (from asin_discover) or '["ASIN1","ASIN2",...]' limit: Max ASINs to score concurrency: Max parallel API calls (1-10)

USE THIS TOOL WHEN: Scoring all ASINs discovered by asin_discover.

Deep single-keyword analysis: market metrics, top competitors, seasonality.

USE THIS TOOL WHEN: Evaluating a specific keyword before committing to a product line.

Reverse-lookup traffic keywords for an ASIN and check cache coverage.

USE THIS TOOL WHEN: Checking if an existing product's keywords are covered by the ABA cache.

Side-by-side nine-dimension comparison of two ASINs.

USE THIS TOOL WHEN: Deciding between two competitor products to benchmark against.

Validate pipeline recall against a list of known-good ASINs.

Args: test_asins_json: JSON array like '["B0XXX","B0YYY",...]'

USE THIS TOOL WHEN: Measuring how well the cache + pipeline covers existing products.

FBA profit calculator — unit economics for Amazon FBA products. Includes 2026 hidden fees (fuel surcharge, storage, placement, returns, prep).

Args: selling_price: Target selling price in USD (e.g. 29.99) purchase_cost_cny: 1688/supplier unit cost in CNY (e.g. 27) fba_shipping_cny: China→FBA freight per unit in CNY (default 16) fba_delivery_usd: Amazon fulfillment fee in USD (default 7.30) commission_rate_pct: Amazon referral fee % (default 15) ad_budget_usd: Daily PPC budget in USD (default 10) cpc_usd: Cost per click in USD (default 1.0) conversion_rate_pct: Ad conversion rate % (default 18) discount_pct: Coupon/discount rate % (default 0) exchange_rate: USD to CNY (default 6.8) organic_traffic: Daily organic clicks (default 0, conservative) return_rate_pct: Expected return rate % (default 5)

Returns breakeven price, unit profit, daily/monthly profit, ACOS, ROI, margin, and verdict.

USE THIS TOOL WHEN: Evaluating profit viability of a product before sourcing.

Show current session state: cache status and API configuration.

USE THIS TOOL WHEN: Starting a session or checking configuration.

Build a normalized product fingerprint from an ASIN's product_detail.

Extracts identity, brand, model, product type, material, color, quantity, measurements, variation text, bullets, images, and source-field provenance. Reports critical unknowns that will block downstream supplier matching.

Args: asin: Amazon ASIN (10-character alphanumeric) marketplace: Amazon marketplace (default US)

USE THIS TOOL WHEN: Starting the 1688 supplier matching workflow for an ASIN.

Search 1688.com for supplier candidates matching an ASIN.

Runs both image search (using the product's main image) and Chinese keyword search. Deduplicates and normalizes results into SupplierCandidate objects.

Args: asin: Amazon ASIN used for image search and fingerprint extraction search_keyword: Optional Chinese keyword override for text search

USE THIS TOOL WHEN: After building a fingerprint with asin_fingerprint.

Run deterministic comparison between an Amazon product and 1688 candidates.

Applies hard mismatch gates, records structured evidence, and produces a VisualReviewBundle for at most 5 best non-rejected candidates.

No LLM or vision API is called — this is purely deterministic.

Args: asin: Amazon ASIN to compare against supplier candidates

USE THIS TOOL WHEN: After supplier_search returns candidates to evaluate.