注册

点金tool4seller CLI 配置与授权教程

一、功能概述

点金tool4seller CLI 是一款命令行数据查询工具，无需编程即可使用。安装后，您可以在 Claude Code 客户端、ChatGPT 客户端智能体 Work 或 客户端智能体 Codex、腾讯云 WorkBuddy 客户端等操作型 AI 工具中，直接查询您的点金tool4seller 账户数据，并进行销售、商品、广告、库存和货件等经营分析。

二、功能讲解

操作步骤：

  1. 准备环境

    请先确认您使用的操作型 AI 工具已正常安装并可用。支持的 AI 工具包括但不限于：Claude Code 客户端、ChatGPT 客户端智能体 Work 或 客户端智能体 Codex、腾讯云 WorkBuddy 客户端。

  2. 发送安装指令

    在 AI 工具的对话窗口中，发送以下指令：
    帮我安装 tool4seller CLI：https://www.tool4seller.com/cli-installation-guide.md

  3. 安装 Python 依赖

    点金tool4seller CLI 依赖本机 Python 环境。部分 AI 工具已内置 Python 环境，部分则没有。如果 AI 工具提示缺少 Python，您可以让 AI 协助安装。执行安装命令前，请确认 Python 的下载来源、安装命令和权限提示；安装完成后，AI 将继续执行 CLI 安装。

  4. 完成登录授权

    当 AI 工具提示安装完成后，系统通常会自动打开浏览器，要求您登录授权。请使用您的点金tool4seller 账号和密码 完成登录。目前暂不支持手机验证码和第三方账号登录。

    点金tool4seller CLI 授权账户截图，登录点金tool4seller 账号完成 CLI 授权

  5. 开始查询数据

    登录成功后，您即可通过 AI 工具查询点金tool4seller 数据。您可以先尝试输入：“查询我的店铺列表”。

    点金tool4seller CLI 授权账户截图，在 AI 工具中查询店铺列表的返回结果

  6. 可查询的数据范围

    通过点金tool4seller CLI，您可以查询店铺和商品报表、分析广告数据、库存和货件等信息。

    点金tool4seller CLI 授权账户截图，展示通过 CLI 查询各店铺当日销售情况的返回结果 点金tool4seller CLI 授权账户截图，展示通过 CLI 筛选低 ACOS 且未精准匹配投放的搜索词 点金tool4seller CLI 授权账户截图，在 AI 工具中按可售天数筛选 SKU 并返回建议补货数量

三、使用场景

点金tool4seller CLI 既可以作为标准化的数据连接服务，也可以配合 AI 助手形成自然语言查询和经营分析能力。

点金tool4seller CLI 使用场景与 AI 查询示例
使用场景说明
“帮我复盘最近 7 天店铺经营表现”汇总店铺订单数、销量、销售额、利润、利润率、广告花费、广告销售额、ACOS 和 ROAS，并按店铺对比表现，快速了解近期经营情况。
“这个 SKU / ASIN 当前表现怎么样”按 SKU、ASIN 或父 ASIN 查看订单数、销量、销售额、利润、广告花费、广告订单、广告销售额、ACOS、ROAS 和转化率，用于判断单品表现。
“哪些 SKU 需要立即补货？建议补多少？”先找出已断货的 SKU，并结合可售天数和站点现状给出建议补货量。
“这个 ASIN 的流量和转化怎么样”查看该 ASIN 的曝光量、点击量、点击率、订单数、转化率、广告销售额、花费和 ACOS，分析广告流量质量与转化效率。
“帮我找出需要优化的广告活动 / 搜索词 / 投放目标”按指定时间范围筛选出高花费、高 ACOS、低点击率或低转化的广告活动、搜索词和投放目标，用于定位需要优化的对象。
“帮我跟踪商品评分，重点关注口碑风险商品”查询已开启 Review 跟踪的父 ASIN 评分数据，用于识别评分下滑、低评分商品和需要重点关注的口碑风险商品。

四、工具能力

点金tool4seller CLI 工具覆盖店铺授权状态、用户信息、销售汇总、Listing 库存、库存预警、FBA 入仓、流量转化、利润分析、广告分析、Review 评分跟踪等业务场景。

点金tool4seller CLI 工具能力与数据查询范围
能力描述
查询店铺授权查询当前用户已授权的卖家、站点、SP API 状态、广告 API 状态和店铺启用状态。
查询当前用户信息查询当前用户的默认币种、时区、显示语言和创建时间。
查询销售汇总查询指定日期范围内的销售汇总、每日销售汇总、SKU 销售或每日 SKU 销售，支持订单数、销量和销售额。
查询 Listing / 库存查询单店铺的 Listing 与库存数据，支持按 ASIN、SKU、配送渠道筛选；包含 FBA/MFN 库存相关字段。
查询库存预警查询低库存、冗余库存、长期仓储费、建议移除等库存预警。
查询 FBA 入仓单查询当前授权卖家的 FBA 入仓货件列表，支持分页和按卖家筛选。
查询 FBA 入仓明细查询指定入仓单的商品明细，支持最多 100 个 shipmentId。
查询流量转化查询单店铺在指定日期范围内的销量与流量指标，支持店铺、ASIN、父 ASIN 维度及每日维度。
查询利润分析查询单店铺在指定日期范围内的利润数据，支持店铺、SKU、ASIN、父 ASIN 及每日维度。
查询广告分析查询单店铺在指定日期范围内的广告表现，支持店铺、SKU、ASIN、父 ASIN 维度以及汇总/日报。
查询广告活动查询广告活动表现，支持活动汇总、每日数据、按活动类型/状态/名称筛选。
查询广告投放目标查询关键词投放或 ASIN 投放目标表现，支持 SKU、ASIN、父 ASIN 维度。
查询广告搜索词查询搜索词表现或搜索词带来的购买商品表现，支持搜索词筛选。
查询广告归因购买商品查询广告带来的购买商品表现，支持 SKU、ASIN、父 ASIN 维度。
查询 Review 评分跟踪查询单店铺已开启 Review 跟踪的父 ASIN 评分数据，未开启跟踪或无评分数据的不返回。

五、常见问题

点金tool4seller CLI 和点金tool4seller MCP 有什么区别，是否需要同时配置？

点金tool4seller CLI 和点金tool4seller MCP 不需要同时配置。二者都可以用于查询点金tool4seller 数据，但适用场景不同，您可根据自己的使用方式选择其中一种。

点金tool4seller CLI 更适合安装在您的电脑中，配合 ChatGPT 客户端智能体 Work 或 客户端智能体 Codex、Claude Code 客户端、腾讯云 WorkBuddy 客户端等可调用本地命令的 AI 工具使用，进行数据查询和复杂的经营诊断。

点金tool4seller MCP 适合在 Claude、ChatGPT、Codex 等支持 MCP 的 AI 工具中使用。配置 MCP 服务后，您可以通过自然语言查询和分析点金tool4seller 数据，适合经营分析和数据查询场景。

为什么连接后查不到店铺数据？

请先确认当前登录的点金tool4seller 账号下已经完成店铺授权，并且店铺数据接口状态正常。AI 工具只能查询当前登录账号有权限访问的店铺数据。

员工账号能不能使用点金tool4seller CLI 服务？

员工账号可使用点金tool4seller CLI 服务查看自己店铺的数据，但暂不支持查看主账号分配/授权的店铺数据。若需查看授权店铺数据，请使用对应主账号登录。

点金tool4seller CLI 服务支持手机号验证码登录吗？

暂不支持。目前点金tool4seller CLI 服务仅支持使用账号密码登录。若您平时使用手机号验证码登录，请先前往点金tool4seller 设置登录密码后，再使用账号密码登录 CLI 服务。

⌃