SuperAPI AI 工具集

marketplace

通用与其它

查看项目

更新于 10-16 09:44

技能介绍

用途:这是一个统一市场服务器,把每个已安装连接器挂载为带命名空间的工具集,前缀包括 wb_、ozon_、yandex_、detmir_、avito_、taobao_、megamarket_、lamoda_、dns_、citilink_、aliexpress_、cian_、mpstats_*,另有 compare_prices / compare_sources 以及自身的 marketplace_sources。共暴露 40 个工具:39 个挂载工具加 marketplace_sources。操作者只需接一个 marketplace 条目,而非十四个。

主要能力:回答“哪里最便宜”时 compare_prices 会向所有可搜索来源并发查询;marketplace_sources() 无参数,返回 {mounted, skipped, mounted_count, skipped_count, capabilities, server_version},capabilities 为每个来源的静态路由元数据(访问层级、CDP/登录要求、货币、文本搜索支持、是否已挂载),skipped 把来源名映射到导致其被丢弃的导入错误。连接器为防御性导入,缺依赖只会移除某个市场而不会终止服务器;但客户端里缺失来源与“查了但为空”看起来一样,需调用该工具区分。

使用方式:CLI 有 marketplace-mcp install [client],打印可直接粘贴的 mcpServers JSON;client 必须是 claude、claude-code、cursor 之一。marketplace-mcp doctor [--status-file path] 提供逐来源健康检查加 CDP 会话探测,并可输出机器可读 JSON;退出码:0 全部健康,1 有解析器漂移,2 无漂移但有来源无法判定。可用 MARKETPLACE_SOURCES 环境变量以逗号分隔挂载子集(如 wildberries,ozon,compare),别名 wb、ym/yandex、detmir、ali 也可用;不设或留空则挂载全部,未知名称启动即失败。DeepSeek Harness 默认 profile 只经廉价的 compare 挂载暴露 compare_prices 与 compare_sources;要用各市场工具及 marketplace_sources 需设 RU_MARKETPLACE_MCP_FULL=1 并重启 profile。

适用场景:单一客户端配置、跨源比价、来源可选子集挂载、健康巡检与监控。

限制:mpstats_* 是可选付费来源,未设 MPSTATS_MP_AUTH 时其工具返回 auth_missing,其余不受影响。compare_prices 按日常卢布价格排序,淘宝(CNY)仅在 price_native 报告,不与卢布比较。恢复感知客户端应读取 source_outcomes.requires_user_action 后再重试;挑战不等于空搜索结果,需在浏览器交互完成后于同一 MCP 会话、handoff_expires_at 过期前重复同一操作。CDP 配置与支持来源见 docs/CDP_SETUP.md。