西柚洞察 MCP
使用西柚大词与 AI 比较亚马逊商品价格、评分和类目排名趋势。
比较亚马逊商品资料，跟踪价格、排名变化并研究关键词。确定市场和类目后，还可以进一步开展类目研究。
Agent 能在 西柚洞察 MCP 里做什么
按任务分组，每组列出要调用的操作。
商品比较
比较指定亚马逊市场中的商品资料。
- Get Asin Info
准备类目研究
为已确认的市场和类目准备研究资源。
- Read Category Insight Guide
- Generate Category Insight Resource
研究市场问题
使用可用分析能力调查所选市场。
- List Tools
- Call Tool
可以交给 Agent 的任务
方括号里填你的内容，任务标出的其他应用也要连接。
比较竞品
在同一市场并排比较价格、评分与评价数量。
比较美国站的 [ASIN 列表]，列出当前价格、评分和评价数量，整理主要差异。
准备类目研究
为已确认的市场和类目准备研究资源。
为 [市场] 和 [已确认类目] 准备类目研究资源，我想了解 [问题]；如有已有资源请复用。
研究市场问题
使用可用分析能力调查所选市场。
使用我账户可用的分析能力，研究 [市场和类目] 的 [问题]；缺少必要信息时请告诉我。
操作48
西柚洞察 MCP 连接器提供的全部操作，附名称和 id。
- List Tools
list_tools在调用工具前，先发现当前 西柚洞察 MCP 工具、行为注解和实时输入模式。 - Call Tool
call_tool使用符合实时 schema 的 JSON 参数调用西柚洞察 MCP 工具。调用可能消耗 Credit。generate_category_insight_resource 每次成功调用消耗 500 Credit，命中已有资源也计费；请复用返回的资源，不要盲目重试生成。 Connector 对生成调用最多等待 55 秒。超时不代表上游已取消或不会扣费，生成结果可能尚不明确；超时后不要自动重试生成。 - Read Category Insight Guide
read_category_insight_guide类目分析前读取西柚洞察官方工作流指南，了解站点和类目确认、资源生成与复用、周期、分页和额度规则。 - Generate Category Insight Resource
generate_category_insight_resource为用户已确认的站点和类目生成洞察资源，内部最长等待 5 分钟并自动重建失败资源。每次独立成功调用 500 Credits，命中已有资源也收费。同一任务后续查询应复用 resourceId，避免重复调用生成工具。 首次类目洞察任务先读取 xydc_mcp.read_category_insight_guide。 Connector 对生成调用最多等待 55 秒。超时不代表上游已取消或不会扣费，生成结果可能尚不明确；超时后不要自动重试生成。 - Get Asin Ad Change Trends
get_asin_ad_change_trends查询单个 ASIN 的广告投放变化日趋势，返回每天新观测到的广告活动。 Use when: 用户要查看竞品在指定时间段内新增了哪些广告活动。 用户要分析竞品新增广告活动的时间和变化趋势。 Avoid when: 用户要判断广告活动是否停止、减少、删除或仍在运行；本工具不提供这些状态。 用户要查询广告流量涨跌或自然、广告流量走势时，使用 get_asin_traffic_trends。 用户要查询商品基础信息时，使用 get_asin_info。 用户要查询关键词排名时，使用 get_asin_keywords。 查询范围越长，消耗越高。 Returns: 每日新观测到的广告活动及相关变化明细。本工具只能识别新增广告活动， 不提供广告活动停止、减少、删除或当前运行状态；未返回停止或移除记录，不能证明既有广告活动仍在运行。 - Get Asin Bsr 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排名趋势。 - Get Asin Info
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 等商品信息。 - Get Asin Info Change Trends
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，便于直接比较变动前后内容。 - Get Asin Info 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 价，以及优惠券、促销、订阅优惠和其他优惠信息。 - Get Asin Keyword Count Trends
get_asin_keyword_count_trends关键词数量趋势：查询一个或多个 ASIN 的反查关键词数量日趋势，用于观察关键词覆盖规模及其结构每天的变化。 Use when: 用户要查看一段日期内 ASIN 的反查关键词数量是增加还是减少； 用户要比较自然关键词数量、广告关键词数量，或观察头部词、中长尾词及不同自然流量获得率档位的数量变化； 用户关注的是关键词规模和数量结构，而不是具体关键词明细或实际流量涨跌。 Avoid when: 用户要查看具体有哪些关键词时，使用对应的 ASIN 反查关键词工具； 用户要按周或按月查看关键词数量趋势时，不使用本工具； 用户要分析自然流量、广告流量或总流量的实际涨跌时，使用对应的流量趋势工具； 不要用关键词数量增长直接推断流量增长。 Returns: 每个 ASIN 在所选日期范围内每天的关键词数量，包括自然/广告关键词数量、各排名位置的关键词数量、头部/中长尾关键词数量，以及不同自然流量获得率档位的关键词数量。 - Get Asin Keyword Rank Hourly
get_asin_keyword_rank_hourly查询单个 ASIN 在指定关键词下某一天的小时级排名变化。 Use when: 用户要精细排查 US/UK/DE 站点某个 ASIN + 关键词在单日内的小时级排名波动。 Avoid when: 用户要多日趋势时，使用 get_asin_keyword_rank_trends；非 US/UK/DE 站点不适用。 Returns: 指定ASIN和关键词组合在单日内的小时级排名变化。 - Get Asin Keyword Rank Trends
get_asin_keyword_rank_trends查询单个 ASIN 在指定关键词下的日排名趋势。 Use when: 用户要看某个 ASIN 在某个关键词下自然位、广告位或推荐位的每日排名变化。 Avoid when: 用户要单日小时级排名波动时，使用 get_asin_keyword_rank_hourly；要流量变化时，使用 get_asin_keyword_traffic_trends。 Returns: 指定ASIN和关键词组合的每日位置维度排名趋势。 - Get Asin Keyword Traffic Trends
get_asin_keyword_traffic_trends查询单个 ASIN 在指定关键词下的日流量趋势。 Use when: 用户要看某个 ASIN + 关键词组合在一段日期内的流量贡献、自然/广告流量变化或位置带来的流量变化。 Avoid when: 用户要 ASIN 整体流量时，使用 get_asin_traffic_trends；要关键词整体竞争格局时，使用 get_keyword_asin_analysis。 Returns: 指定ASIN和关键词组合的每日位置维度流量趋势。 - Get Asin Keywords
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: 关键词列表，每个词包含：关键词名称、自然/广告排名位置、流量、 流量获得率、流量增长率等。可用于发现竞品的流量关键词。 - Get Asin Keywords Daily
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: 日级关键词列表，包含关键词、排名位置、自然/广告/总流量、流量获得率和增长率等原始接口结果。 - Get Asin Keywords Monthly
get_asin_keywords_monthly按月份查询单个 ASIN 在哪些关键词下有排名和流量，即 ASIN 反查关键词月度历史。 Use when: 用户要看竞品关键词布局的月度变化、历史词源结构、某几个月关键词流量和排名变化。 Avoid when: 用户只要近 7 天快照时，使用 get_asin_keywords； 用户要看指定日期范围的短期日级历史时，使用 get_asin_keywords_daily； 月份范围和分页越大，消耗越高。 Returns: 月度关键词列表，包含关键词、排名位置、自然/广告/总流量等原始接口结果。 - Get Asin Order Trends
get_asin_order_trends查询单个 ASIN 的月订单量趋势，返回指定月份范围内每月的 orders。 Use when: 用户明确要指定月份的订单量、月度销量趋势、历史销售规模或按月份复盘订单量增长节奏。 Avoid when: 用户要近期或最近 30 天订单量，或要批量比较多个 ASIN 的近期订单量时，使用 get_asin_orders_last_30_days； 用户要商品标题、价格、星级评分等基础信息时，使用 get_asin_info； 要日级流量、BSR 或关键词排名时，使用对应趋势工具。 Returns: 指定月份范围内每个月的订单量（orders）。 - Get Asin Orders Last 30 Days
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 天），以及本次查询的站点国家码。 - Get Asin Traffic
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的流量得分详情：自然流量得分、广告流量得分、总得分、关键词数量、 环比增长率、自然/广告流量占比等。 - Get Asin Traffic Trends
get_asin_traffic_trends查询单个 ASIN 的日流量得分趋势，包括自然流量、广告流量和位置维度拆解。 Use when: 用户要看某个商品在一段时间内的流量走势、自然/广告流量变化、排名位置贡献或流量复盘。 Avoid when: 用户只要近 7 天流量快照时，使用 get_asin_traffic；查询范围越长，消耗越高。 Returns: 每日自然流量得分、广告流量得分、总流量得分和位置维度拆解。
西柚洞察 MCP 怎么登录
- 登录方式
- API Key提供 XYDC MCP Token，不使用 REST API Key。
- 需要准备
- 所选研究工具的 XYDC MCP 权限与额度。
- 说明
- 准备资源前请确认市场和类目。研究会消耗额度，应尽量复用已有资源。