# 将 西柚洞察 MCP 接入 Open Flow

Source: https://openflow.run/zh-cn/integrations/xydc_mcp/

[全部集成](https://openflow.run/zh-cn/integrations/)

先看清竞品之间的差异，再确定下一步调研重点。

*   [48 个工具](https://openflow.run/zh-cn/integrations/xydc_mcp/#integration-actions)
*   API 密钥
*   数据与分析
*   营销
*   跨境电商

[连接 西柚洞察 MCP](https://console.openflow.run/connections/xydc_mcp)

每月 20,000 次免费应用调用（付费服务另计）

## 可以做什么

比较亚马逊商品资料，跟踪价格、排名变化并研究关键词。确定市场和类目后，还可以进一步开展类目研究。

### 商品比较

比较指定亚马逊市场中的商品资料。

### 准备类目研究

为已确认的市场和类目准备研究资源。

### 研究市场问题

使用可用分析能力调查所选市场。

## 所有工具

48 个工具

### List Tools

在调用工具前，先发现当前 西柚洞察 MCP 工具、行为注解和实时输入模式。

`xydc_mcp.list_tools`

### Call Tool

使用符合实时 schema 的 JSON 参数调用西柚洞察 MCP 工具。调用可能消耗 Credit。generate\_category\_insight\_resource 每次成功调用消耗 500 Credit，命中已有资源也计费；请复用返回的资源，不要盲目重试生成。Connector 对生成调用最多等待 55 秒。超时不代表上游已取消或不会扣费，生成结果可能尚不明确；超时后不要自动重试生成。

`xydc_mcp.call_tool`

### Read Category Insight Guide

类目分析前读取西柚洞察官方工作流指南，了解站点和类目确认、资源生成与复用、周期、分页和额度规则。

`xydc_mcp.read_category_insight_guide`

### Generate Category Insight Resource

为用户已确认的站点和类目生成洞察资源，内部最长等待 5 分钟并自动重建失败资源。每次独立成功调用 500 Credits，命中已有资源也收费。同一任务后续查询应复用 resourceId，避免重复调用生成工具。 首次类目洞察任务先读取 xydc\_mcp.read\_category\_insight\_guide。Connector 对生成调用最多等待 55 秒。超时不代表上游已取消或不会扣费，生成结果可能尚不明确；超时后不要自动重试生成。

`xydc_mcp.generate_category_insight_resource`

### Get Asin Ad Change Trends

查询单个 ASIN 的广告投放变化日趋势，返回每天新观测到的广告活动。 Use when: 用户要查看竞品在指定时间段内新增了哪些广告活动。 用户要分析竞品新增广告活动的时间和变化趋势。 Avoid when: 用户要判断广告活动是否停止、减少、删除或仍在运行；本工具不提供这些状态。 用户要查询广告流量涨跌或自然、广告流量走势时，使用 get\_asin\_traffic\_trends。 用户要查询商品基础信息时，使用 get\_asin\_info。 用户要查询关键词排名时，使用 get\_asin\_keywords。 查询范围越长，消耗越高。 Returns: 每日新观测到的广告活动及相关变化明细。本工具只能识别新增广告活动， 不提供广告活动停止、减少、删除或当前运行状态；未返回停止或移除记录，不能证明既有广告活动仍在运行。

`xydc_mcp.get_asin_ad_change_trends`

### Get Asin Bsr Trends

查询单个 ASIN 的 BSR 类目排名日趋势。 Use when: 用户要看商品在各类目下的 BSR 排名走势，判断销量排名改善、下滑或新品爬升节奏。 Avoid when: 用户要关键词排名或词源流量时，使用 get\_asin\_keywords； 要月度关键词历史时，使用 get\_asin\_keywords\_monthly。该接口只支持 US/CA/MX/BR/UK/DE/FR/ES/IT/JP。 Returns: 每日各类目 BSR 排名趋势。

`xydc_mcp.get_asin_bsr_trends`

### Get Asin Info

获取一个或多个 ASIN 的商品基础信息，包括标题、价格、星级评分、评分数、主图和 Amazon 链接。 Use when: 用户要查看商品详情、补全商品基础字段、对比价格/星级评分/评分数，或基于一批 ASIN 批量补商品信息。 单个 ASIN 和多个 ASIN 都适用；多个 ASIN 优先合并调用，单次最多 100 个，超过时分批查询。 Avoid when: 用户要近期或最近 30 天订单量时，使用 get\_asin\_orders\_last\_30\_days； 要指定月份的历史订单量或月度趋势时，使用 get\_asin\_order\_trends； 要看流量强弱时，使用 get\_asin\_traffic；要看关键词来源和排名时，使用 get\_asin\_keywords。 Returns: 每个 ASIN 的标题、价格、货币、星级评分（stars）、评分数（ratings）、Amazon 链接和主图 URL 等商品信息。

`xydc_mcp.get_asin_info`

### Get Asin Info Change Trends

查询单个 ASIN 的商品标题和主图变动日趋势，返回变动前后的内容。 Use when: 用户要复盘竞品在一段日期内是否修改标题或主图，分析 Listing 内容调整时间，或把内容变更与流量、排名、销量变化结合判断。 Avoid when: 用户要看价格、星级评分、评分数、优惠券或促销变化时，使用 get\_asin\_info\_trends； 用户要看新增广告活动时，使用 get\_asin\_ad\_change\_trends； 用户只要当前商品信息时，使用 get\_asin\_info。 Returns: 每个变动日期的标题和主图信息，分别给出 current 与 previous，便于直接比较变动前后内容。

`xydc_mcp.get_asin_info_change_trends`

### Get Asin Info Trends

查询单个 ASIN 的商品信息日趋势，包括评分数、星级评分、各类价格及优惠信息。 Use when: 用户要复盘某段日期内评分数、星级评分、展示价、原价、划线价、Deal 价、Prime 价，以及优惠券、促销或订阅优惠的变化。 Avoid when: 用户只要当前标题、主图、价格等商品基础信息时，使用 get\_asin\_info； 用户要复盘标题或主图变更时，使用 get\_asin\_info\_change\_trends。 查询范围越长，消耗越高。 Returns: 每日商品信息，包括评分数（ratings）、星级评分（stars）、展示价、原价、划线价、Deal 价、Prime 价，以及优惠券、促销、订阅优惠和其他优惠信息。

`xydc_mcp.get_asin_info_trends`

### Get Asin Keyword Count Trends

关键词数量趋势：查询一个或多个 ASIN 的反查关键词数量日趋势，用于观察关键词覆盖规模及其结构每天的变化。 Use when: 用户要查看一段日期内 ASIN 的反查关键词数量是增加还是减少； 用户要比较自然关键词数量、广告关键词数量，或观察头部词、中长尾词及不同自然流量获得率档位的数量变化； 用户关注的是关键词规模和数量结构，而不是具体关键词明细或实际流量涨跌。 Avoid when: 用户要查看具体有哪些关键词时，使用对应的 ASIN 反查关键词工具； 用户要按周或按月查看关键词数量趋势时，不使用本工具； 用户要分析自然流量、广告流量或总流量的实际涨跌时，使用对应的流量趋势工具； 不要用关键词数量增长直接推断流量增长。 Returns: 每个 ASIN 在所选日期范围内每天的关键词数量，包括自然/广告关键词数量、各排名位置的关键词数量、头部/中长尾关键词数量，以及不同自然流量获得率档位的关键词数量。

`xydc_mcp.get_asin_keyword_count_trends`

### Get Asin Keyword Rank Hourly

查询单个 ASIN 在指定关键词下某一天的小时级排名变化。 Use when: 用户要精细排查 US/UK/DE 站点某个 ASIN + 关键词在单日内的小时级排名波动。 Avoid when: 用户要多日趋势时，使用 get\_asin\_keyword\_rank\_trends；非 US/UK/DE 站点不适用。 Returns: 指定 ASIN 和关键词组合在单日内的小时级排名变化。

`xydc_mcp.get_asin_keyword_rank_hourly`

### Get Asin Keyword Rank Trends

查询单个 ASIN 在指定关键词下的日排名趋势。 Use when: 用户要看某个 ASIN 在某个关键词下自然位、广告位或推荐位的每日排名变化。 Avoid when: 用户要单日小时级排名波动时，使用 get\_asin\_keyword\_rank\_hourly；要流量变化时，使用 get\_asin\_keyword\_traffic\_trends。 Returns: 指定 ASIN 和关键词组合的每日位置维度排名趋势。

`xydc_mcp.get_asin_keyword_rank_trends`

### Get Asin Keyword Traffic Trends

查询单个 ASIN 在指定关键词下的日流量趋势。 Use when: 用户要看某个 ASIN + 关键词组合在一段日期内的流量贡献、自然/广告流量变化或位置带来的流量变化。 Avoid when: 用户要 ASIN 整体流量时，使用 get\_asin\_traffic\_trends；要关键词整体竞争格局时，使用 get\_keyword\_asin\_analysis。 Returns: 指定 ASIN 和关键词组合的每日位置维度流量趋势。

`xydc_mcp.get_asin_keyword_traffic_trends`

### Get Asin Keywords

查询单个 ASIN 近 7 天在哪些关键词下有排名和流量，即 ASIN 反查关键词。 Use when: 用户想分析某个竞品的关键词布局、流量来源、自然/广告排名，或从一个 ASIN 拓展关键词机会。 Avoid when: 用户要看关键词下有哪些 ASIN 竞争时，使用 get\_keyword\_asin\_analysis； 用户要指定日期范围查询日级历史时，使用 get\_asin\_keywords\_daily； 用户要看月度历史时，使用 get\_asin\_keywords\_monthly。 Returns: 关键词列表，每个词包含：关键词名称、自然/广告排名位置、流量、 流量获得率、流量增长率等。可用于发现竞品的流量关键词。

`xydc_mcp.get_asin_keywords`

### Get Asin Keywords Daily

按日期范围查询单个 ASIN 在哪些关键词下有排名和流量，即 ASIN 反查关键词日级历史。 Use when: 用户要查看某个 ASIN 在指定日期范围内的关键词来源、自然/广告排名、流量变化，或要复盘短期关键词布局变化。 需要用户提供或可从上下文推断 start\_date 和 end\_date，否则先追问日期范围。 Avoid when: 用户只要近 7 天快照时，使用 get\_asin\_keywords； 用户要看月度历史或长期变化时，使用 get\_asin\_keywords\_monthly； 用户要看关键词下有哪些 ASIN 竞争时，使用 get\_keyword\_asin\_analysis。 日级查询范围越长，消耗和响应时间越高；单次最多查询 30 天。 Returns: 日级关键词列表，包含关键词、排名位置、自然/广告/总流量、流量获得率和增长率等原始接口结果。

`xydc_mcp.get_asin_keywords_daily`

### Get Asin Keywords Monthly

按月份查询单个 ASIN 在哪些关键词下有排名和流量，即 ASIN 反查关键词月度历史。 Use when: 用户要看竞品关键词布局的月度变化、历史词源结构、某几个月关键词流量和排名变化。 Avoid when: 用户只要近 7 天快照时，使用 get\_asin\_keywords； 用户要看指定日期范围的短期日级历史时，使用 get\_asin\_keywords\_daily； 月份范围和分页越大，消耗越高。 Returns: 月度关键词列表，包含关键词、排名位置、自然/广告/总流量等原始接口结果。

`xydc_mcp.get_asin_keywords_monthly`

### Get Asin Order Trends

查询单个 ASIN 的月订单量趋势，返回指定月份范围内每月的 orders。 Use when: 用户明确要指定月份的订单量、月度销量趋势、历史销售规模或按月份复盘订单量增长节奏。 Avoid when: 用户要近期或最近 30 天订单量，或要批量比较多个 ASIN 的近期订单量时，使用 get\_asin\_orders\_last\_30\_days； 用户要商品标题、价格、星级评分等基础信息时，使用 get\_asin\_info； 要日级流量、BSR 或关键词排名时，使用对应趋势工具。 Returns: 指定月份范围内每个月的订单量（orders）。

`xydc_mcp.get_asin_order_trends`

### Get Asin Orders Last 30 Days

查询一个或多个 ASIN 的近期订单量，数据口径为最近 30 天。 Use when: 用户提到近期订单量、近期销量，想快速判断商品近期销量规模， 或要批量比较多个 ASIN 的近期订单量、为竞品分析补充当前订单量数据。 如果用户已经提供多个 ASIN，优先放在同一次 asins 列表中调用，减少重复请求。 Avoid when: 用户要看按月的历史订单量和销量趋势时，使用 get\_asin\_order\_trends； 用户要看商品标题、价格、评分等基础信息时，使用 get\_asin\_info。 Returns: 每个 ASIN 的近期订单量 orders（统计口径为最近 30 天），以及本次查询的站点国家码。

`xydc_mcp.get_asin_orders_last_30_days`

### Get Asin Traffic

查询一个或多个 ASIN 近 7 天流量得分，包含自然流量、广告流量和环比变化。 Use when: 用户想快速判断商品流量强弱、自然/广告流量占比、近 7 天流量变化，或对一批 ASIN 做流量体检。 如果用户已经提供多个 ASIN，优先放在同一次 asins 列表中调用，减少重复请求。 Avoid when: 用户要看流量来自哪些关键词、自然/广告排名词或词源结构时，使用 get\_asin\_keywords； 要看长周期日趋势时，使用 get\_asin\_traffic\_trends；要看月订单量时，使用 get\_asin\_order\_trends。 Returns: 每个 ASIN 的流量得分详情：自然流量得分、广告流量得分、总得分、关键词数量、 环比增长率、自然/广告流量占比等。

`xydc_mcp.get_asin_traffic`

### Get Asin Traffic Trends

查询单个 ASIN 的日流量得分趋势，包括自然流量、广告流量和位置维度拆解。 Use when: 用户要看某个商品在一段时间内的流量走势、自然/广告流量变化、排名位置贡献或流量复盘。 Avoid when: 用户只要近 7 天流量快照时，使用 get\_asin\_traffic；查询范围越长，消耗越高。 Returns: 每日自然流量得分、广告流量得分、总流量得分和位置维度拆解。

`xydc_mcp.get_asin_traffic_trends`

### Get Asin Traffic Trends Monthly

按月查询单个 ASIN 的流量得分趋势，包括自然流量、广告流量和位置维度拆解。 Use when: 用户要观察商品的长期流量走势、季节性、淡旺季变化， 或比较多个自然月的自然/广告流量结构和增长节奏。 Avoid when: 用户要看日级变化时，使用 get\_asin\_traffic\_trends； 用户要看周级变化时，使用 get\_asin\_traffic\_trends\_weekly； 用户只要近 7 天流量快照时，使用 get\_asin\_traffic。 Returns: 每月的自然流量得分、广告流量得分，以及各展示位置的流量得分拆解。

`xydc_mcp.get_asin_traffic_trends_monthly`

### Get Asin Traffic Trends Weekly

按自然周查询单个 ASIN 的流量得分趋势，每周为周一至周日，包括自然流量、广告流量和位置维度拆解。 Use when: 用户要按周观察商品流量走势、过滤日级波动、比较连续多周的自然/广告流量变化，或复盘中期流量增长和下滑。 需要用户提供或可从上下文推断 start\_week 和 end\_week，否则先追问周区间。 输入日期可以是目标周内任意一天，查询范围会扩展为开始日期所在周的周一至结束日期所在周的周日。 Avoid when: 用户要看日级流量变化时，使用 get\_asin\_traffic\_trends； 用户要看更长周期的月度趋势时，使用 get\_asin\_traffic\_trends\_monthly； 用户只要近 7 天流量快照时，使用 get\_asin\_traffic。 Returns: 每周的日期范围、自然流量得分、广告流量得分，以及各展示位置的流量得分拆解。

`xydc_mcp.get_asin_traffic_trends_weekly`

### Get Asin Variations

查询单个 ASIN 的变体关系，包括父体 ASIN、子体 ASIN 列表及各子体的变体属性。 Use when: 用户要确认父子变体结构、找到同组子 ASIN、合并分析变体矩阵，或判断某个 ASIN 属于哪个变体组。 Avoid when: 用户要商品基础信息时，使用 get\_asin\_info；要流量时，使用 get\_asin\_traffic； 要近期或最近 30 天订单量时，使用 get\_asin\_orders\_last\_30\_days； 要指定月份的历史订单量或月度趋势时，使用 get\_asin\_order\_trends； 要关键词来源时，使用 get\_asin\_keywords。 AE/AU/SA 通过实时商品页解析，其余已支持站点继续使用现有数据源。 Returns: 父体 ASIN、子体 ASIN 列表、变体维度及每个子体对应的 dimension/value 属性。

`xydc_mcp.get_asin_variations`

### Get Category Brand Market Size

获取类目品牌市场规模列表及完整趋势，支持月度或近 30 天、价格带、榜单类型、排序和分页。只传 startDate 时按月度查询；period=last30days 时 cycle 只能省略或 daily。每返回 5 个品牌收 5 Credits。rankingType=newRelease 在此接口等同于销量降序，不筛选新品品牌。指定 rankingType 时排序按该榜单规则。 首次类目洞察任务先读取 xydc\_mcp.read\_category\_insight\_guide。

`xydc_mcp.get_category_brand_market_size`

### Get Category Brand Sales Trends

获取请求 brands 的完整历史月度销售趋势及已有近 30 天汇总，不接受起止月份筛选。费用为 ceil((最大历史月份数+1)/6) × 请求品牌数 × 2 Credits，近 30 天折算 1 个月。 首次类目洞察任务先读取 xydc\_mcp.read\_category\_insight\_guide。

`xydc_mcp.get_category_brand_sales_trends`

### Get Category Keyword Analysis

获取所选自然月、所选相关度的类目关键词分析，完整返回该月 summary、distribution 及全部历史趋势。省略 cycleFilter 或 startDate 时读取站点关键词最新可用月份，显式月份不能晚于该月份；仅支持 monthly，不支持年度、日度或滚动周期。必须指定 correlationType。每次固定 5 Credits，附带趋势不额外收费。 首次类目洞察任务先读取 xydc\_mcp.read\_category\_insight\_guide。

`xydc_mcp.get_category_keyword_analysis`

### Get Category Keywords

获取所选自然月的类目关键词列表。省略 cycleFilter 或 startDate 时读取站点关键词最新可用月份，显式月份不能晚于该月份；仅支持 monthly，不支持年度、日度或滚动周期。支持新版相关度、品牌、区间、搜索和分页。默认附带完整历史趋势，includeTrend=false 可关闭列表趋势。每返回 20 个关键词收 1 Credit。 首次类目洞察任务先读取 xydc\_mcp.read\_category\_insight\_guide。

`xydc_mcp.get_category_keywords`

### Get Category Market Size Trends

获取类目全部价格带的完整历史月度销售趋势及已有近 30 天汇总，不接受起止月份筛选。每 6 个月收 5 Credits，近 30 天不额外计费。 首次类目洞察任务先读取 xydc\_mcp.read\_category\_insight\_guide。

`xydc_mcp.get_category_market_size_trends`

### Get Category New Release Opportunity Trends

获取新版完整新品机会分析，包含 summary、list、完整 trends 和 periods。每 6 个月趋势收 5 Credits，附带列表和周期不另外收费。 首次类目洞察任务先读取 xydc\_mcp.read\_category\_insight\_guide。

`xydc_mcp.get_category_new_release_opportunity_trends`

### Get Category New Release Ranking

获取类目新品榜，reportPeriod 必填：YYYY-MM 查询完整自然月，YYYY 查询完整自然年，last30days / last12months 查询滚动周期。没有默认上架天数限制；省略 rangeFilters.streetDays 时保留全部活跃候选，不保证都是新品。按用户目标显式设置上架天数区间。每返回 5 个代表 ASIN 收 5 Credits。 首次类目洞察任务先读取 xydc\_mcp.read\_category\_insight\_guide。

`xydc_mcp.get_category_new_release_ranking`

### Get Category Price Segment Trends

一次获取低、中、高三个价格带的完整分析及趋势，包括所选周期价格范围、品牌、代表 ASIN、评分及细分价格区间。历史趋势没有逐月价格边界。三个价格带合计每 6 个不同月份收 5 Credits。 首次类目洞察任务先读取 xydc\_mcp.read\_category\_insight\_guide。

`xydc_mcp.get_category_price_segment_trends`

### Get Category Primary Asins

获取类目或指定价格带内的代表 ASIN 列表及完整趋势，支持新版榜单类型、排序和分页。近 12 个月（period=last12months）仅支持全部价格带，priceType 必须省略或传 allPrice。每返回 5 个代表 ASIN 收 5 Credits。指定 rankingType 时排序按该榜单规则。 首次类目洞察任务先读取 xydc\_mcp.read\_category\_insight\_guide。

`xydc_mcp.get_category_primary_asins`

### Get Category Review Analysis

获取月度或近 30 天的合并星级和评价数量分析，完整返回 distribution、ratingsTrends 和 starsTrends。每次成功调用总计 5 Credits。 首次类目洞察任务先读取 xydc\_mcp.read\_category\_insight\_guide。

`xydc_mcp.get_category_review_analysis`

### Get Category Sales Ranking

获取类目销量榜，reportPeriod 必填：YYYY-MM 查询完整自然月，YYYY 查询完整自然年，last30days / last12months 查询滚动周期，支持新版品牌、区间、排序和分页；榜单按 primaryAsin 聚合。每返回 5 个代表 ASIN 收 5 Credits，不足一档向上取整。 首次类目洞察任务先读取 xydc\_mcp.read\_category\_insight\_guide。

`xydc_mcp.get_category_sales_ranking`

### Get Category Seasonality

判断类目季节性并按需分析影响。返回 isSeasonal、旺淡季、销售对比及预测；非季节性或无法判断均为 false 和空分析，调用异常返回错误。每次成功调用固定 5 Credits。 首次类目洞察任务先读取 xydc\_mcp.read\_category\_insight\_guide。

`xydc_mcp.get_category_seasonality`

### Get Category Surging Ranking

获取类目飙升榜，reportPeriod 必填：YYYY-MM 查询完整自然月，YYYY 查询完整自然年，last30days / last12months 查询滚动周期，使用新版增长、筛选和排序规则。每返回 5 个代表 ASIN 收 5 Credits。 首次类目洞察任务先读取 xydc\_mcp.read\_category\_insight\_guide。

`xydc_mcp.get_category_surging_ranking`

### Get Keyword Aba Trends

查询一个或多个关键词的 ABA 搜索量周趋势。每周为周日至周六，单次最多查询 52 个自然周。 Use when: 用户要看关键词搜索量长期走势、季节性波动、ABA 排名变化，或判断某个品类/关键词是上升还是衰退。 单个关键词和多个关键词都适用；多个关键词优先合并调用，单次最多 100 个，超过时分批查询。 需要用户提供或可从上下文推断 start\_week 和 end\_week，否则先追问周区间。 输入日期可以是目标周内任意一天，查询范围会扩展为开始日期所在周的周日至结束日期所在周的周六。 用户请求超过 52 周时，按不重叠的完整周区间分批查询并合并结果，不要截断为最近 52 周。 Avoid when: 用户只要最近一周关键词基础指标时，使用 get\_keyword\_info； 用户没有给出且无法推断周区间时，不要直接调用，应先追问。 Returns: 每个关键词每周的数据：周搜索量、ABA 排名、Top3 ASIN 及点击/转化份额。 可用于绘制趋势图和判断市场走向。

`xydc_mcp.get_keyword_aba_trends`

### Get Keyword Advertising Replay

广告放映机：查询美国、英国、德国站点的指定关键词在指定一天内各小时的广告位结果，最多返回 24 个小时，用于观察该关键词的广告位竞争和投放节奏。 Use when: 用户明确要使用广告放映机； 用户要查看某个关键词在一天内不同小时出现了哪些广告 ASIN、位于什么广告位置和页码； 用户要观察竞品在该关键词下的分时投放节奏，或排查某些时段的广告位竞争情况。 Avoid when: 用户查询的不是美国、英国或德国站点时，不使用本工具； 用户要看多日或长期广告趋势时，不要把多个单日结果解释成完整投放周期； 用户要判断广告活动是否持续运行、停止或被删除时，不使用本工具； 用户要查询某个 ASIN 在该关键词下的广告流量趋势时，使用 get\_asin\_keyword\_traffic\_trends； 用户要查询某个 ASIN 整体的广告流量趋势时，使用 get\_asin\_traffic\_trends； 用户要查询关键词建议竞价时，使用 get\_keyword\_info。 本工具不提供实际广告花费、实际出价或广告转化绩效；关键词建议竞价不能作为实际出价或实际广告成本。 Returns: 指定关键词在目标日期内最多 24 个小时的广告位快照，包括广告位置、小时、页码、ASIN，以及可获取的广告类型、广告活动 ID/名称和广告 ID/名称。 结果只代表该日已观测到的广告位，不代表广告活动的完整投放周期或当前运行状态。

`xydc_mcp.get_keyword_advertising_replay`

### Get Keyword Analysis Monthly

按月份查询单个关键词下的 ASIN 竞争格局历史。 Use when: 用户要看关键词市场格局的月度变化、头部 ASIN 份额变化、历史竞争状态或按月份复盘关键词。 Avoid when: 用户只要近 7 天竞争快照时，使用 get\_keyword\_asin\_analysis； 如果用户没有提供或无法推断月份范围，应先追问 start\_month 和 end\_month。 Returns: 月度 ASIN 竞争列表，包含商品信息、排名位置、自然/广告/总流量等原始接口结果。

`xydc_mcp.get_keyword_analysis_monthly`

### Get Keyword Asin Analysis

查询单个关键词近 7 天下有哪些 ASIN 在竞争流量，即关键词反查 ASIN。 Use when: 用户要分析某个关键词的竞争格局、头部 ASIN、进入难度、自然/广告排名和流量份额。 Avoid when: 用户要看某个 ASIN 吃了哪些关键词时，使用 get\_asin\_keywords；要看月度历史竞争格局时，使用 get\_keyword\_analysis\_monthly。 Returns: ASIN 列表，每个 ASIN 包含：商品信息（标题/价格/评分）、排名位置（自然/广告/推荐）、 流量数据（自然/广告/总流量及占比和增长率）。

`xydc_mcp.get_keyword_asin_analysis`

### Get Keyword Info

查询一个或多个关键词最近一周的基础市场指标，包括搜索量、ABA 排名、竞争难度和建议竞价。 Use when: 用户要判断关键词市场容量、搜索热度、竞争程度、广告成本、点击转化率，或批量补关键词基础指标。 单个关键词和多个关键词都适用；如果用户已经提供多个关键词，优先合并到同一次 keywords 列表中调用。 Avoid when: 用户要看关键词下有哪些 ASIN 竞争时，使用 get\_keyword\_asin\_analysis；要看长期周趋势时，使用 get\_keyword\_aba\_trends。 Returns: 每个关键词的：周搜索量(weeklySearchVolume)、ABA 排名(searchFrequencyRank)、 竞争难度(competitiveDifficulty)、建议竞价(costPerClick)、 点击转化率、自然滚动率、Top3 ASIN 及点击/转化份额。

`xydc_mcp.get_keyword_info`

### Get Multi Asin Keyword Comparison

查询多个 ASIN 最新近 7 天的关键词列表并进行横向对比，用于构建词库或分析多个 ASIN 当前的关键词覆盖、排名和流量差异。 Use when: 用户要基于多个 ASIN 构建当前词库； 用户明确要求进行多 ASIN 关键词对比，判断各 ASIN 最近覆盖了哪些词，以及它们在相同关键词下的排名和流量表现。 Avoid when: 用户只分析单个 ASIN 的关键词时，使用 get\_asin\_keywords； 用户明确要从父体维度分析同一父体下的全部子体时，使用 get\_parent\_asin\_keywords； 用户要查询指定月份或月度历史时，使用 get\_multi\_asin\_keyword\_comparison\_monthly； 本工具固定返回最新近 7 天快照，不能查询指定日期的历史关键词列表； 不要把多个彼此独立的单 ASIN 查询自动合并为对比分析，只有构建词库或用户明确要求对比时才使用。 Returns: 多 ASIN 最新近 7 天关键词列表。每个关键词包含覆盖的 ASIN 数量、各 ASIN 的自然/广告排名、自然/广告/总流量，以及用于横向对比的汇总流量信息。

`xydc_mcp.get_multi_asin_keyword_comparison`

### Get Multi Asin Keyword Comparison Monthly

查询多个 ASIN 的月度关键词列表并进行横向对比，用于构建词库或分析多个 ASIN 的关键词覆盖、排名和流量差异。 Use when: 用户要基于多个 ASIN 构建词库； 用户明确要求进行多 ASIN 关键词对比，判断各 ASIN 覆盖了哪些词，以及它们在相同关键词下的排名和流量表现。 Avoid when: 用户只分析单个 ASIN 的月度关键词时，使用 get\_asin\_keywords\_monthly； 用户明确要从父体维度做月度分析时，使用 get\_parent\_asin\_keywords\_monthly； 用户只要最新近 7 天的多 ASIN 关键词对比时，使用 get\_multi\_asin\_keyword\_comparison； 不要把多个彼此独立的单 ASIN 查询自动合并为对比分析，只有构建词库或用户明确要求对比时才使用。 Returns: 多 ASIN 月度关键词列表。每个关键词包含覆盖的 ASIN 数量、各 ASIN 的自然/广告排名、自然/广告/总流量，以及用于横向对比的汇总流量信息。

`xydc_mcp.get_multi_asin_keyword_comparison_monthly`

### Get Parent Asin Keywords

查询一个父体下全部子体最新近 7 天的关键词列表。调用时输入一个子体 ASIN，工具会自动识别其父体，并查询同一父体下的全部子体。 Use when: 用户明确要做父体分析，查看一个父体下全部子体最近覆盖了哪些关键词，以及不同子体在这些关键词下的排名和流量表现。 Avoid when: 用户只分析单个 ASIN 的关键词时，使用 get\_asin\_keywords； 用户提供多个 ASIN 构建词库或明确要求多 ASIN 对比时，使用 get\_multi\_asin\_keyword\_comparison； 用户要查询指定月份或月度历史时，使用 get\_parent\_asin\_keywords\_monthly； 本工具固定返回最新近 7 天快照，不能查询指定日期的历史关键词列表； 不要仅因为一个 ASIN 可能存在变体就调用本工具，只有用户明确要做父体分析时才使用。 Returns: 最新近 7 天关键词列表。每个关键词包含覆盖的子体数量、各子体的自然/广告排名、自然/广告/总流量，以及父体维度的汇总流量信息。

`xydc_mcp.get_parent_asin_keywords`

### Get Parent Asin Keywords Monthly

按月份查询一个父体下全部子体的关键词列表。调用时输入一个子体 ASIN，工具会自动识别其父体，并查询同一父体下的全部子体。 Use when: 用户明确要做父体分析，并查看指定月份或一段月份范围内的关键词覆盖、排名和流量表现。 Avoid when: 用户只分析单个 ASIN 的月度关键词时，使用 get\_asin\_keywords\_monthly； 用户提供多个 ASIN 做月度关键词对比时，使用 get\_multi\_asin\_keyword\_comparison\_monthly； 用户只要最新近 7 天的父体关键词快照时，使用 get\_parent\_asin\_keywords； 不要仅因为一个 ASIN 可能存在变体就调用本工具，只有用户明确要做父体分析时才使用。 Returns: 月度关键词列表。每个关键词包含覆盖的子体数量、各子体的自然/广告排名、自然/广告/总流量，以及父体维度的汇总流量信息。

`xydc_mcp.get_parent_asin_keywords_monthly`

### Get Primary Asin Children

获取单个 primaryAsin 的子 ASIN 列表及完整趋势，支持新版周期、价格带和分页。primaryAsin 只能传一个字符串，不支持数组。每返回 20 个子 ASIN 收 5 Credits；不新增此工具专用并发或频率限制。 首次类目洞察任务先读取 xydc\_mcp.read\_category\_insight\_guide。

`xydc_mcp.get_primary_asin_children`

### Report Missing Xiyou Capability

在用户要求时，向西柚洞察提交缺失能力反馈；这会记录产品反馈事件。不要将普通参数错误作为能力缺失上报；提交前脱敏。

`xydc_mcp.report_missing_xiyou_capability`

### Search Market Insight Categories

搜索亚马逊类目，自动识别关键词或 ASIN，返回完整类目路径、代表 ASIN 数量、可用性及已有翻译。免费。搜索后必须让用户确认目标类目，即使只有一个候选。 首次类目洞察任务先读取 xydc\_mcp.read\_category\_insight\_guide。

`xydc_mcp.search_market_insight_categories`

没有符合搜索条件的工具。

## 将 西柚洞察 MCP 接入 Open Flow

[连接 西柚洞察 MCP](https://console.openflow.run/connections/xydc_mcp)

每月 20,000 次免费应用调用（付费服务另计）
