{"name":"com.pangolinfo/amazon-mcp","slug":"pangolinfo-amazon-mcp","title":null,"description":"Amazon data MCP: products, reviews, niches, WIPO design/IP + US litigation, AI search & trends.","url":"https://mcp.market/server/pangolinfo-amazon-mcp","rating":null,"grade":"B","score":83,"certified":false,"status":"active","category":"ecommerce","tags":["ecommerce","search","media"],"presence":{"score":28,"stars":6,"forks":0,"downloads_week":null,"last_push_at":"2026-09-17T13:04:19.000Z","license":"MIT"},"uptime":null,"claimed":false,"transport":"remote","callable_via_gateway":true,"default_price_micros":0,"repository":"https://github.com/pangolinfo/pangolinfo-mcp","website":null,"version":"0.8.0","remotes":[{"type":"streamable-http","url":"https://mcp.pangolinfo.com/mcp?api_key={api_key}","variables":{"api_key":{"description":"Your personal Pangolinfo API key. Get one at https://tool.pangolinfo.com/?sourceTag=mcp (new users receive 60 free credits).","isRequired":true,"format":"string","isSecret":true}}}],"packages":[],"tools":[{"name":"ai_search","description":"[AI Search via Google SERP] Scrape publicly-available Google search results (data source: Google; use must comply with Google Terms of Service) with top AI Overview, organic results, and related searches. Two modes: overview (standard SERP) / ai_mode (immersive multi-turn conversational search).\nUse when: user says \"Google for me\" / \"external demand\" / \"what do people say about X\" / \"Reddit/Quora pain points\" / \"will my content be cited in AI search\" / \"find user complaints for keyword X\"; \"consumer voice\" step in scouting SOPs; verifying whether a new product concept has off-Amazon demand; **see which Google Shopping ads competitors run / their ad landing pages** (the sponsered block).\nDon't use: for on-Amazon search (use search_amazon); when only the trend curve matters (use keyword_trends — cheaper and tighter).\nReturns: data.{ results_num, ai_overview, json.items[ { type:'ai_overview', items:[{content:[...], references:[{title,url,domain}]}] }, { type:'organic', items:[{title,url,text}] }, { type:'related_searches', items:[...] }, { type:'sponsered', items:[{type:'result', url, position:'top'|'bottom', title_of_page, title_above_url}] } ], screenshot, taskId }. ⚠️ The ad block's upstream type is literally spelled 'sponsered' (missing an o — not a typo on our side; match it verbatim, do NOT look for 'sponsored') — it carries Google ad (shopping + text) landing-page url, title (title_of_page), and displayed brand domain (title_above_url). **position** marks whether the ad appears at the top ('top') or bottom ('bottom') of the page — top ads carry higher exposure weight.\nPair with: ↑ query inferred from user; in 'ai_mode' pass followups[1..5] for multi-turn; ↓ ai_overview.references[].url for authoritative external sources, organic items for content-competition analysis, sponsered[].url + title_above_url for competitors' paid landing pages and brands, split by position into top/bottom ad slots.\nCost: ~2 points/call, ~30s (**slow** — Google AI render time).\nTips: prefer overview for single queries (cheaper); use ai_mode only when you need decomposed multi-turn investigation. Followups > 5 visibly slow down responses.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"description":"Search keyword or question. Examples: 'wireless earbuds reviews' (single keyword) / 'how does noise cancellation work' (question) / 'what do people complain about Stanley Quencher' (user pain point)."},"mode":{"type":"string","enum":["overview","ai_mode"],"default":"overview","description":"Search mode: 'overview' (default) = standard Google SERP with AI Overview at the top, best for one-shot queries; 'ai_mode' = Google AI Mode immersive search (udm=50), best for complex multi-step questions with follow-ups."},"followups":{"type":"array","items":{"type":"string"},"maxItems":5,"description":"Follow-up question list (only honored when mode='ai_mode'). Each item is a follow-up question on the previous answer. **More than 5 entries significantly degrades response time.**"},"screenshot":{"type":"boolean","default":false,"description":"Whether to return a screenshot URL of the rendered search page. Defaults to false."},"clientSource":{"type":"string","enum":["skill","mcp"],"description":"调用来源标记。仅由 Pangolinfo Skill 传 skill；普通 MCP 调用省略即可。"}},"required":["query"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"filter_categories","description":"[Amazon category commercial-metrics filter] Filter categories by dozens of metrics (sales, GMS, search volume, conversion, return rate, price tier, competitor density, …) — or use as a \"category detail\" endpoint by passing a single categoryId.\nUse when: user says \"find categories worth entering\" / \"high-sales categories\" / \"low return-rate categories\" / \"high search-volume but low competition categories\" / \"show me all metrics for category X\"; category-level blue-ocean hunt; getting the 30+ metric snapshot of one category.\nDon't use: for niche-level (use filter_niches — finer granularity); for actual products in a category (use list_category_products); for just the readable name (use get_category_paths).\nReturns: data.items.data[{ id, categoryId, marketplaceId, timeRange, sampleScope, snapshotDate, unitSoldSum, glanceViewsSum, searchVolumeSum, netShippedGmsSum, buyBoxPriceAvg, buyBoxPriceTier, searchToPurchaseRatio, returnRatio, asinCount, offersPerAsin, newAsinCount, newBrandCount, avgAdSpendPerClick, unitSoldTrendDirection, unitSoldChangeRateBucket, ... trend + quantile-bucket fields }] + data.items.pagination.{ total, page, size, hasNext }. **Pagination**: use the 'page' param (default 1, 1-based, size capped at 10); 'pagination.hasNext=true' means more pages exist, 'hasNext=false' means last page.\nPair with: ↑ required timeRange ('l7d' common) + sampleScope ('all_asin') + marketplaceId (defaults US); categoryId from search_categories / get_category_children; ↓ feed high-potential categories into list_category_products / list_bestsellers for real listings.\nCost: ~1 point/page, ~5s.\nTips: size capped at 10 (backend hard limit); only paginate when the user explicitly asks for more candidate categories — single-detail or quick-filter calls are fine on page 1; long-tail filter fields (unitSoldTrendDirections / metricChangeRateBuckets / dozens more) pass through via extraFilters.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"marketplaceId":{"type":"string","minLength":1,"default":"US","description":"Amazon marketplace id. ⚠️ Backend currently supports US only; other marketplaces will fail or fall back. Use US (the default)."},"timeRange":{"type":"string","minLength":1,"description":"Aggregation time range (required). Examples: 'l7d' (last 7 days — verified working). The exact enum is backend-defined; 'l7d' is the safest known value."},"sampleScope":{"type":"string","minLength":1,"description":"Sample scope (required). Examples: 'all_asin' (all ASINs — verified working)."},"categoryId":{"type":"string","description":"When set, returns the full metric row for that single category (this endpoint doubles as the 'detail' endpoint). Omit to list multiple categories matching the filters. Example: '979832011'."},"page":{"type":"integer","minimum":1,"default":1,"description":"Page number, 1-based."},"size":{"type":"integer","minimum":1,"maximum":10,"default":10,"description":"Page size, max 10 (backend hard limit)."},"sortField":{"type":"string","description":"Sort field; any response field name is accepted (e.g. 'unitSoldSum', 'netShippedGmsSum')."},"sortOrder":{"type":"string","enum":["asc","desc"],"description":"Sort order: 'asc' or 'desc'."},"unitSoldSumMin":{"type":"integer","minimum":0,"description":"Min total units sold."},"unitSoldSumMax":{"type":"integer","minimum":0,"description":"Max total units sold."},"netShippedGmsSumMin":{"type":"integer","minimum":0,"description":"Min total GMS (gross merchandise sales)."},"netShippedGmsSumMax":{"type":"integer","minimum":0,"description":"Max total GMS."},"searchVolumeSumMin":{"type":"integer","minimum":0,"description":"Min total search volume."},"searchVolumeSumMax":{"type":"integer","minimum":0,"description":"Max total search volume."},"buyBoxPriceAvgMin":{"type":"number","minimum":0,"description":"Min average buy-box price (marketplace currency)."},"buyBoxPriceAvgMax":{"type":"number","minimum":0,"description":"Max average buy-box price."},"buyBoxPriceTiers":{"type":"array","items":{"type":"string","enum":["budget","mainstream","premium","luxury"]},"description":"Price-tier filter. Allowed: budget, mainstream, premium, luxury."},"returnRatioLevels":{"type":"array","items":{"type":"string","enum":["excellent","average","risk"]},"description":"Return-rate quality buckets. Allowed: excellent, average, risk."},"searchToPurchaseRatioLevels":{"type":"array","items":{"type":"string","enum":["to_improve","average","excellent"]},"description":"Search-to-purchase conversion buckets. Allowed: to_improve, average, excellent."},"extraFilters":{"type":"object","additionalProperties":{},"description":"Pass-through for any other upstream filter (e.g. unitSoldTrendDirections, newAsinCountLevels, metricChangeRateBuckets). Keys must match the upstream doc verbatim."},"clientSource":{"type":"string","enum":["skill","mcp"],"description":"调用来源标记。仅由 Pangolinfo Skill 传 skill；普通 MCP 调用省略即可。"}},"required":["timeRange","sampleScope"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"filter_niches","description":"[Amazon niche filter] Filter Amazon Niches (a finer-grained \"demand cluster\" than categories) by 50+ commercial metrics, or use as a \"niche detail\" endpoint for one niche.\nUse when: user says \"find blue ocean\" / \"high search volume + low competition niches\" / \"fast-growing small markets\" / \"niche scouting\" / \"give me the deep report on this niche\" / \"low return-rate niches\" / \"niches with return rate under 10%\"; the core filter step of GTM scouting SOPs; getting fee structure / brand age / new-launch trends for one niche.\nDon't use: for full categories (use filter_categories); for actual products in a niche (the niche record only carries 1 referenceAsin; combine with categoryId + list_category_products); for plain keyword search (use search_amazon).\nReturns: data.items.data[{ nicheId, nicheTitle, referenceAsinImageUrl, currency, searchVolumeT90, searchVolumeT360, searchVolumeGrowthT90, minimumPrice, maximumPrice, avgPrice, productCount, sponsoredProductsPercentage, primeProductsPercentage, top5ProductsClickShare, top20BrandsClickShare, brandCount, sellingPartnerCount, avgBrandAge, avgBestSellerRank, avgProductPrice, avgReviewCount, avgReviewRating, avgDetailPageQuality, newProductsLaunchedT180/T360, successfulLaunchesT90/T180/T360, returnRateT360, fee fields T365 … 100+ fields }] + data.items.pagination.{ total, page, size, hasNext }. **Pagination**: use the 'page' param (default 1, 1-based, size capped at 10 (default 3)); 'pagination.hasNext=true' means more pages exist, 'hasNext=false' means last page.\nPair with: ↑ marketplaceId required (defaults US); nicheTitle for keyword filter, nicheId for single-niche detail; ↓ feed referenceAsin into get_amazon_product to see the representative product; niche doesn't carry a categoryId directly — derive separately if needed.\nCost: ~1 point/call, ~5s.\nTips: size capped at 10 (default 3); pass long-tail filters (50+ fields) via extraFilters; classic blue-ocean combo = high searchVolumeT90Min + low top5ProductsClickShareT360Max + moderate productCountMax + positive searchVolumeGrowthT90Min + returnRateT360Max ≤ 0.10 (low-return). For return-rate filtering use returnRateT360Max (upper bound, 0-1 decimal); the response includes returnRateT360 with the actual return rate.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"marketplaceId":{"type":"string","minLength":1,"default":"US","description":"Amazon marketplace id (required). ⚠️ Backend currently supports US only; other marketplaces will fail or fall back. Use US (the default)."},"nicheId":{"type":"string","description":"When set, returns the full deep report for that single niche (this endpoint doubles as the niche-detail endpoint). Omit to list multiple niches matching the filters. Example: '8140a265-768d-4679-8bc2-994cb1c96f0b' (UUID)."},"nicheTitle":{"type":"string","description":"Keyword match against niche titles. Examples: 'iphone 16 wallet case' / 'wireless earbuds for sports'."},"page":{"type":"integer","minimum":1,"default":1,"description":"Page number, 1-based."},"size":{"type":"integer","minimum":1,"maximum":10,"default":3,"description":"Page size, max 10 (backend hard limit), default 3 (small default to keep responses under AI context limits — pass size=10 explicitly when you need a wider sweep)."},"sortField":{"type":"string","description":"Sort field; any response field name is accepted (e.g. 'searchVolumeT90', 'avgProductPrice')."},"sortOrder":{"type":"string","enum":["asc","desc"],"description":"Sort order: 'asc' or 'desc'."},"searchVolumeT90Min":{"type":"integer","minimum":0,"description":"Min search volume over last 90 days."},"searchVolumeT90Max":{"type":"integer","minimum":0,"description":"Max search volume over last 90 days."},"searchVolumeT360Min":{"type":"integer","minimum":0,"description":"Min search volume over last 360 days."},"searchVolumeT360Max":{"type":"integer","minimum":0,"description":"Max search volume over last 360 days."},"searchVolumeGrowthT90Min":{"type":"number","description":"Min 90-day search-volume growth rate (decimal, 0.1 = +10%)."},"searchVolumeGrowthT90Max":{"type":"number","description":"Max 90-day search-volume growth rate."},"minimumPriceMin":{"type":"number","minimum":0,"description":"Lower bound on the niche's minimum product price."},"maximumPriceMax":{"type":"number","minimum":0,"description":"Upper bound on the niche's maximum product price."},"productCountMin":{"type":"integer","minimum":0,"description":"Min product count in the niche."},"productCountMax":{"type":"integer","minimum":0,"description":"Max product count in the niche."},"avgReviewCountMin":{"type":"integer","minimum":0,"description":"Min average review count."},"avgReviewCountMax":{"type":"integer","minimum":0,"description":"Max average review count — lower means less competition."},"avgReviewRatingMin":{"type":"number","minimum":0,"maximum":5,"description":"Min average review rating (0-5)."},"top5ProductsClickShareT360Max":{"type":"number","minimum":0,"maximum":1,"description":"Max top-5-products click share over 360 days (0-1). Lower = more fragmented niche, more opportunity."},"returnRateT360Max":{"type":"number","minimum":0,"maximum":1,"description":"Max return rate over 360 days (0-1)."},"extraFilters":{"type":"object","additionalProperties":{},"description":"Pass-through for any other upstream filter (e.g. sponsoredProductsPercentageT360Min, successfulLaunchesT360Max, avgBestSellerRankMax). Keys must match the upstream doc verbatim."},"clientSource":{"type":"string","enum":["skill","mcp"],"description":"调用来源标记。仅由 Pangolinfo Skill 传 skill；普通 MCP 调用省略即可。"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_amazon_alexa_questions","description":"Alexa Listing API: extract both Alexa/Rufus preset-question regions from a logged-in Amazon PDP and optionally answer them in that ASIN context. Extracted questions cost 5 points and each answered region adds 20 (0/5/25/45 total); valid no-question and service failures cost 0, while an explicitly invalid ASIN costs 5.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"asin":{"type":"string","pattern":"^[A-Za-z0-9]{10}$","description":"10-character Amazon ASIN. Provide asin or url; if both are provided they must identify the same product."},"url":{"type":"string","format":"uri","description":"Amazon.com product-detail URL. Provide either asin or url."},"includeAnswers":{"type":"boolean","default":false,"description":"Whether to generate Rufus answers. Questions from both regions are always returned; when false, every answer is null."},"region":{"type":"string","enum":["region1","region2","all"],"default":"all","description":"Only selects which regions receive answers when includeAnswers=true: region1 is below the main image, region2 is below Product information, and all means both. It never filters returned questions."},"concurrency":{"type":"integer","minimum":1,"maximum":10,"default":5,"description":"Maximum answer-generation concurrency, 1-10. Defaults to 5."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_amazon_delivery_time","description":"[Amazon Delivery Time] Return the full listing detail for one ASIN plus address-dependent delivery estimates.\nUse when: the user explicitly needs estimated arrival, free vs paid delivery timing, the fastest option, handling lead time, or the listing's high-return warning.\nDon't use: for ordinary product detail only; use get_amazon_product at the lower 1-point cost.\nReturns: data.json[0].data.results[0] inherits every get_amazon_product field and adds frequentlyReturnedItem, leadTime, and delivery{deliveryTime,fastestDelivery,deliveryTimeFree,deliveryTimePay,deliveryFastest}. Unavailable extra fields are empty strings.\nCost: 2 points/call, ~5s. Delivery results depend on the zipcode address.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"asin":{"type":"string","pattern":"^[A-Za-z0-9]{10}$","description":"Amazon ASIN, 10 letters/digits (case-insensitive; auto-uppercased)."},"site":{"type":"string","enum":["amz_us","amz_uk","amz_de","amz_jp","amz_fr","amz_it","amz_es","amz_ca","amz_au","amz_sa","amz_ae","amz_br","amz_mx"],"default":"amz_us","description":"Amazon marketplace. Defaults to amz_us."},"zipcode":{"type":"string","description":"ZIP code matching the marketplace country. Delivery estimates vary by address; the backend selects a country-matched ZIP when omitted."},"clientSource":{"type":"string","enum":["skill","mcp"],"description":"调用来源标记。仅由 Pangolinfo Skill 传 skill；普通 MCP 调用省略即可。"}},"required":["asin"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_amazon_product","description":"[Amazon single-product detail] Scrape the full PDP for one ASIN.\nUse when: user supplies a specific ASIN (\"look at B0XXXXXXXX\" / \"check this product's price/rating/seller\" / \"analyse this competitor\"); or as a SOP step after candidate ASINs are picked.\nDon't use: for many products at once (use search_amazon or list_* series for lists); for reviews only (use get_amazon_reviews — cheaper and more focused).\nReturns (format='json', default): data.json[0].data.results[0] = { asin, title, itemName, itemHighlights, price, star, rating, brand, seller{name,id,link,hasLink}, parentAsin, videos[{type,section,mp4,m3u8,previewMp4,cover,title,duration,author}], shippingFee (buyer shipping fee as a number, e.g. \"750\"; \"0\" when free shipping or no info, varies by the zipcode address), delivery{deliveryTime,fastestDelivery}, ratingDistribution[], aiReviewsSummary, bestSellersRankItems, reviews[{date,star,content,helpful,...}], productOverview[], features[], productDescription[], images[], variantDetails[], attributes[], category_id, breadCrumbs, ... } — 30+ fields (variantDetails summary included). videos[].section: product=main media gallery, brand=brand module, related=related videos, customerReview=customer review videos. Use get_amazon_delivery_time when you need the high-return warning, free/paid/fastest delivery breakdown, or handling lead time.\nTitle fields (Amazon split the title into two parts starting 2026-07-27): title=the full raw title string (for rolled-out listings it contains a \" | \" separator, unsplit); itemName=the title body (the part before \" | \", i.e. the product name, ≤75 chars); itemHighlights=the title highlights (the part after \" | \", e.g. material/use-case/selling points, ≤125 chars). For legacy (not-yet-rolled-out) listings itemName=the full title and itemHighlights is an empty string. Use itemName for the clean product name, itemHighlights for selling points.\nPair with: ↑ asin typically comes from search_amazon / list_bestsellers / filter_niches; ↓ feed the same asin into get_amazon_reviews for more reviews (the PDP carries only ~5-10).\nCost: ~1 point/call, ~5s.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"asin":{"type":"string","pattern":"^[A-Za-z0-9]{10}$","description":"Amazon ASIN, 10 letters/digits (case-insensitive — auto-uppercased). Example: 'B0B4NLGCH5'."},"site":{"type":"string","enum":["amz_us","amz_uk","amz_de","amz_jp","amz_fr","amz_it","amz_es","amz_ca","amz_au","amz_sa","amz_ae","amz_br","amz_mx"],"default":"amz_us","description":"Amazon marketplace. Defaults to 'amz_us' (US)."},"zipcode":{"type":"string","description":"ZIP code that must match the site country (amz_us → US zip, amz_jp → JP zip, ...). Optional; backend picks a random one from the per-country pool when omitted. Cross-country zips (e.g. amz_us + JP zip) are rejected by the backend. Examples: 10001 (NY) / 90001 (LA) / 100-0001 (Tokyo)."},"format":{"type":"string","enum":["json","markdown"],"default":"json","description":"Response format. Defaults to 'json' — a structured payload (title, price, rating, reviews, seller, etc.) ready for programmatic use. Use 'markdown' if you want the rendered PDP text instead."},"clientSource":{"type":"string","enum":["skill","mcp"],"description":"调用来源标记。仅由 Pangolinfo Skill 传 skill；普通 MCP 调用省略即可。"}},"required":["asin"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_amazon_reviews","description":"[Amazon review batch scrape] Page-fetch real buyer reviews for an ASIN. Filterable by star / sort / media type.\nUse when: user says \"look at X's negative reviews\" / \"mine pain points\" / \"analyse competitor reviews\" / \"do VOC\" / \"find user complaints for Listing copy\"; or pre-launch critical-review scan; or finding improvement points for listing optimization.\nDon't use: when the few reviews already in the PDP would suffice (get_amazon_product carries 5-10 reviews + aiReviewsSummary — enough for a quick read); for keyword search (use search_amazon).\nReturns: data.json[0].data = { totalReviews (total review count; empty when unavailable), results[{ reviewId, date, country, star, title, content, author, authorId, authorLink, imgs[], videos, purchased, vineVoice, helpful, attributes }] } — ~10 reviews per page.\nPair with: ↑ asin typically from search_amazon / get_amazon_product / list_bestsellers; ↓ review text can be fed directly to an LLM for pain-point clustering and keyword extraction.\nCost: **10 points per page** (expensive). Start with pageCount=1 to confirm data, scale to 3-5 only when needed. Prefer filterByStar='critical' — highest signal density.\nTips: filterByStar = all_stars / five_star ... one_star / positive / critical; sortBy = recent (default) | helpful; mediaType = all_contents (default) | media_reviews_only (with photos/videos, higher credibility).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"asin":{"type":"string","pattern":"^[A-Za-z0-9]{10}$","description":"Amazon ASIN (10 letters/digits, case-insensitive — auto-uppercased). Example: 'B0B4NLGCH5'."},"site":{"type":"string","enum":["amz_us","amz_de","amz_uk","amz_jp","amz_au","amz_mx","amz_in","amz_eg","amz_ae","amz_ca"],"default":"amz_us","description":"Amazon review marketplace: 10 supported sites including Japan (amz_jp). Defaults to amz_us."},"pageCount":{"type":"integer","minimum":1,"maximum":10,"default":1,"description":"Number of review pages to fetch (~10 reviews per page). **Costs 10 points per page** — control accordingly. Defaults to 1."},"filterByStar":{"type":"string","enum":["all_stars","five_star","four_star","three_star","two_star","one_star","positive","critical"],"default":"all_stars","description":"Filter by star rating. For VOC pain-point mining, pass 'critical' (1-3 star reviews) to surface defects; for positive-aspect extraction, pass 'positive'."},"sortBy":{"type":"string","enum":["recent","helpful"],"default":"recent","description":"Sort order: 'recent' (newest first — track current sentiment) or 'helpful' (most-upvoted first — highest impact reviews)."},"mediaType":{"type":"string","enum":["all_contents","media_reviews_only"],"default":"all_contents","description":"Review type: 'all_contents' for all, 'media_reviews_only' for reviews with photos/videos only (higher credibility)."},"zipcode":{"type":"string","description":"ZIP code that must match the site country (amz_us → US zip, amz_jp → JP zip, ...). Optional; backend picks a random one from the per-country pool when omitted. Cross-country zips (e.g. amz_us + JP zip) are rejected by the backend. Examples: 10001 (NY) / 90001 (LA) / 100-0001 (Tokyo)."},"clientSource":{"type":"string","enum":["skill","mcp"],"description":"调用来源标记。仅由 Pangolinfo Skill 传 skill；普通 MCP 调用省略即可。"}},"required":["asin"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_category_children","description":"[Amazon category tree drilldown] List direct children from any node (or omit parent to start at the roots).\nUse when: user says \"show me Amazon's category tree\" / \"subcategories under X\" / \"list top-level departments\" / \"drill to level 3\"; building a category map; deciding which level is right after search_categories returned candidates.\nDon't use: when a keyword jump is faster (use search_categories); when you want products in the category, not its subcategories (use list_category_products).\nReturns: data.items.data[{ browseNodeId, browseNodeIdPath, browseNodeName, browseNodeNameCn, parentBrowseNodeIdPath, productType, sellable, hasChild }] + data.items.pagination.{ total, page, size, hasNext }; omit parentBrowseNodeIdPath to fetch top-level roots; hasChild=1 means the node has further children. **Pagination**: use the 'page' param (default 1, size default 10 / max 50); 'pagination.hasNext=true' means the node has more children not yet listed.\nPair with: ↑ parentBrowseNodeIdPath either omitted (roots) or from search_categories; ↓ feed each result's browseNodeIdPath back in to drill another level, or into list_category_products / filter_categories.\nCost: ~1 point/page, ~3s. **Only paginate when a node has unusually many children (>size) and the user explicitly wants all subcategories.**","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"parentBrowseNodeIdPath":{"type":"string","description":"Parent node path. Either a single browseNodeId or a slash-joined path. Examples: '2619526011' (Appliances, drill from top) / '2619526011/18116197011' (Appliances > Ranges/Ovens/Cooktops, level-3 drill). Omit to fetch top-level roots."},"page":{"type":"integer","minimum":1,"default":1,"description":"Page number, 1-based."},"size":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Page size."},"clientSource":{"type":"string","enum":["skill","mcp"],"description":"调用来源标记。仅由 Pangolinfo Skill 传 skill；普通 MCP 调用省略即可。"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_category_paths","description":"[Amazon category breadcrumb resolver] Batch-resolve categoryId list to full paths (e.g. 'Electronics > Headphones > Over-Ear Headphones').\nUse when: a report needs readable category context (not bare IDs); user has a list of numeric IDs and wants the names; multiple categories need labels for comparison.\nDon't use: for a single ID — most other tools already return browseNodeNamePath in their responses; for tree structure (use get_category_children).\nReturns: data.items[{ categoryId, categoryName, categoryNameCn, browseNodeNamePaths[], browseNodeNamePathCns[] }] — one row per input ID.\nPair with: ↑ categoryIds from any prior step (filter_niches/filter_categories output, user-pasted ID list); ↓ usually presentation-only, downstream rarely depends on it.\nCost: ~1 point/call, ~2s (cheaper than N single resolutions).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"categoryIds":{"type":"array","items":{"type":"string"},"minItems":1,"description":"Category IDs to resolve full path for. Examples: ['2619526011'] (Appliances) / ['172282', '11965861'] (Electronics + Musical Instruments)."},"site":{"type":"string","enum":["amz_us","amz_uk","amz_de","amz_jp","amz_fr","amz_it","amz_es","amz_ca","amz_au","amz_sa","amz_ae","amz_br","amz_mx"],"default":"amz_us","description":"Amazon marketplace. Defaults to 'amz_us' (US)."},"clientSource":{"type":"string","enum":["skill","mcp"],"description":"调用来源标记。仅由 Pangolinfo Skill 传 skill；普通 MCP 调用省略即可。"}},"required":["categoryIds"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"keyword_trends","description":"[Keyword Trends via Google Trends] Keyword popularity (data source: Google Trends; use must comply with Google Terms of Service). Time series + per-region heatmap + rising related queries (with 'Breakout' tags). Compare up to 5 keywords on one chart.\nUse when: user says \"how hot is keyword X\" / \"A vs B popularity\" / \"any seasonality\" / \"which states love X\" / \"find breakout terms\" / \"new-product direction\" / \"trend comparison\" / \"is X past its peak yet\".\nDon't use: for absolute search volume (Trends is 0-100 relative); for products/links (use search_amazon / ai_search); for a single keyword's snapshot (need ≥ 2 for meaningful comparison).\nReturns: data.json.{ keywordsGeoData[{ keyword, geoMapData[{ geoCode, geoName, value[], formattedValue[], hasData[] }] }], keywordsRankData[{ keyword, rankList[{ rankedKeyword[{ query, value, formattedValue, link, hasData }] }] }], timelineData[{ time, formattedTime, value[], formattedValue[] }], geoMapData[] }, taskId, url.\nPair with: ↑ keywords from user or core terms found via search_amazon; ↓ feed Breakout/rising terms back into search_amazon to explore new opportunities, or filter_niches to see if they've crystallized into a niche.\nCost: ~1.5 points/call, ~5s.\nTips: timeRange = today 12-m (default) | today 3-m | today 5-y | all ; region = ISO country code or 'WORLD'; language affects related-query language.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"keywords":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"maxItems":5,"description":"Keywords to compare (1-5). Examples: ['wireless earbuds', 'bluetooth earbuds'] (synonyms) / ['stanley quencher', 'yeti rambler', 'hydro flask'] (competing brands) / ['halloween costume'] (single keyword for seasonality)."},"timeRange":{"type":"string","enum":["now 1-H","now 4-H","now 1-d","now 7-d","today 1-m","today 3-m","today 12-m","today 5-y","all"],"default":"today 12-m","description":"Time window. Common: 'today 12-m' (last 12 months, default), 'today 3-m' (last 90 days), 'today 5-y' (5-year long-term), 'all' (since 2004)."},"region":{"type":"string","default":"US","description":"Region code (ISO country, or 'WORLD' for global). Common: 'US' / 'GB' / 'DE' / 'JP' / 'CN'."},"language":{"type":"string","default":"en-US","description":"Interface language (BCP-47), affects related-query language. Defaults to 'en-US'. Use 'zh-CN' for Chinese."},"clientSource":{"type":"string","enum":["skill","mcp"],"description":"调用来源标记。仅由 Pangolinfo Skill 传 skill；普通 MCP 调用省略即可。"}},"required":["keywords"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"list_bestsellers","description":"[Amazon Best Sellers] Top-50 ranking for a category with 24h rank deltas.\nUse when: user says \"X category bestsellers\" / \"who's #1 in X\" / \"any new entrants climbing\" / \"benchmark top sellers\"; setting baseline products during niche scouting; tracking category leadership in competitor radars.\nDon't use: for new arrivals (use list_new_releases); for full category listings beyond top 50 (use list_category_products); when you only have a keyword (use search_categories first).\nReturns: data.json[0].data.{ reftag, recsList } — recsList is a JSON-string array (parse twice); each row { id, metadataMap.{ render.zg.rank, currentSalesRank, percentageChange, twentyFourHourOldSalesRank } }.\nPair with: ↑ categorySlug from user or scene inference (e.g. 'electronics' / 'home-garden' / 'beauty'); ↓ feed id (ASIN) into get_amazon_product for single-product deep-dive.\nCost: ~1 point/call, ~5s.\nTips: categorySlug is the hyphenated English slug in amazon.com/Best-Sellers URL paths.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"categorySlug":{"type":"string","minLength":1,"description":"Amazon Best Sellers category slug (lowercase, hyphenated). Examples: 'electronics', 'home-garden', 'beauty', 'toys-and-games'. Find these in the URL path on amazon.com/Best-Sellers."},"site":{"type":"string","enum":["amz_us","amz_uk","amz_de","amz_jp","amz_fr","amz_it","amz_es","amz_ca","amz_au","amz_sa","amz_ae","amz_br","amz_mx"],"default":"amz_us","description":"Amazon marketplace. Defaults to amz_us."},"zipcode":{"type":"string","description":"ZIP code that must match the site country (amz_us → US zip, amz_jp → JP zip, ...). Optional; backend picks a random one from the per-country pool when omitted. Cross-country zips (e.g. amz_us + JP zip) are rejected by the backend. Examples: 10001 (NY) / 90001 (LA) / 100-0001 (Tokyo)."},"format":{"type":"string","enum":["json","markdown"],"default":"json","description":"Response format. Defaults to 'json' — structured Top-50 ranked ASIN list. Use 'markdown' for the rendered page text."},"clientSource":{"type":"string","enum":["skill","mcp"],"description":"调用来源标记。仅由 Pangolinfo Skill 传 skill；普通 MCP 调用省略即可。"}},"required":["categorySlug"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"list_category_products","description":"[Amazon category listing] List concrete on-sale products under a Browse Node ID (paginated, 24 rows/page).\nUse when: user says \"what's selling in category X\" / \"list products in node 12345\" / \"show me what's in this category\"; after picking a categoryId during scouting, you want to see real listings; competitor-research on category density.\nDon't use: when only the top-50 winners matter (use list_bestsellers — cheaper and more signal); for category-level aggregate metrics (use filter_categories — sales/search volume/competitor density); for niche rather than full category (use filter_niches).\nReturns: data.json[0].data.{ pageIndex, maxPage, nextPage, categoryName, pagination, results[{ asin, title, price, star, rating, rank, img }] } — 24 rows/page. **Pagination**: use the 'page' param (default 1, 1-based); 'nextPage' holds the next page number, 'nextPage=null' or 'page>=maxPage' means last page reached.\nPair with: ↑ nodeId from search_categories (keyword→category) or get_category_children (tree drilldown); ↓ asin into get_amazon_product; same categoryId can also feed filter_categories for aggregate metrics.\nCost: ~1 point/page, ~5s. **Only paginate when the user explicitly asks for more / all results** — otherwise the first page is enough.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"nodeId":{"type":"string","pattern":"^\\d+$","description":"Amazon category Browse Node ID (numeric). Examples: '172282' (Electronics) / '2619526011' (Appliances) / '11965861' (Musical Instruments). Obtain via search_categories or get_category_children."},"site":{"type":"string","enum":["amz_us","amz_uk","amz_de","amz_jp","amz_fr","amz_it","amz_es","amz_ca","amz_au","amz_sa","amz_ae","amz_br","amz_mx"],"default":"amz_us","description":"Amazon marketplace. Defaults to amz_us."},"zipcode":{"type":"string","description":"ZIP code that must match the site country (amz_us → US zip, amz_jp → JP zip, ...). Optional; backend picks a random one from the per-country pool when omitted. Cross-country zips (e.g. amz_us + JP zip) are rejected by the backend. Examples: 10001 (NY) / 90001 (LA) / 100-0001 (Tokyo)."},"format":{"type":"string","enum":["json","markdown"],"default":"json","description":"Response format. Defaults to 'json' — structured category listings. Use 'markdown' for the rendered page text."},"page":{"type":"integer","minimum":1,"default":1,"description":"Page number, 1-based. 24 rows per page. Use response's pageIndex/maxPage/nextPage to decide whether to continue: nextPage holds the next page number; nextPage=null or page>=maxPage means last page reached. **Only paginate when the user explicitly asks for more / all results** — otherwise the first page is enough."},"clientSource":{"type":"string","enum":["skill","mcp"],"description":"调用来源标记。仅由 Pangolinfo Skill 传 skill；普通 MCP 调用省略即可。"}},"required":["nodeId"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"list_new_releases","description":"[Amazon New Releases] Best-selling Top-50 ASINs that hit the market within the last 30 days for a category (backend cap; not 100).\nUse when: user says \"new arrivals in X\" / \"any breakout new products\" / \"newly-launched that sell well\" / \"trending new directions\" / \"new entrants to monitor\"; GTM scouting for new angles; competitor radar catching new entrants.\nDon't use: for evergreen winners (use list_bestsellers); for full category listings (use list_category_products); when you only have a keyword (use search_categories first).\nReturns: data.json[0].data.{ reftag='zg_bsnr_g_<slug>', recsList } — recsList is a JSON-string array (parse twice); each row { id, metadataMap.{ render.zg.rank, ... } }.\nPair with: ↑ categorySlug as in list_bestsellers; ↓ feed id (ASIN) into get_amazon_product to see why it climbed (pitch, pricing, variant strategy).\nCost: ~1 point/call, ~5s.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"categorySlug":{"type":"string","minLength":1,"description":"Amazon New Releases category slug (lowercase, hyphenated). Examples: 'electronics', 'home-garden'. Find these in the URL path on amazon.com/gp/new-releases."},"site":{"type":"string","enum":["amz_us","amz_uk","amz_de","amz_jp","amz_fr","amz_it","amz_es","amz_ca","amz_au","amz_sa","amz_ae","amz_br","amz_mx"],"default":"amz_us","description":"Amazon marketplace. Defaults to amz_us."},"zipcode":{"type":"string","description":"ZIP code that must match the site country (amz_us → US zip, amz_jp → JP zip, ...). Optional; backend picks a random one from the per-country pool when omitted. Cross-country zips (e.g. amz_us + JP zip) are rejected by the backend. Examples: 10001 (NY) / 90001 (LA) / 100-0001 (Tokyo)."},"format":{"type":"string","enum":["json","markdown"],"default":"json","description":"Response format. Defaults to 'json' — structured ranking list. Use 'markdown' for the rendered page text."},"clientSource":{"type":"string","enum":["skill","mcp"],"description":"调用来源标记。仅由 Pangolinfo Skill 传 skill；普通 MCP 调用省略即可。"}},"required":["categorySlug"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"list_seller_products","description":"[Amazon seller storefront] List all listings under a merchant ID, paginated (24 rows/page).\nUse when: user says \"show me this seller's products\" / \"how many SKUs does store X carry\" / \"competitor storefront category breadth\" / \"what is this seller pushing\" / \"research a seller's catalog strategy\".\nDon't use: without a merchant ID (find 'sold by' link on any product PDP first); for a single product (use get_amazon_product).\nReturns: data.json[0].data.{ pageIndex, maxPage, nextPage, results[{ asin, title, price, star, rating, rank, img }] } — 24 rows/page. **Every row carries rank** (its display order in the storefront, ≈ that seller's in-store popularity ranking) plus star/rating, so **this single call is enough to rank and tabulate the seller's listings — no need to re-fetch each PDP**. **Two pagination modes**: ① page locates a specific page (default 1); ② pageCount accumulates the first N pages in one call (N≤3, flat-merged into the same results). When pageCount>1, pageIndex/nextPage are blanked (pages already merged). **Category filter**: categoryId filters the seller's products by category.\nPair with: ↑ sellerId usually from get_amazon_product's seller.id field, or from amazon.com/sp?seller=... URL; categoryId extractable from the storefront URL's rh=n:<id>; ↓ feed asin into get_amazon_product to deep-dive hero products.\n**Chaining pitfall — \"what does this seller carry + sort by sales/rank\"**: ❌ Do NOT \"run get_amazon_product on every ASIN to pull each small-category BSR, then sort\" — a storefront often has dozens-to-hundreds of SKUs; fanning out one PDP per ASIN hits the 2-QPS rate wall, bills N times, and blows the Fast-tier budget. ✅ Correct: **the results[] from one call (or pageCount≤3) already carry rank; sort by rank ascending for the in-store order and tabulate with star/rating**. Only when the user explicitly wants exact global small-category BSR should you run get_amazon_product on a **small head set (e.g. the top 5-10 pre-filtered by list rank)** to read bestSellersRankItems[], batched at ≤2 concurrent — never fan out across the whole store.\nCost: ~1 point/page, ~5s; pageCount=N billed by pages actually crawled (failed pages refunded).\nTips: use pageCount to grab the full multi-page SKU set in one shot (max 3 pages); use page to view one specific page; the first page is enough to glance at what the store sells. For sorting, prefer results[].rank (free, already in this response) — don't fan out PDP fetches just to sort. Amazon first-party sellerId = 'ATVPDKIKX0DER'.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"sellerId":{"type":"string","minLength":1,"description":"Amazon merchant ID (14-char alphanumeric). Examples: 'ATVPDKIKX0DER' (Amazon.com first-party) / 'A2L77EE7U53NWQ' (Amazon Warehouse). Find it in a product page's 'sold by' link or amazon.com/sp?seller=... URL."},"site":{"type":"string","enum":["amz_us","amz_uk","amz_de","amz_jp","amz_fr","amz_it","amz_es","amz_ca","amz_au","amz_sa","amz_ae","amz_br","amz_mx"],"default":"amz_us","description":"Amazon marketplace. Defaults to amz_us."},"zipcode":{"type":"string","description":"ZIP code that must match the site country (amz_us → US zip, amz_jp → JP zip, ...). Optional; backend picks a random one from the per-country pool when omitted. Cross-country zips (e.g. amz_us + JP zip) are rejected by the backend. Examples: 10001 (NY) / 90001 (LA) / 100-0001 (Tokyo)."},"format":{"type":"string","enum":["json","markdown"],"default":"json","description":"Response format. Defaults to 'json' — structured seller listings. Use 'markdown' for the rendered page text."},"page":{"type":"integer","minimum":1,"default":1,"description":"Page number, 1-based. 24 rows per page. Use response's pageIndex/maxPage/nextPage to decide whether to continue: nextPage holds the next page number; nextPage=null or page>=maxPage means last page reached. **Only paginate when the user explicitly asks for more / all SKUs** — otherwise the first page is enough. NOTE: when pageCount>1 (multi-page accumulate) is set, page is ignored (the backend always accumulates from page 1)."},"pageCount":{"type":"integer","minimum":1,"maximum":3,"default":1,"description":"Multi-page accumulate: passing N crawls the first N pages in one call and returns them flat-merged (e.g. 3 = all products from pages 1+2+3). Default 1 (single page, uses the `page` flow); cap 3, larger values treated as 3. Difference vs `page`: `page` locates one specific page, `pageCount` pulls the first N pages merged. **Use only when you need the full multi-page SKU set in one shot.** Billed by pages actually crawled (a failed page is refunded)."},"categoryId":{"type":"string","description":"Category filter ID — filters the seller's products by category. A single leaf category ID (e.g. '7161074011'), or comma-separated multi-level categories (e.g. '172282,502394,7161073011'). Omit = all products of the seller. Extractable from the rh=n:<categoryId> part of an Amazon storefront URL."},"clientSource":{"type":"string","enum":["skill","mcp"],"description":"调用来源标记。仅由 Pangolinfo Skill 传 skill；普通 MCP 调用省略即可。"}},"required":["sellerId"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"pangolinfo_capabilities","description":"[Pangolinfo MCP self-introspection] One call to get the full capability catalog, canonical workflows, and usage tips — no backend call, free.\nUse when: an AI client first connects to pangolinfo-mcp and needs to quickly grasp \"what tools exist\" / \"how do they chain\" / \"which workflow for which scene\"; user asks \"what can you do\" / \"what capabilities are there\"; capability audit before SOP planning.\nDon't use: for the full description of one specific tool (use tools/list — the 'summary' mode here gives one-liners only); for account balance or remaining credits (CONTRACT §9 forbids exposing account endpoints via MCP).\nReturns: { version, locale, liveTools[{name, domain, oneLiner, cost}], workflows[{title, steps[], note}], tips[] }.\nPair with: ↓ AI decides which concrete tool to call next; does not consume downstream tools.\nCost: 0 points (local data, no backend round-trip).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"detail":{"type":"string","enum":["summary","full"],"default":"summary","description":"'summary' returns tool catalog + canonical workflows (default, token-light); 'full' also expands all 20 tool descriptions (use on first integration or when context budget allows)."},"clientSource":{"type":"string","enum":["skill","mcp"],"description":"调用来源标记。仅由 Pangolinfo Skill 传 skill；普通 MCP 调用省略即可。"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"scrape_url","description":"[Amazon Scraper API — generic page access] Scrape pages the 5 purpose-built tools don't cover. Two input modes (pick one):\n① content=bare fragment (keyword / nodeId / sellerId / ASIN) + site — backend builds a basic URL per parserName. **content mode carries NO filter/sort/pagination** — it's just the bare fragment. Best for simple pages when you only have the fragment.\n② url=full Amazon link — **put ANY filter/sort/pagination into this url** (the only way, since content mode can't). Filter syntax examples: price $25-50 → '/s?k=earbuds&low-price=25&high-price=50'; sort by reviews → '&s=review-rank'; paginate → '&page=2'; category+price → '/s?i=aps&rh=n%3A172282&fs=true&low-price=25'.\nUse when: a standard tool can't build the target URL — \"search X but only $25-50\" / \"results sorted by reviews\" / \"category filtered by price\"; or the user already has a specific Amazon link. For any filtering, use url mode.\nDon't use: when a purpose-built tool fits — plain keyword search → search_amazon, single ASIN → get_amazon_product, seller → list_seller_products, category ranks → list_bestsellers/list_new_releases.\nReturns (format='json'): data.json[0].data.{ ... results[] ... }, shape depends on parserName. amzFollowSeller returns items[{options,price,delivery,shipsFrom,soldBy,hasSoldByLink,isFeatured?}], where hasSoldByLink explicitly tells whether the seller name was a hyperlink. ⚠️ If content/url doesn't match parserName, the backend returns data.{ status_code, rawHtml, url } (unparsed).\nPair with: ↓ feed asin into get_amazon_product / get_amazon_reviews.\nCost: ~1 point/call, ~5s.\n⚠️ Pass exactly one of content / url (both or neither errors); filtering/pagination requires url mode; parserName must match the page type.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"parserName":{"type":"string","enum":["amzKeyword","amzProductDetail","amzProductOfCategory","amzProductOfSeller","amzBestSellers","amzNewReleases","amzReviewV2","amzFollowSeller","amzVariantAsin"],"description":"Parser deciding how the backend extracts the page AND builds the URL from content. Must match the page type: amzKeyword=keyword search (content=keyword) / amzProductOfCategory=category (content=nodeId) / amzProductOfSeller=seller storefront (content=sellerId) / amzProductDetail=single product (content=ASIN) / amzBestSellers / amzNewReleases / amzReviewV2=reviews / amzFollowSeller=follow-seller / amzVariantAsin=variant."},"content":{"type":"string","description":"Bare fragment (backend builds the URL per parserName). Pass this OR url. Examples: 'wireless earbuds' (amzKeyword) / '172282' (nodeId for amzProductOfCategory) / 'ATVPDKIKX0DER' (sellerId for amzProductOfSeller) / 'B0B4NLGCH5' (ASIN for amzProductDetail, amzDeliveryTime, or amzFollowSeller). Users/AI usually only have the fragment — prefer this."},"url":{"type":"string","format":"uri","description":"Full Amazon URL (https://). Pass this OR content. Use when you already have a ready link (e.g. a filtered/sorted SERP copied from the browser). Example: 'https://www.amazon.com/s?k=earbuds&rh=p_36%3A2500-5000&s=review-rank'. Must match parserName."},"site":{"type":"string","enum":["amz_us","amz_de","amz_uk","amz_jp","amz_fr","amz_it","amz_es","amz_ca","amz_au","amz_mx","amz_sa","amz_ae","amz_br"],"default":"amz_us","description":"Amazon site (in content mode the backend picks the domain from this). Defaults to amz_us. Optional in url mode (the URL already has the domain)."},"format":{"type":"string","enum":["json","markdown"],"default":"json","description":"Response format. Defaults to 'json' (structured results). Use 'markdown' for the rendered page text."},"zipcode":{"type":"string","enum":["10041","90001","60601","84104","W1S 3AS","EH15 1LR","M13 9PL","M2 5BQ","M4C 4Y4","V6E 1N2","H3G 2K8","T2R 0G5","80331","10115","20095","60306","75000","69001","06000","13000","100-0004","060-8588","163-8001","900-8570","20019","50121","00042","30100","41001","28001","08001","46001","2000_SYDNEY","3000_MELBOURNE","01000","55000","Riyadh_الرياض","Jeddah_جدة","Abu Dhabi_ADCO Compound","Ajman_Aamra","03001-000","20031-000"],"description":"ZIP/postal code matching the site or URL country. Optional; backend picks one when omitted. Supported: US 10041/90001/60601/84104; UK W1S 3AS/EH15 1LR/M13 9PL/M2 5BQ; CA M4C 4Y4/V6E 1N2/H3G 2K8/T2R 0G5; DE 80331/10115/20095/60306; FR 75000/69001/06000/13000; JP 100-0004/060-8588/163-8001/900-8570; IT 20019/50121/00042/30100; ES 41001/28001/08001/46001; AU 2000_SYDNEY/3000_MELBOURNE; MX 01000/55000; SA Riyadh_الرياض/Jeddah_جدة; AE Abu Dhabi_ADCO Compound/Ajman_Aamra; BR 03001-000/20031-000."},"clientSource":{"type":"string","enum":["skill","mcp"],"description":"调用来源标记。仅由 Pangolinfo Skill 传 skill；普通 MCP 调用省略即可。"}},"required":["parserName"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"search_amazon","description":"[Amazon SERP scrape] Run a real Amazon keyword search and return the first-page ASIN list.\nUse when: user says \"search Amazon for X\" / \"who sells X\" / \"top results for keyword X\" / \"competitors for X\"; or you need a list of ASINs for a keyword as upstream input to deeper analysis.\nDon't use: for a single ASIN detail (use get_amazon_product); for category bestseller ranks (use list_bestsellers); for Google/external demand on the term (use ai_search or keyword_trends).\nReturns (format='json', default): data.json[0].data.{ pageIndex, nextPage, keyword, results[{ asin, title, price, star, rating, sales, badge, rank, sponsored, image, delivery }] } — ~22 rows/page. **Pagination**: use the 'page' param (default 1, 1-based); response's 'nextPage' holds the next page number, 'nextPage=null' means last page reached.\nPair with: ↓ feed results[].asin into get_amazon_product / get_amazon_reviews for single-product deep-dive; ↓ feed the same keyword into keyword_trends to compare in-site vs external demand.\nCost: ~1 point/page, ~5s. **Only paginate when the user explicitly asks for more / Top-N (N>22) / all results** — otherwise the first page is enough.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"keyword":{"type":"string","minLength":1,"description":"Search keyword. Examples: 'wireless earbuds' / 'stanley quencher' / 'iphone 16 case' / 'kitchen knife set'."},"site":{"type":"string","enum":["amz_us","amz_uk","amz_de","amz_jp","amz_fr","amz_it","amz_es","amz_ca","amz_au","amz_sa","amz_ae","amz_br","amz_mx"],"default":"amz_us","description":"Amazon marketplace. Defaults to 'amz_us' (US)."},"zipcode":{"type":"string","description":"ZIP code that must match the site country (amz_us → US zip, amz_jp → JP zip, ...). Optional; backend picks a random one from the per-country pool when omitted. Cross-country zips (e.g. amz_us + JP zip) are rejected by the backend. Examples: 10001 (NY) / 90001 (LA) / 100-0001 (Tokyo)."},"format":{"type":"string","enum":["json","markdown"],"default":"json","description":"Response format. Defaults to 'json' — structured search rows (asin, title, price, star, rating, sales, badge, rank, ...) ready for programmatic use. Use 'markdown' if you want the rendered SERP text instead."},"page":{"type":"integer","minimum":1,"default":1,"description":"Page number, 1-based. ~22 ASINs per page. Use response's pageIndex/nextPage to decide whether to continue: nextPage holds the next page number; nextPage=null (or absent) means last page reached. **Only paginate when the user explicitly asks for more / Top-N where N exceeds one page / all results** — otherwise the first page is enough."},"clientSource":{"type":"string","enum":["skill","mcp"],"description":"调用来源标记。仅由 Pangolinfo Skill 传 skill；普通 MCP 调用省略即可。"}},"required":["keyword"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"search_amazon_alexa","description":"[Alexa Agent API] Ask Amazon Rufus and receive answers, grouped product recommendations and follow-up suggestions. Separate pools support the United States (default) and Japan.\nUse when: scenario-based discovery, gifts or open-ended shopping advice. Use search_amazon for explicit keywords and get_amazon_product for a single ASIN.\nReturns: data.json[{prompt,content,products[{title,items[{asin,url,title,cover,score,ratingsCount,price,originalPrice,describe}]}],follow_up_questions[]}]. Products and suggestions depend on Amazon's answer and may be empty.\nCost: 6 points per prompt; N prompts=N×6. Turns within one call share context; separate calls do not.\nNon-screenshot requests use native HTTP; screenshots use the browser path. Latency varies with initialization, network and question, with no fixed-time guarantee. Allow at least 120 seconds in the client; do not issue concurrent duplicates while waiting.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"prompts":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"maxItems":5,"description":"1–5 natural-language prompts. Prompts within one call form a sequential conversation; separate calls do not retain context. Each prompt costs 6 points (N prompts=N×6); multiple turns increase latency."},"site":{"type":"string","enum":["us","jp"],"default":"us","description":"Amazon marketplace: us (United States, default) or jp (Japan). Pools are isolated; unavailable markets fail rather than falling back to the US."},"screenshot":{"type":"boolean","default":false,"description":"Return a page screenshot. False uses native HTTP; true explicitly selects the slower browser-rendered path."},"clientSource":{"type":"string","enum":["skill","mcp"],"description":"调用来源标记。仅由 Pangolinfo Skill 传 skill；普通 MCP 调用省略即可。"}},"required":["prompts"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"search_categories","description":"[Amazon category search] Match Amazon's category tree by keyword (Chinese or English) and return candidate nodes.\nUse when: user gave a keyword/concept rather than a category id, and a downstream tool needs categoryId / browseNodeId (e.g. filter_niches / filter_categories / list_category_products / inferring list_bestsellers slug); when you need to know where a product concept lives in Amazon's taxonomy.\nDon't use: when you already have categoryId/nodeId (use get_category_paths for breadcrumbs or a downstream filter directly); when you want to drill the subtree (use get_category_children).\nReturns: data.items.data[{ browseNodeId, browseNodeIdPath, browseNodeName, browseNodeNameCn, browseNodeNamePath, browseNodeNamePathCn, parentBrowseNodeIdPath, productType, sellable, hasChild }] + pagination.\nPair with: ↓ feed browseNodeId into list_category_products / list_bestsellers (derive slug from path) / filter_niches / filter_categories; ↓ feed into get_category_children to drill further; ↓ feed into get_category_paths for breadcrumbs.\nCost: ~1 point/call, ~3s.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"keyword":{"type":"string","minLength":1,"description":"Category name keyword (Chinese or English). Examples: 'headphones' / 'kitchen knives' / '无线耳机' / 'wireless earbuds'."},"site":{"type":"string","enum":["amz_us","amz_uk","amz_de","amz_jp","amz_fr","amz_it","amz_es","amz_ca","amz_au","amz_sa","amz_ae","amz_br","amz_mx"],"default":"amz_us","description":"Marketplace to search categories in. Defaults to 'amz_us'."},"clientSource":{"type":"string","enum":["skill","mcp"],"description":"调用来源标记。仅由 Pangolinfo Skill 传 skill；普通 MCP 调用省略即可。"}},"required":["keyword"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"search_local_maps","description":"[Local Maps via Google Maps] Local-business search (data source: Google Maps; use must comply with Google Terms of Service). Search local businesses at a given lat/lng — returns name, address, rating, review count, etc.\nUse when: user says \"Y businesses in city X\" / \"local retail research\" / \"offline channel distribution\" / \"coffee shops/supermarkets/wholesalers in area\" / \"physical-store coverage density\"; offline competitor/channel research; gauging physical-supply density of a category in a region.\nDon't use: for e-commerce listings (Amazon series); for global trends (use keyword_trends); for Google search results (use ai_search).\nReturns: data.organicResults[{ place_id, name, about, rating, number_of_reviews, borough, street_addr, city, postal_code, ... }].\nPair with: ↑ query (business keyword) + latitude/longitude/zoom (zoom 1=world, 13=city, 21=single building); ↓ presentation-focused, downstream rarely consumes.\nCost: ~1.5 points/call, ~5s.\nTips: zoom 13 (city, default) gives you a whole neighborhood; zoom 17+ narrows to one street.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"description":"Local search query. Examples: 'coffee shop' / 'wholesale electronics' / '电子产品批发' / 'pet store'."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude of search center. Examples: 37.7822 (San Francisco) / 40.7128 (New York) / 34.0522 (Los Angeles)."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude of search center. Examples: -122.4642 (San Francisco) / -74.0060 (New York) / -118.2437 (Los Angeles)."},"zoom":{"type":"integer","minimum":1,"maximum":21,"default":13,"description":"Map zoom level, 1=world, 13=city, 21=building. Default 13."},"language":{"type":"string","default":"en","description":"BCP-47 language code, e.g. 'en', 'zh-CN'."},"limit":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Max results to return (1-100)."},"clientSource":{"type":"string","enum":["skill","mcp"],"description":"调用来源标记。仅由 Pangolinfo Skill 传 skill；普通 MCP 调用省略即可。"}},"required":["query","latitude","longitude"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"wipo_search","description":"[Design Patent TRO risk control · WIPO global design / IP search] Query the WIPO design database across 12 sources (USPTO US designs, CNID China, HAGUE international registrations, …), with one-click chaining to US design-patent TRO (temporary restraining order) / litigation risk control.\nUse when: user says \"check trademark\" / \"design patent search\" / \"any IP risk for new product\" / \"X company's patent portfolio\" / \"WIPO search\" / \"USPTO query\" / \"what is registration DM/XXX\"; pre-launch IP clearance during scouting/GTM SOPs; competitor IP-portfolio research.\nDon't use: for keyword ranks / product reviews / product detail (this is an IP database, not a commerce database); for US text-trademark search (this DB focuses on design patents — text trademark coverage is limited).\nReturns: data.data.{ total, hits[{ IRN, HOL[], DETAIL_DATA.structured.{indication_of_products, statement_of_novelty, ...}, IMG[], IMG_DATA[{filename,url}], DC, RD, STATUS, LCS[], DS[], PROD[], SOURCE, DETAIL_URL }] }. With enableLitigation=true each matched patent additionally carries litigationStatus(success/skipped/failed) + caseTotal + cases[{ caseId, docketNumber, caseName, court, status, dateFiled, parties[], patentNumbers[], entries[] }] (backed by US PACER litigation data — one call returns patents + lawsuits).\nPair with: ↑ source required; hol=holder name / prod=product name / irn=international registration / lcs=design classification; enableLitigation=true chains US litigation lookup (IP-risk loop, no separate tool needed); ↓ DETAIL_URL lets the user jump to WIPO's official page to verify.\nCost: ~2 points/call, ~5s; with enableLitigation=true add +12 points only when a patent is found (free if none).\n⚠️ Perf contract: CNID + hol/prod MUST be paired with id/idSearch/rd/status/lcs (otherwise the backend rejects to avoid a 17M-row full scan); JPID has no HOL/PROD; USID has no STATUS; ed (expiration date) is silently ignored on all sources — filter dates via rd instead. With enableLitigation on, each page re-triggers the litigation query and billing.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"source":{"type":"string","enum":["USID","CNID","DEID","JPID","KRID","EMID","FRID","INID","ITID","ESID","CHID","HAGUE"],"description":"Data source (required). WIPO data is partitioned by source — cross-source queries not supported. Common: USID (US design), CNID (China design, 17M+ rows), HAGUE (Hague international), DEID, JPID."},"ds":{"type":"string","description":"Designated country code (e.g. 'US', 'CN'). Optional — usually implied by `source`."},"hol":{"type":"string","description":"Holder name fuzzy match. Examples: 'Apple' / 'Samsung' / 'Nike'. NOTE: CNID + hol MUST be paired with id/idSearch/rd/status/lcs; JPID has no HOL column (will be ignored)."},"prod":{"type":"string","description":"Product name fuzzy match. CNID searches Chinese, other sources search English. Examples: '椅子' (CNID) / 'wireless headphones' (USID) / 'iphone case' (USID). CNID + prod MUST be paired with id/idSearch/rd/status/lcs; JPID has no PROD column."},"irn":{"type":"string","description":"International Registration Number exact match. Examples: 'DM/000298' (HAGUE) / 'D1107730' (USID)."},"id":{"type":"string","description":"Full ID exact match, e.g. 'CNID.2023.123456'. Routes CNID queries to a single partition (avoids full scan)."},"idSearch":{"type":"string","description":"ID variant fuzzy match."},"rd":{"type":"string","description":"Registration date (YYYY or YYYY-MM-DD). One of the recommended narrowing fields for CNID — routes to a year partition."},"status":{"type":"string","description":"Legal status: 'ACT' (active), 'EXP' (expired), etc. USID has no STATUS column (will be ignored)."},"lcs":{"type":"string","description":"Design classification (Locarno Classification code), e.g. '23-01' = fluid distribution equipment."},"from":{"type":"integer","minimum":0,"default":0,"description":"Pagination offset, 0-based."},"num":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Page size (default 10, max 100)."},"enableLitigation":{"type":"boolean","default":false,"description":"Enable Smart Risk Control Mode: after patents match, auto-query related US litigation (PACER backend) by patent number; cases are joined into each patent's `cases` field. Default false. When on, each matched patent gains litigationStatus / caseTotal / cases; +12 points charged only when a patent is found (free if none)."},"clientSource":{"type":"string","enum":["skill","mcp"],"description":"调用来源标记。仅由 Pangolinfo Skill 传 skill；普通 MCP 调用省略即可。"}},"required":["source"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}],"scan":{"score":83,"grade":"B","scanned_at":"2026-09-21T13:07:19.445Z","report":{"scannerVersion":"0.1.9","scannedAt":"2026-09-21T13:07:19.414Z","components":{"code":{"score":-1,"max":25,"notes":["remote-only server, no package to scan"]},"reliability":{"score":17,"max":20,"notes":["remote reachable in 2466ms"]},"poisoning":{"score":13,"max":15,"notes":["21 tool descriptions checked"]},"auth":{"score":10,"max":15,"notes":["open endpoint, read-only tools"]},"maintenance":{"score":15,"max":15,"notes":["last push 4 days ago"]},"identity":{"score":7,"max":10,"notes":["registry namespace matches repository owner"]}},"findings":[{"id":"poison.long-description","severity":"low","component":"poisoning","title":"Unusually long tool description (over 2,000 characters)","evidence":"tool get_amazon_product: …[Amazon single-product detail] Scrape the full PDP for one ASIN. Use when: user supplies a specific ASIN (\"look at B0XXXXXXXX\" / \"check this product's price/rating/seller\" / \"analyse this competitor\"); or as a SOP step after candidate ASINs are picked. Don't use: for many products at once (use search_amazon or list_* series for lists); for reviews only (use get_amazon_reviews — cheaper and more focused). Returns (format='json', default): data.json[0].data.results[0] = { asin, title, itemName, itemHighlights, price, star, rating, brand, seller{name,id,link,hasLink}, parentAsin, videos[{type,section,mp4,m3u8,previewMp4,cover,title,duration,author}], shippingFee (buyer shipping fee as a number, e.g. \"750\"; \"0\" when free shipping or no info, varies by the zipcode address), delivery{deliveryTime,fastestDelivery}, ratingDistribution[], aiReviewsSummary, bestSellersRankItems, reviews[{date,star,content,helpful,...}], productOverview[], features[], productDescription[], images[], variantDetails[], attributes[], category_id, breadCrumbs, ... } — 30+ fields (variantDetails summary included). videos[].section: product=main media gallery, brand=brand module, related=related videos, customerReview=customer review videos. Use get_amazon_delivery_time when you need the high-return warning, free/paid/fastest delivery breakdown, or handling lead time. Title fields (Amazon split the title into two parts starting 2026-07-27): title=the full raw title string (for rolled-out listings it contains a \" | \" separator, unsplit); itemName=the title body (the part before \" | \", i.e. the product name, ≤75 chars); itemHighlights=the title highlights (the part after \" | \", e.g. material/use-case/selling points, ≤125 chars). For legacy (not-yet-rolled-out) listings itemName=the full title and itemHighlights is an empty string. Use itemName for the clean product name, itemHighlights for selling points. Pair with: ↑ asin typically comes from search_amazon / list_bestsellers / filter_niches; ↓ feed the same asin into get_amazon_reviews for more reviews (the PDP carries only ~5-10). Cost: ~1 point/call, ~5s.…"}],"inputs":{"probes":[{"url":"https://mcp.pangolinfo.com/mcp?api_key={api_key}","reachable":true,"authRequired":false,"latencyMs":2466,"serverInfo":{"name":"pangolinfo-mcp","version":"0.9.2"}}],"packages":[],"repo":{"found":true,"owner":"pangolinfo","repo":"pangolinfo-mcp","archived":false,"pushedAt":"2026-09-17T13:04:19Z","stars":6,"forks":0,"openIssues":1,"ownerType":"Organization","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/270528751?v=4","ownerCreatedAt":"2026-03-24T03:17:55Z","license":"MIT"},"icon":{"url":"https://e67fff9a.delivery.rocketcdn.me/wp-content/uploads/2023/06/Pangolin.ico","source":"site","width":48,"height":48},"presence":{"stars":6,"forks":0,"downloadsWeek":null,"license":"MIT","lastPushAt":"2026-09-17T13:04:19.000Z","score":28}}}},"grade_history":[],"reviews":[]}