用途:该技能用于查询 Mercado Libre 公开市场情报,适用于用户请求该公开市场或专利数据的场景。使用前需阅读 references/api.md 了解完整参数、响应与错误约定。
主要能力:通过 Nexscope 研究代理发起只读公开数据查询。请求端点为 POST /api/v1/tools/research/damai/call,必填 toolName 及对应操作的参数,可选字段包括已文档化的市场、筛选、日期、分页、图片和排序字段。本地图片输入需先运行 scripts/upload_image.py,仅使用 Skill Asset 流程返回的已确认 publicUrl。只发送文档化字段,网络访问前拒绝未知字段。
使用方式:确认请求的公开实体、市场、操作、筛选与预期成本;按 API 参考校验参数;运行 python scripts/damai_mercado_market_intelligence.py '<JSON 参数>' --no-cache 一次。付费失败后未经用户批准,不得探测其他产品、市场、页面或操作。保留完整响应文件,区分 Nexscope 传输信封与内部业务响应,出错时报告 traceId。仅总结返回事实,缺失值保留为未知。
认证与成本:设置 NEXSCOPE_API_KEY 环境变量。凭据缺失或过期时访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 充值。该操作消耗 Nexscope 积分,首次实时响应前确切费用未知;保留响应头中的 X-Cost-Token 与 X-Cost-Credit 作为服务器报告的计费元数据。HTTP 401 表示认证失败,检查 NEXSCOPE_API_KEY 与 NEXSCOPE_PROXY_BASE,不要让用户在聊天或操作 JSON 中粘贴凭据;HTTP 402 表示账户积分不足,停止流程并引导用户访问上述帮助页。
限制与隐私:该迁移为公开数据、只读操作,不得调用卖家控制台、店铺授权、收藏写入或账户变更操作。每次调用仅一个明确请求,出错后不得静默更改实体、市场、日期、操作或页面。面向用户的输出与保存的请求示例中需隐去凭据、签名 URL、Cookie 和内部账户标识。除非 references/testing.md 中存在对应证据,不得声称实时、ZIP 安装或生产验证。市场授权失败需续期对应平台账户或令牌,不得自动替换店铺、地区或创建者。模糊网络失败需报告操作是读取还是变更,未经核对上游状态不得重复变更操作。