Avito広告 MCP

A1 Avito広告 MCPは、AIアプリケーションをAvito広告の広告アカウントに接続します。キャンペーンと統計の確認、グループの予算と入札単価の管理、代理店の残高・アクセス権・ORD文書の操作を自然言語で行えます。

これはAvitoの出品者向けAPIではありません。このサーバーは商品、メッセージ、注文、出品者の広告掲載のプロモーションを扱いません。Avito広告の広告アカウントにおけるメディアキャンペーンとパフォーマンスキャンペーンのみを扱います。

• 25のツール。 キャンペーン、グループ、クリエイティブ、統計、残高、子アカウント、ユーザー、ORD文書。

• キャンペーンへの限定的な変更。 APIで変更できるのはグループの予算と入札単価のみです。キャンペーン、グループ、クリエイティブの作成、編集、一時停止、削除はできません。

• 取り消し不能な操作は明示されます。 資金やボーナスの送金、ユーザーの削除、技術的なAPIリクエストはdestructiveとしてマークされます。

• APIの週次予算。 各呼び出しでポイントを消費します。残高apiPointBalanceはサーバーが結果とともに返します。

まずはデータを読み取るだけのリクエストから始めましょう。

私のAvitoアカウントのキャンペーンと、先週の広告グループ別の費用を表示してください。

サーバーを接続する · シナリオを見る · 技術ドキュメントを開く

1分で動作を確認する

あなた: 私のAvitoアカウントのキャンペーンと、先週の広告グループ別の費用を表示してください。

アシスタント: キャンペーン、グループ、費用、クリック数、インプレッション数を表示します。何も変更されません。

あなた: グループ101の入札単価を350ルーブルに変更する準備をしてください。

アシスタント: アカウント、グループ、現在の入札単価と新しい入札単価を表示し、確認を求めます。

あなた: 確認します。

アシスタント: このグループの入札単価のみを変更します。キャンペーン、クリエイティブ、その他のグループは変更されません。

Related MCP server: VK Ads MCP

目次

• はじめに

• 任せられること

• 変更される可能性があるもの

• アクセスの取得

• 設定

• データ、制限、バックグラウンドでの動作

• 技術ドキュメント

• サポート

はじめに

Node.js 20以上、Client Key、Client Secret、Avito広告の広告アカウントIDが必要です。アクセス権の発行にはアカウントの管理者ロールが必要です。

1. アクセスを取得します。

2. AIアプリケーションにサーバーを追加します。

3. 上記の安全な最初のリクエストを送信します。

Settings → Plugins → MCP serversでAdd serverをクリックし、AVITO_ADS_CLIENT_ID、AVITO_ADS_CLIENT_SECRET、AVITO_ADS_ACCOUNT_IDを指定してnpx -y mcp-avito-ads@latestを追加します。

codex mcp add avito-ads \
  --env AVITO_ADS_CLIENT_ID=your_client_key \
  --env AVITO_ADS_CLIENT_SECRET=your_client_secret \
  --env AVITO_ADS_ACCOUNT_ID=your_account_id \
  -- npx -y mcp-avito-ads@latest
codex mcp list

Codex MCPドキュメント

claude mcp add \
  --env AVITO_ADS_CLIENT_ID=your_client_key \
  --env AVITO_ADS_CLIENT_SECRET=your_client_secret \
  --env AVITO_ADS_ACCOUNT_ID=your_account_id \
  --transport stdio --scope user avito-ads \
  -- npx -y mcp-avito-ads@latest
claude mcp list

Claude Code MCPドキュメント

Settings → Developer → Edit Configを開き、以下を追加します。

{"mcpServers":{"avito-ads":{"command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"your_client_key","AVITO_ADS_CLIENT_SECRET":"your_client_secret","AVITO_ADS_ACCOUNT_ID":"your_account_id"}}}}

Edit Configが利用できない場合は、macOSでは~/Library/Application Support/Claude/claude_desktop_config.json、Windowsでは%APPDATA%\Claude\claude_desktop_config.jsonを編集します。Claude Desktop MCPドキュメント

macOS/Linuxでは~/.cursor/mcp.json、Windowsでは%USERPROFILE%\.cursor\mcp.jsonに{"mcpServers":{"avito-ads":{"type":"stdio","command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"your_client_key","AVITO_ADS_CLIENT_SECRET":"your_client_secret","AVITO_ADS_ACCOUNT_ID":"your_account_id"}}}}を追加します。Cursor MCPドキュメント

MCP: Open User Configurationを実行し、以下を追加します。

{"servers":{"avito-ads":{"type":"stdio","command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"${input:avito_client_id}","AVITO_ADS_CLIENT_SECRET":"${input:avito_client_secret}","AVITO_ADS_ACCOUNT_ID":"${input:avito_account_id}"}}},"inputs":[{"type":"promptString","id":"avito_client_id","description":"Avito Ads Client Key"},{"type":"promptString","id":"avito_client_secret","description":"Avito Ads Client Secret","password":true},{"type":"promptString","id":"avito_account_id","description":"ID рекламного аккаунта"}]}

MCP: List Serversコマンドでサーバーを確認します。VS Code MCPドキュメント

任せられること

• 期間を指定してキャンペーン、グループ、クリエイティブ、ステータス、統計を表示する。

• グループとクリエイティブごとの費用、CTR、CPM、CPC、VTRを比較する。

• 代理店の残高と子アカウントを確認する。

• 1つのグループの予算または入札単価の変更を準備する。

• 送信する詳細情報を最初に表示してから、広告主とORD契約を作成する。

• ユーザーを追加し、ロールを変更するか、確認後にアクセス権を取り消す。

変更される可能性があるもの

キャンペーン、グループ、クリエイティブは、このAPIを通じて作成、編集、一時停止、アーカイブ、削除することはできません。クリエイティブとターゲティングも書き込みには利用できません。

アクセスの取得

1. 管理者ロールのユーザーでAvito広告のアカウントを開きます。

2. APIアプリケーションを作成し、Client KeyとClient Secretをコピーします。

3. 広告アカウントのIDをコピーします。

4. これらをAVITO_ADS_CLIENT_ID、AVITO_ADS_CLIENT_SECRET、AVITO_ADS_ACCOUNT_IDとして渡します。

サーバーはOAuth2 client_credentialsを通じてBearerトークンを取得します。Client Secretはパスワードと同様に保管してください。アカウントIDは設定で指定されます。ツールが誤って別のアカウントに切り替わることはありません。

書き込み操作のリハーサルにはAVITO_ADS_ENVIRONMENT=sandboxを設定できます。サンドボックスはproductionの完全なコピーではありません。たとえば、残高はサンドボックスでは利用できません。

設定

データ、制限、バックグラウンドでの動作

• 週次ポイント予算。 ポイントは月曜日の00:00 UTCに補充されます。最大100日間の1つの長いレポートは、一連の短いレポートよりも通常は効率的です。サーバーは各結果とともにapiPointBalanceを表示します。

• 一時的なエラー。 429の場合、エラーにはRetry-Afterとポイント残高が返されます。ネットワークエラーや5xxエラーの後に書き込みが再試行されることはありません。資金が二重に送金されるのを防ぐためです。

• 常時監視はありません。 サーバーは呼び出されたときのみ動作します。AIアプリケーションがスケジュールタスクをサポートしている場合、定期的に統計とポイント残高を収集できます。

• 匿名テレメトリ。 シークレット、アカウントデータ、引数、プロンプトは含まれません。無効化: ASKADS_TELEMETRY=0。

技術ドキュメント

• MCP機能カタログ — 各ツールのユーザータスク別ページ。

• すべてのツールとパラメータ

• 開発ドキュメント

• 公開ドキュメント

• 公式Avito Ads SDK

サポート

バグを見つけた、またはシナリオが足りない場合は、issueを作成するか、Telegramまでご連絡ください。