Documents
Analyze an ASIN's traffic source breakdown across organic search, ads, and Amazon recommendation placements.
Calls the SIF ASIN Summary API to break down an ASIN's exposure and keyword count across channels: natural search, SP ads, brand ads (top/bottom), video ads, Amazon's Choice, Editorial Recommendations, Top Rated, and recommendation positions. Each channel exposes an exposure score, exposure ratio, and keyword count. Period-over-period comparison is supported via Prev, In (new this period), and Out (exited) fields. Up to 10 ASINs can be queried at once for competitor traffic-structure comparison across 13 marketplaces (US default). Responses save to a JSON file in the working directory; small responses print in full, large ones are summarized.
This skill guides you on how to query and analyze ASIN-level traffic source data, helping Amazon sellers understand the exposure and traffic structure of any product across multiple channels.
SIF (Search Intelligence Framework) ASIN Summary provides a comprehensive breakdown of an ASIN's traffic sources on Amazon. It reveals how a product's total exposure is distributed across organic search, Sponsored Products ads, brand ads, video ads, Amazon's Choice, Editorial Recommendations, and Top Rated recommendations. This is essential for competitive analysis and traffic strategy optimization.
Exposure score: A composite metric reflecting the overall visibility of a product across all keywords in a given channel. A higher score means greater exposure. The exposure ratio fields show what percentage of total exposure comes from each channel (values range 01 or 0100 depending on the field).
Traffic keyword count: The total number of keywords through which a product is discovered, broken down by channel (organic search, SP ads, brand ads, video ads, etc.).
Field-name suffixes:
*Prev= previous-period value;*In/*Out= keywords entering / exiting this period (for period-over-period comparison).
| Field | API Name | Description |
|---|---|---|
| ASIN | asin | Amazon Standard Identification Number |
| Product Title | productTitle | Full product title on Amazon |
| Product Category | productCategory | Product category on Amazon |
| Product Price | productPrice | Current listing price |
| Product Image URL | productImageUrl | Main product image link |
| Product Features | productFeatures | Bullet-point product features list |
| Customer Rating Count | customerRatingCount | Total number of customer ratings |
| Product Star Rating | productStarRating | Product star rating (0–5) |
| Product Rating Score | productRatingScore | Product rating score (0–5, as shown on Amazon) |
| Is Variant Product | isVariantProduct | Whether the ASIN is a variant (e.g., different color/size) |
| Recent Monthly Sales Bucket | recentMonthlySalesBucket | Bucketed last-month sales (e.g. "300+", "1,000+") — only populated for keywordSummary path |
| Is Monitored | isMonitored | Whether the ASIN is on the monitoring list |
| Monitoring Start Time | monitoringStartTime | When the ASIN was added to monitoring |
| Data Period Start Date | dataPeriodStartDate | Start date of the returned data period (yyyy-MM-dd) |
| Total Exposure Score | totalExposureScore | Composite exposure score across all channels |
| Total Exposure Score Prev | totalExposureScorePrev | Total exposure score in the previous period |
| Total Traffic Keyword Count | totalTrafficKeywordCount | Total keywords across all channels |
| Total Keywords In / Out / Prev | totalTrafficKeywordCountIn / Out / Prev | New / exited / previous-period counterparts |
| Natural Search Exposure Score | naturalSearchExposureScore | Exposure score from organic search |
| Natural Search Exposure Ratio | naturalSearchExposureRatio | Organic search share of total exposure |
| Natural Search Exposure Score Prev | naturalSearchExposureScorePrev | Previous-period organic exposure score |
| Natural Search Keyword Count | naturalSearchKeywordCount | Keywords found in organic search results |
| Natural Keywords In / Out / Prev | naturalSearchKeywordCountIn / Out / Prev | New / exited / previous-period counterparts |
| SP Ad Exposure Score | sponsoredProductsExposureScore | Exposure score from Sponsored Products ads |
| SP Ad Exposure Ratio | sponsoredProductsExposureRatio | SP ad share of total exposure |
| SP Ad Exposure Score Prev | sponsoredProductsExposureScorePrev | Previous-period SP exposure score |
| SP Ad Keyword Count | sponsoredProductsKeywordCount | Keywords with SP ad placements |
| Brand Ad Exposure Score | brandAdExposureScore | Exposure score from brand ads |
| Brand Ad Exposure Ratio | brandAdExposureRatio | Brand ad share of total exposure |
| Brand Ad Exposure Score Prev | brandAdExposureScorePrev | Previous-period brand ad exposure score |
| Brand Ad Keyword Count | brandAdKeywordCount | Total brand ad keywords |
| Top Brand Ad Keyword Count | topBrandAdKeywordCount | Keywords in top-of-page brand ads |
| Bottom Brand Ad Keyword Count | bottomBrandAdKeywordCount | Keywords in bottom-of-page brand ads |
| Video Ad Exposure Score | videoAdExposureScore | Exposure score from video ads |
| Video Ad Exposure Ratio | videoAdExposureRatio | Video ad share of total exposure |
| Video Ad Exposure Score Prev | videoAdExposureScorePrev | Previous-period video ad exposure score |
| Video Ad Keyword Count | videoAdKeywordCount | Keywords with video ad placements |
| Amazon's Choice Exposure Score | amazonsChoiceExposureScore | Exposure score from AC badge |
| Amazon's Choice Exposure Ratio | amazonsChoiceExposureRatio | AC share of total exposure |
| Amazon's Choice Exposure Score Prev | amazonsChoiceExposureScorePrev | Previous-period AC exposure score |
| Amazon's Choice Keyword Count | amazonsChoiceKeywordCount | Keywords with AC badge |
| AC Keywords In / Out | amazonsChoiceKeywordCountIn / Out | New / exited AC keywords this period |
| Editorial Recommendations Exposure Score | editorialRecommendationsExposureScore | Exposure from editorial recommendations |
| Editorial Recommendations Exposure Ratio | editorialRecommendationsExposureRatio | ER share of total exposure |
| Editorial Recommendations Keyword Count | editorialRecommendationsKeywordCount | Keywords with ER placements |
| Top Rated Exposure Score | topRatedExposureScore | Exposure from Top Rated recommendations |
| Top Rated Exposure Ratio | topRatedExposureRatio | TR share of total exposure |
| Top Rated Keyword Count | topRatedKeywordCount | Keywords with TR placements |
| Frequently Bought Keyword Count | frequentlyBoughtKeywordCount | Keywords in frequently-bought recommendations |
| Recommend Position Exposure Score | recommendPositionExposureScore | Total recommendation-position exposure score |
| Recommend Ad Exposure Score | recommendAdExposureScore | Ad portion of recommendation-position exposure |
| Recommend Non-ad Exposure Score | recommendNonadExposureScore | Non-ad portion of recommendation-position exposure |
| Non-AC Recommend Exposure Score | nonAcRecommendExposureScore | Recommendation-position exposure excluding AC slots |
| Recommend Keyword Count | recommendKeywordCount | Total recommendation-position keywords |
| Recommend Ad Keyword Count | recommendAdKeywordCount | Ad portion of recommendation keywords |
| Recommend Non-ad Keyword Count | recommendNonadKeywordCount | Non-ad portion of recommendation keywords |
| PPC Traffic Sources | ppcTrafficSources | List of paid ad types (SP, Top Brand Ad, Bottom Brand Ad, Video Ad) |
| Natural Search Traffic Sources | naturalSearchTrafficSources | Organic search type markers |
| Amazon Recommendation Sources | amazonRecommendationSources | Recommendation types (Best Seller, AC, ER, TR, TRFOB, etc.) |
| Promotional Deal Sources | promotionalDealSources | Active promotions (Coupon, Limited Time Deal, Lowest Price in 30 Days, etc.) |
13 marketplaces: US (United States), UK (United Kingdom), DE (Germany), CA (Canada), JP (Japan), FR (France), ES (Spain), IT (Italy), MX (Mexico), AU (Australia), AE (United Arab Emirates), BR (Brazil), SA (Saudi Arabia).
Default marketplace is US. Use US when the user does not specify a marketplace. Codes outside this list will be rejected by the API pattern.
POST /sif/asinSummary（完整参数/响应/错误码见 references/api.md）python scripts/sif_asin_summary.py '' [--inline]输出策略（脚本默认行为）：
/linkfox///data/linkfox-sif-asin-summary-.json（ 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录； 取自环境变量 SESSION_ID，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写则报错）total/costToken、最大列表字段的长度 + 前 3 条样本）--inline 强制全量打印到 stdout（同样落盘）读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq或ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。
发生以下异常情况时，采用 references/onboarding.md 引导解决问题：
LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。One or more ASIN codes separated by commas. Maximum 10 ASINs per request.
B0XXXXXXXXB0XXXXXXXX,B0YYYYYYYY,B0ZZZZZZZZMarketplace code. Defaults to US. See the Supported Marketplaces section for all valid codes.
last7d (boolean, default true): Use the latest 7 days. When false, the API uses startDate/endDate to define the window.startDate (string, yyyy-MM-dd): Start date for a custom window. Takes effect when last7d=false; if omitted, the system's latest ABA week is used.endDate (string, yyyy-MM-dd): End date paired with startDate.Comma-separated traffic-channel filters. Only returns ASIN-summary rows that have traffic from at least one of the listed channels. Valid values:
nf — natural searchsp — SP adssb — SB regularsbv — video ads (SBV)ad — any ad trafficacAd — SP recommendationtotalPeriod.in — newly-entered traffic keywords this periodSort field. Leave empty for system default. Valid values:
totalKeywordNum (total keyword count), naturalKeywordNum (natural keyword count), brandKeywordNum (brand ad keyword count), vedioKeywordNum (video ad keyword count), acKeywordNum (AC keyword count), erKeywordNum (ER keyword count), trKeywordNum (TR keyword count), sumScore (all-keyword total exposure), totalNfScore (all natural exposure), totalSpSocre (all SP exposure; note the spelling), totalBrandScore (all brand ad exposure), totalVedioScore (all video ad exposure), totalAcScore (all AC exposure), totalTrScore (all TR exposure), totalErScore (all ER exposure).
pageNum: Page number, defaults to 1pageSize: Results per page, minimum 10, maximum 10000, defaults to 10000desc: Sort in descending order when true (default), ascending when false1. Single ASIN traffic breakdown
"Show me the traffic sources for B09V3KXJPB on the US marketplace"
Query with searchValue = "B09V3KXJPB", country = "US".
2. Multi-ASIN competitor comparison
"Compare traffic structures of B09V3KXJPB and B0BN1K7WJP on Amazon US"
Query with searchValue = "B09V3KXJPB,B0BN1K7WJP", country = "US".
3. Specific marketplace query
"Analyze traffic sources for B07XJ8C8F5 on Amazon Japan"
Query with searchValue = "B07XJ8C8F5", country = "JP".
4. Organic vs paid traffic analysis
"What percentage of B09V3KXJPB's exposure comes from organic search vs ads?"
Query the ASIN, then compare naturalSearchExposureRatio against sponsoredProductsExposureRatio, brandAdExposureRatio, and videoAdExposureRatio.
5. Ad channel deep-dive
"How many keywords does B0BN1K7WJP advertise on through SP, brand ads, and video ads?"
Query the ASIN and present sponsoredProductsKeywordCount, brandAdKeywordCount, topBrandAdKeywordCount, bottomBrandAdKeywordCount, and videoAdKeywordCount.
6. Period-over-period comparison
"How did this ASIN's total keywords change compared to last week?"
Query the ASIN and present totalTrafficKeywordCount (current), totalTrafficKeywordCountPrev (previous), totalTrafficKeywordCountIn (new this period), totalTrafficKeywordCountOut (exited this period). Do the same for the natural-search variant with the naturalSearchKeywordCount* family.
7. Custom date range
"Traffic structure for B0XXX between 2026-03-08 and 2026-03-14"
searchValue: "B0XXX", country: "US", last7d: false, startDate: "2026-03-08", endDate: "2026-03-14"
8. Filter by traffic channel and sort by SP exposure
"Top SP-running ASINs among my 10 products, sorted by SP exposure"
searchValue: "B0A,B0B,...,B0J", conditions: "sp", sortBy: "totalSpSocre", desc: true
*In / *Out / *Prev fields, label the period explicitly (e.g., "vs. previous 7 days"; or the resolved startDate ~ endDate range). Do not present period-over-period deltas without naming the comparison window.msg field and suggest checking the ASIN validity or marketplace selectionisVariantProduct is true, note that the ASIN is a variant and the user may want to also check the parent ASIN for a complete picture.last7d=true). To query a different window, set last7d=false and pass startDate/endDateApplicable -- Traffic source and exposure analysis for Amazon ASINs:
| User Says | Scenario |
|---|---|
| "Where does this ASIN's traffic come from" | Traffic source breakdown |
| "How much organic traffic does this product have" | Natural search exposure analysis |
| "Is this competitor running a lot of ads" | SP/brand/video ad exposure check |
| "Compare traffic structures of these ASINs" | Multi-ASIN competitor comparison |
| "Does this product have Amazon's Choice" | AC/ER/TR recommendation check |
| "What ad channels is this ASIN using" | PPC traffic source identification |
| "How many keywords does this ASIN rank for" | Traffic keyword count analysis |
| "Is this product relying on paid or organic traffic" | Organic vs paid traffic split |
| "How did keywords change vs last week" | Period-over-period comparison (In/Out/Prev) |
| "How many new organic keywords did this ASIN get" | New-in keyword count (naturalSearchKeywordCountIn) |
| "Pull the numbers for a specific date range" | Custom time window via startDate/endDate |
| "Rank 10 ASINs by SP exposure" | sortBy=totalSpSocre across a batch |
Not applicable -- Needs beyond ASIN traffic source data:
消耗 9 积分。
用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。
Feedback:
Auto-detect and report feedback via the Feedback API when any of the following apply:
Call the feedback API as specified in references/api.md. Do not interrupt the user's flow.
For more high-quality, professional cross-border e-commerce skills, set LinkFox Skills.
在给定关键词下拆解所有竞品 ASIN 的流量来源——自然搜索、SP 广告、SB 品牌广告、SBV 视频广告、SP 推荐、AC/ER/TR 等推荐位，支持按 ASIN 过滤、指定日期区间及新进流量词等筛选。当用户提到关键词流量来源、该关键词下哪些竞品在抢流量、自然流量与付费流量占比、SP广告曝光、品牌广告占比、SP推荐位、推荐位广告/非广告拆分、搜索展示分析、Amazon's Choice或编辑推荐曝光、关键词竞争格局、ASIN流量构成、keyword traffic, traffic structure analysis, search share, ad share, traffic source distribution, SIF, traffic analysis, SP recommendation, recommend position breakdown时触发此技能。即使用户未明确提及"SIF"，只要其需求涉及在某关键词下分析竞品 ASIN 的流量来源分布，也应触发此技能。
Reverse-lookup the search keywords driving traffic to any Amazon ASIN, with organic and ad rankings, search volume, and traffic share per keyword.
使用卖家精灵流量词反查能力，按ASIN查询关键词流量来源、流量占比类型、转化类型、自然位与广告位等指标，支持历史月份与多维排序。当用户提到ASIN反查流量词、流量关键词列表、关键词流量结构、自然词/广告词分析、关键词转化类型、SellerSprite traffic keyword、Amazon traffic keywords、reverse ASIN keywords时触发此技能。即使用户未明确提及"卖家精灵"，只要需求是围绕某个ASIN查看其关键词流量来源与词列表，也应触发此技能。
专注对单个亚马逊 ASIN 进行全方位数据驱动的深度拆解，通过四步流水线整合 Keepa、Sorftime 与 SIF 数据，输出涵盖价格、BSR、评论、Deal、流量结构和生命周期等维度的 11 章节 HTML 深度报告。
亚马逊市场关键词竞争度的SIF概览分析。当用户提到关键词竞争度、供需比、竞品数量、关键词搜索量估算、市场竞争力评估、关键词热度排名、广告竞争分析、某个关键词下的商品数量、keyword competition, supply-demand ratio, competitor count, search popularity, market competition analysis, SIF, keyword overview时触发此技能。即使用户未明确说"SIF"，只要其需求涉及评估亚马逊上关键词层面的竞争强度、供需平衡或搜索结果商品数量，也应触发此技能。
西柚找词（西柚洞察）亚马逊 ASIN 与关键词分析，经 LinkFox 网关转发西柚 OpenAPI。覆盖 ASIN 流量得分、反查关键词、词排名/流量趋势、BSR、ABA 周趋势、关键词竞争度与建议竞价等 17 个接口，支持 US/UK/DE 等 13 个站点。当用户提到西柚找词、西柚洞察、Xiyou、ASIN 反查关键词、关键词分析、ABA 周搜索量、流量得分、词排名趋势、xiyou keyword research, ASIN traffic score, reverse ASIN lookup, search term analysis 时触发。即使用户未写「西柚」，只要需求是通过西柚找词查亚马逊 ASIN/关键词流量与排名数据，也应触发。使用前须配置 LINKFOXAGENT_API_KEY 以及环境变量 XIYOU_CLIENT_ID、XIYOU_CLIENT_SECRET。