インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Avito をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
AI を Avito のビジネスアカウントで働かせます。広告の一覧表示と価格変更、閲覧数・問い合わせ・通話の統計の読み取り、オートロードのアップロードとそのエラー、フィード形式、ウォレットの確認、Avito Messenger のチャットの読み取りができます。メッセージ送信とオートロード設定の変更はオプションで、初期状態ではオフです。
こう聞いてみよう
Avito のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Avito をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Avito
AI を Avito のビジネスアカウントで働かせます。広告の一覧表示と価格変更、閲覧数・問い合わせ・通話の統計の読み取り、オートロードのアップロードとそのエラー、フィード形式、ウォレットの確認、Avito Messenger のチャットの読み取りができます。メッセージ送信とオートロード設定の変更はオプションで、初期状態ではオフです。
セットアップ
セットアップは約 5 分で、Avito のビジネスアカウントとその API 認証情報が必要です。ブラウザーでのサインインはありません。
- AI に使わせたいビジネスアカウントで Avito にサインインします。従業員のアカウントではなく、会社のメインアカウントを使ってください。
- Для профессионалов から API интеграции（avito.ru/professionals/api）を開き、Client ID と Client secret をコピーします。Avito が発行するのは 1 アカウントにつき 1 組だけで、新しい secret を生成すると古いものは使えなくなります。
- それぞれを
AVITO_CLIENT_IDとAVITO_CLIENT_SECRETに貼り付けてインストールします。AnythingMCP が Avito からアクセストークンを自動で取得し、24 時間ごとに更新します。 avito_get_selfを実行します。アカウントの名前、メールアドレス、ユーザー ID が表示されます。この ID が他のツールで必要なuser_idで、AI は会話の間ずっとこれを使い回します。
使える機能は Avito の料金プランで決まります: API でできるのは、そのアカウント自体に許可されていることだけです。Messenger API は、商品と求人では Максимальный（最上位）プラン、サービスでは Расширенный（拡張）または Максимальный プランでのみ使えます。それ以外ではチャット系ツールが 403 を返します。オートロード系ツールには、アカウントでオートロードが設定されている必要があります。
読み取れるデータ: アカウントとウォレット（ルーブル建ての実残高とボーナス）、掲載料やプロモーションの請求履歴。タイトル、価格、ステータス、カテゴリー、住所、適用中の有料サービス（vip、highlight、pushup、premium、xl）と終了日を含む広告。最大 200 件の広告をまとめて、最大 270 日前までさかのぼったユニーク閲覧数、問い合わせ数、お気に入り数。広告別・日別の通話数。オートロードの設定、各アップロードとその中の広告ごとのエラーと警告。カテゴリーごとのフィード項目。そして Avito Messenger のチャットとメッセージです。従業員サブアカウントの広告は一覧に出ず、チャットを読んでも既読にはなりません。
広告ごとに 2 つの ID: Avito ID は広告 URL に含まれる番号です。オートロードのフィードから来た広告には、フィード独自の Id もあります。AI が両者を変換するので、どちらの ID で尋ねても構いません。
変更の前に必ず確認: avito_update_item_price は 1 件の広告の価格を、ルーブルの整数で変更します（商品、部品、自動車、不動産が対象で、短期賃貸は対象外です）。新しい価格はすぐに公開されるため、AI は先に対象の広告、現在の価格、新しい価格を示し、あなたの承認を待ちます。広告がオートロードのフィードから来ている場合、次のアップロードでフィードの価格に戻ることがあるので、フィード側も変更してください。
インストール時はオフ: avito_send_message（アカウントの名前で購入者にメッセージを送ります。最大 1,000 文字で、ここからは取り消せません）、avito_mark_chat_read（未読マークが消えるため、同僚がメッセージを見落とすおそれがあります）、avito_update_autoload_profile（オートロードのプロフィール全体を置き換えます）、avito_start_autoload_upload（スケジュールの上限を無視してフィードの全広告を一度に公開するため掲載料がかかることがあり、実行は 1 時間に 1 回までです）。管理者が意図して有効にでき、その場合でも AI は送る文面や変更内容を正確に示し、あなたの確認を待ちます。
購入者のデータ: チャットには購入者の名前とメッセージが含まれます。AI はそれをその購入者への対応にだけ使い、先に連絡してきていない人にメッセージを送ることはありません。
時刻と言語: Avito はモスクワ時間（UTC+3）で動いており、AI は時刻を変換してから伝えます。Avito からのメッセージはロシア語なので、AI が翻訳します。
制限: 広告の一覧は 1 分あたり最大 25 リクエスト、価格変更は 1 分あたり 150、広告 1 件の読み取りは 1 分あたり 500 です。ウォレットの履歴は 1 回の取得で最大 1 週間分、1 年前までです。429 が返ったら AI は 1 分待ってから再試行します。
よくあるエラー: 401 Bad bearer token または 403 invalid access token は、Client ID か secret が間違っているか、新しく生成した secret に置き換わったことを示します。それ以外の 403 は、料金プランにその API（特に Messenger）が含まれていないことを示します。404 は広告、チャット、アップロードが存在しないか別のアカウントのものであることを示し、オートロードのレポートはアップロードがまだない間も 404 を返します。400 はパラメーターの誤りで、たとえばここでは価格を変更できないカテゴリーの価格や、1 週間を超えるウォレットの期間指定です。
このコネクターは、プロモーションサービスとその料金、広告キャンペーン、CPA とコールトラッキング、配送と注文、評価とレビュー、Avito Jobs、短期賃貸、従業員アカウント、Webhook、画像や音声メッセージの送信には対応していません。広告の内容の作成や編集も行いません。それはオートロードのフィードで行います。
前提条件: AVITO_CLIENT_ID, AVITO_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 を開き、 Avito を選択し、前提条件に記載された環境変数を入力します。
利用可能なツール
| Tool | What it does |
|---|---|
avito_get_self | Read the Avito account the credentials belong to: its user id, name, email and profile URL |
avito_get_balance | Read the Avito wallet balance of the account: real money (real) and bonus funds (bonus), in rubles |
avito_get_operations_history | Read the wallet operations of the account (charges for listings and promotion services, top-ups, refunds) between two moments: amount in… |
avito_list_items | List the account's ads (items): id, title, price in rubles (null when none is set), status, category, address and URL |
avito_get_item | Read one ad of the account: status, URL, start and finish time, the autoload id from the feed file, and the paid promotion services applied… |
avito_update_item_price | Change the price of one Avito ad, in whole rubles |
avito_get_item_stats | Read views, contacts and favourites of up to 200 of the account's ads per day, week or month: uniqViews (unique viewers), uniqContacts… |
avito_get_calls_stats | Read call statistics of the account per ad and per day: calls, answered, new and newAnswered calls, optionally only for some ads. itemId 0… |
avito_get_autoload_profile | Read the account's autoload (bulk upload) settings: whether autoload is on, the feed files and their URLs, the report email and the upload… |
avito_update_autoload_profile | Replace the account's autoload settings: on or off, feed files, report email and schedule |
avito_start_autoload_upload | Start an upload of the feed file configured in the autoload settings now |
avito_list_autoload_uploads | List past autoload uploads, newest first: upload id, status (processing, success, success_warning, error and others), source (Url, Email… |
avito_get_current_autoload_upload | Read the current autoload upload: the latest one that processed at least one ad |
avito_list_current_autoload_upload_items | List the ads of the current autoload upload with their feed id (ad_id), Avito id, status on Avito, URL, report section and messages… |
avito_get_last_successful_autoload_upload | Read the last autoload upload that processed every ad of the feed: status, start time, feed files, events and ad counts per report section.… |
avito_list_last_successful_autoload_upload_items | List the ads of the last completed autoload upload with their feed id (ad_id), Avito id, status on Avito, URL, report section and messages… |
avito_get_autoload_category_tree | Read Avito's category tree for autoload feeds: category names, nested subcategories and the slug of each leaf, which… |
avito_get_autoload_category_fields | Read the feed fields of one Avito category: each tag with its label, whether it is required (also depending on other fields), data type… |
avito_get_feed_ids_by_avito_ids | Translate Avito ad ids into the ids the ads have in the autoload feed file (the Id field) |
avito_get_avito_ids_by_feed_ids | Translate ids from the autoload feed file (the Id field) into Avito ad ids |
avito_list_chats | List the account's Avito Messenger chats, newest activity first: chat id, the ad it is about (title, price, URL), the other user's name… |
avito_get_chat | Read one Avito Messenger chat: the ad it is about (title, price, URL, status), the users and the last message |
avito_list_messages | Read the messages of one Avito Messenger chat, newest first: id, author id, direction (in from the buyer, out from the account), type… |
avito_mark_chat_read | Mark an Avito Messenger chat as read, as if the seller had opened it |
avito_send_message | Send a text message (at most 1,000 characters) in an Avito Messenger chat, on behalf of the account |
プロンプトの例
- 「公開中の広告のうち、過去 30 日間で閲覧数と問い合わせが最も多かったのはどれですか。まったく反応がなかった広告も教えてください。」
- 「『iPhone 13 128 GB』の広告の価格を 42,000 ルーブルに下げてください。先に現在の価格と新しい価格を見せてください。」
- 「前回のオートロードのアップロードでエラーはありましたか。エラーのある広告と、フィードで直すべき点を教えてください。」
- 「Avito Messenger で未読のチャットはどれですか。購入者が何を尋ねているかまとめてください。」
- 「先週 Avito のウォレットから何にいくら引き落とされましたか。現在の残高も教えてください。」
次のステップ
このガイドは役に立ちましたか?
