Ozon Performance MCP 服务器：广告活动与报告

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Ozon Performance (Ads)、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Ozon Performance (Ads)

面向卖家广告账户的 Ozon Performance API：按点击付费、按订单付费和横幅广告活动，其商品和出价、竞争出价和出价限制、每日统计和花费统计，以及详细的广告活动报告。可停止广告活动和修改出价。只需一个服务账号的 client ID 和 client secret。

设置

设置大约需要 3 分钟。你需要一个带广告账户（Ozon Performance）的 Ozon 卖家账号，并在其中创建一个服务账号和对应的密钥。

1. 在 Ozon 卖家后台打开 Settings → API keys → Performance API（seller.ozon.ru/app/settings/api-keys?currentTab=performanceApi）。
2. 如果还没有服务账号，用 Create new account 创建一个。点击服务账号的名称，再点击 Add new key。
3. 把 client ID 复制到 OZON_PERFORMANCE_CLIENT_ID：它以 @advertising.performance.ozon.ru 结尾，请完整粘贴。添加密钥时，client secret 会和 client ID 一起显示，把它复制到 OZON_PERFORMANCE_CLIENT_SECRET。如果 secret 丢失了，就添加一个新密钥。
4. 安装连接器，用 ozon_performance_list_campaigns（无需参数）检查连接：它会列出你的广告活动及其 ID，其他所有工具都要用到这些 ID。

与 Ozon Seller 连接器相互独立：此连接器只处理广告账户，使用自己的凭证，这里不使用 Seller API 密钥。订单、商品、库存和价格请使用 Ozon Seller 连接器。

Cloud 和自托管的方式相同：粘贴同样的两个值即可，无需设置 Redirect URL。

令牌自动续期：连接器通过 POST /api/client/token（grant type client_credentials）用 client ID 和 secret 换取有效期 30 分钟的 bearer 令牌，并在过期前或收到 401 后获取新令牌。获取令牌时返回 401，表示 client ID 或 secret 错误，或者密钥已被删除：请重新复制这两个值，或为服务账号添加新密钥。403 表示服务账号无权访问该方法或该广告活动。

广告活动类型：SKU 是按点击付费（Оплата за клик），SEARCH_PROMO 是按订单付费（Оплата за заказ），另外还有 BANNER 和 VIDEO_BANNER。按点击付费广告活动的商品及其出价来自 ozon_performance_list_campaign_products；按订单付费推广中的商品来自 ozon_performance_list_cpo_products。

即时统计：ozon_performance_get_daily_statistics、ozon_performance_get_expense_statistics 和 ozon_performance_get_cpc_campaign_statistics 会立即以 JSON 行返回结果。不指定日期时覆盖最近 7 天。日期按天表示（2026-10-01），Ozon 按莫斯科时间分组。ozon_performance_get_cpc_campaign_statistics 不计入报告限额。

详细报告是异步生成的：ozon_performance_request_campaign_report 为最多 10 个广告活动、最长 62 天的时间段订购按商品统计的报告，可按天、周或月分组，并返回一个 UUID。AI 每隔几秒查询一次 ozon_performance_get_report_status，直到 state 变为 OK（或 ERROR），然后用 ozon_performance_download_report 获取报告：单个广告活动是 CSV 文本（分号分隔，列名为俄语），多个广告活动是一个 ZIP 文件，每个广告活动一个 CSV。每个账户同一时间只能生成一个报告，每天最多 2000 个；ozon_performance_list_api_reports 可以找到之前订购的报告。ozon_performance_request_search_phrases_report 以同样的方式获取置顶推广的搜索词报告，Ozon 将该方法标记为测试中。

金额和 ID：广告活动预算以百万分之一卢布为单位（1000000 = 1 卢布）；ozon_performance_get_bid_limits 返回的出价限制以卢布为单位；按订单付费的出价是商品价格的百分比。ID 是数字字符串。

修改出价：ozon_performance_update_campaign_bids 修改已在按点击付费广告活动中的商品的出价，Ozon 会用发送的内容替换该广告活动的停用词和短语出价。ozon_performance_add_campaign_products 每个广告活动最多添加 500 个商品；采用自动策略的广告活动只能添加其自动驾驶类目中的商品。每次点击出价只在平均点击成本策略下生效，单位与连接器读取到的当前出价相同；不指定时由 Ozon 设置竞争出价。

限流：每个账户每天最多 100,000 次请求，此外对广告活动的修改（例如每个广告活动每天最多 500 次预算或策略修改）和报告也有限制。收到 429 时，请稍后再试。

可读取的内容：广告活动，包括类型、状态、付费方式、展示位置、策略、日期和预算；广告活动推广的 SKU 或横幅；按点击付费广告活动的商品，包括每次点击出价、目标广告费用占比或搜索排名区间；其他卖家对同一 SKU 的出价，以及按推广工具、展示位置和类目划分的最低和最高出价；按订单付费推广中的商品，包括价格、出价、可见度指数和浏览量；按广告活动和日期统计的浏览量、点击量、花费、订单数和订单金额，按预付账户和奖励金拆分的花费，按点击付费广告活动的期间汇总，以及按商品的详细报告和搜索词报告。

安装时默认关闭：ozon_performance_activate_campaign 和 ozon_performance_remove_campaign_products。前者启动广告活动，之后它会展示广告并消耗预算；后者从按点击付费广告活动中移除商品，其出价会丢失。请在连接器页面只开启你需要的工具；AI 在每次更改前都会先征得你的确认。ozon_performance_deactivate_campaign、ozon_performance_add_campaign_products 和 ozon_performance_update_campaign_bids 默认开启：它们停止广告活动、向按点击付费广告活动添加商品并修改其出价，从而改变花费，但总是在 AI 向你准确展示要更改的内容之后才执行。

不包含：创建和复制广告活动、预算和策略、修改按订单付费的出价、横幅和视频统计、订单归因报告以及外部流量分析。

前提条件: OZON_PERFORMANCE_CLIENT_ID, OZON_PERFORMANCE_CLIENT_SECRET

本地安装连接器

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

打开 http://localhost:3000/connectors/store，选择 Ozon Performance (Ads) 并填入前提条件中列出的环境变量。

可用工具

示例提示

• “我的哪些 Ozon 广告活动正在投放？它们的每日预算是多少？”
• “上周每个广告活动每天花了多少钱？其中有多少是用奖励金支付的？”
• “把我的按点击付费广告活动的当前出价和相同 SKU 的竞争出价比较一下。”
• “为我的按点击付费广告活动订购 10 月按商品统计的详细报告，按周分组，并做个总结。”
• “按订单付费推广中，哪些商品的出价占价格的百分比最高？它们本周有多少浏览量？”

下一步

• 连接到 Claude
• 连接到 ChatGPT