用途:该技能通过 Nexscope 研究代理查询 Mercado Libre 的公开市场情报,仅限公开数据、只读操作;当用户请求该公开市场或专利数据时使用。不要调用卖家后台、店铺授权、收藏写入或账号变更类操作。
主要能力与请求契约:端点为 POST /api/v1/tools/research/damai/call,必填 toolName 及对应操作参数,可选市场、筛选、日期、分页、图片和排序字段。构造请求前须阅读 references/api.md;只发送文档中有的字段,网络访问前拒绝未知字段。本地图片需先运行 scripts/upload_image.py,仅使用 Skill Asset 工作流返回的已确认 publicUrl。
使用方式:先确认请求的公开实体、市场、操作、筛选和预期费用,再按 API 参考校验参数。示例:python scripts/damai_mercado_market_intelligence.py '<JSON参数>' --no-cache,每次只运行一次;付费失败后未经用户批准不得探测其他产品、市场、页面或操作。响应处理要求外层数值 code 等于 0 才可使用数据,非零为平台失败,需显示外层 msg 但不将其措辞当作重试指令;成功时 msg 可能为 null。区分 Nexscope 传输封装与内层业务响应,出错时报告 traceId。只总结返回的事实,缺失值保留为未知。
费用与错误:消耗 Nexscope 积分,首次实际响应前具体扣费未知;保留响应头 X-Cost-Token 与 X-Cost-Credit 作为服务端计费元数据。HTTP 401 表示认证失败,检查 NEXSCOPE_API_KEY 和 NEXSCOPE_PROXY_BASE,不要让用户在聊天或操作 JSON 中粘贴凭据;HTTP 402 表示积分不足,停止流程并访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS;市场授权失败需续期对应平台账号或令牌,不得自动替换店铺、地区或创作者。
认证与呈现:设置 NEXSCOPE_API_KEY 环境变量。结果应优先呈现请求的实体、市场、操作和最具决策相关性的字段,保留源货币、单位、标识符、日期与缺失值,不虚构换算或默认值;保留完整 JSON 工件,重复记录可用紧凑表格。报告服务端 X-Cost-Token、X-Cost-Credit 和 trace ID。
限制与隐私:每次调用一个明确请求,出错后不得静默更改实体、市场、日期、操作或页面。在面向用户的输出和保存的请求示例中隐去凭据、签名 URL、Cookie 和内部账号标识。除非 references/testing.md 有对应证据,否则不得声称已通过实时、ZIP 安装或生产验证。执行实时请求或声明验证级别前须阅读 references/testing.md。