LinkFox 美客多选品(LinkFox Mercado Libre Product Selection)是为 Mercado Libre(美客多)选品与市场研究提供统一数据查询能力的技能,当前包含 1 个子能力标识 linkfox-mercado-product-selection、1 个精确 MCP toolName 和 24 个下游 operation。收费状态以返回的 charged/costToken 为准。
【使用前提】 本技能必须依赖 MCP 连接器 LinkFox。若未安装,需先在 WorkBuddy 左侧“专家·技能·连接器” → “连接器”中搜索关键词 LinkFox,安装连接器 LinkFox(注意不是 linkfox-product-selection),按指引完成登录授权,再返回 WorkBuddy 重试。调用只使用 LinkFox.proxy_call,精确 toolName 为 mercado/productSelection;不直连旧网关或上游 XP-MCP。WorkBuddy 自动注入授权上下文,禁止索取或传入 headers、Authorization、API Key、token、JWT、手机号或上游凭证。
【主要能力】
- 商品研究:itemInfo 查询商品基本信息,itemHistory 查询销量历史,itemSearch 按站点、关键词、类目、价格、销量、评分、评论、重量、上架时间、仓储、店铺类型和排序等条件筛选商品。
- 官链/目录研究:catalogInfo、catalogHistory、catalogSearch 查询官链或目录的基本信息、销量历史和筛选结果;官链 ID 与普通商品 itemId 不应混用。
- 关键词研究:keywordDateSearch 获取指定日期热搜词(YYYYMMDD),keywordMonthSearch 获取指定月份热搜词(YYYYMM),keywordReverse 按商品反查流量词。
- 类目定位:免费的 categorySearch 与 categorySmallSearch 按名称解析类目 ID,便于后续调用收费的商品、官链或趋势操作。
- 类目趋势与机会:trendBrandTopBrand、trendBrandTopItem、trendBrandTopSeller 查询品牌/商品/店铺排行,trendNewItems 分析新品机会,trendPrice 查询价格分布,trendSale 查询销量分布,trendSoldHis 查询销售历史,trendStatistical 查询类目汇总统计,trendStoreInventoryType 查询仓储类型分布;这些操作均要求 siteId 与 categoryId。
- 店铺与用户反馈:sellerSearch 按站点、店铺类型、等级和优质卖家等级搜索店铺;免费的 reviewSearch 按 itemId 获取商品评论(不传 siteId)。
- 站点与额度信息:免费的 rateInfo 查询站点货币对美元及人民币折算汇率,免费的 myUsage 查询当前套餐与用量(arguments 固定为空对象)。
【站点说明】 MLM 为墨西哥、MLB 为巴西、MLA 为阿根廷、MLC 为智利;MCO 为哥伦比亚,但只在各操作参考文档明确支持时使用。
【使用方式】 proxy_call.arguments 必须是原下游请求体,即 {"toolName":"<operation>","arguments":{...}},整体放入 proxy_call.arguments;内层 arguments.toolName 才是 24 个 operation 之一,业务字段保留在 arguments.arguments,不得扁平化或再包裹。字段名严格使用参考文档的大小写。返回解析时先检查 MCP 连接、工具、schema 与 isError,再读取 text/structured content,然后检查下游 errcode/errmsg、code/msg,最后读取 data、contentText、total、charged、costToken、costTime。多数 operation 的 data 是格式化文本,不应强行假设为统一数组。
【调用与计费限制】 同一任务内相同 MCP toolName + arguments 只调用一次;收费调用失败、空结果或不理想时,不自动重试、换词、翻页或改参数,需追加调用时先说明潜在消耗并取得用户同意。categorySearch、categorySmallSearch、reviewSearch、rateInfo、myUsage 为免费操作;其他操作当前后端通常每次调用返回 costToken = 16000,即使业务结果为空也可能计费。付费调用前应明确可能产生积分消耗,由用户决定是否继续。付费结果显示网关返回的 charged 和 costToken,不把空结果当作免扣。
【异常处理】 MCP 或 proxy_call 缺失时停止业务调用,提示检查 LinkFox 配置并重载 WorkBuddy,禁止 HTTP fallback;401 按自动授权链路异常处理,提示重新登录或重载连接,不索取 Key,也不当作积分不足;402 为积分或余额不足,引导访问 https://agent.linkfox.com/ 自助处理,不自动查询套餐、下单或支付;403 为权限问题,依据返回信息处理。errcode 1002 时核对内层 operation、业务参数、必填字段、大小写、站点和日期格式;errcode 500 时记录脱敏信息,不自动重试收费调用。
【适用场景】 适合在美客多多站点做商品与竞品调研、官链与目录分析、热搜词与流量词研究、类目趋势与机会判断、店铺与评论分析以及汇率和额度查询。
【不适用范围】 不提供美客多店铺登录、Listing 发布、订单/库存变更、广告投放、物流履约、供应链采购、平台申诉或法律/财务结论;不把数据查询结果包装成确定的销量保证、盈利保证或平台规则结论。旧脚本的本地缓存、自动落盘、会话元数据和 stdout 摘要不属于 MCP 能力,不应声称 MCP 自动提供。