Avito

Avito

This connector works with Avito, Russia's classifieds marketplace, through the Avito API for business (https://api.avito.ru) on behalf of one Avito account: the account and its wallet, its ads and their prices, statistics of views, contacts and calls, autoload (bulk upload from a feed file) settings, uploads and reports, and Avito Messenger chats. It signs in with the account's own client_id and client_secret (OAuth2 client credentials); there is no browser sign-in.

Setup (about 5 minutes)

1. Sign in to Avito with the business account the AI should work with (the main company account, not an employee).
2. Open Для профессионалов, API интеграции (https://www.avito.ru/professionals/api; in the profile menu it is under the professional tools and settings) and copy Client ID and Client secret. Avito issues one pair per account; generating a new secret invalidates the old one.
3. Paste them into AVITO_CLIENT_ID and AVITO_CLIENT_SECRET and install. AnythingMCP requests an access token from https://api.avito.ru/token and renews it after 24 hours.

Access depends on the Avito tariff. The API works with what the account itself may do. Messenger API is available only on the Максимальный subscription for goods and jobs, and on Расширенный or Максимальный for services; without it the chat tools answer 403. Autoload tools need autoload set up in the account.

user_id: call avito_get_self first. Its id is the account's user id, which every tool with a user_id parameter needs; it does not change, so reuse it within the conversation.

Writes: confirm first. avito_update_item_price is on, because it is the most common task: before changing a price, tell the user the ad, the old price and the new one, and wait for a yes. A price is public at once. If the ad comes from an autoload feed, the next upload can bring back the feed's price: change it in the feed too. Switched off at install: avito_send_message, avito_mark_chat_read, avito_update_autoload_profile and avito_start_autoload_upload. An admin turns them on deliberately. Even then, show the user the exact message text, or the exact settings change, and wait for confirmation. avito_update_autoload_profile replaces the whole profile: read it with avito_get_autoload_profile, change one field, send everything back. avito_start_autoload_upload publishes every ad in the feed at once, ignoring the schedule's limits, which can cost listing fees; once per hour at most.

Personal data: chats contain buyers' names and messages. Use them only to serve those buyers, do not copy them elsewhere, and never message people who did not write first.

Which tool

• Account: avito_get_self, avito_get_balance, avito_get_operations_history (wallet charges, at most one week per call).
• Ads: avito_list_items (filter by status, category, update date), avito_get_item (status and paid services), avito_update_item_price.
• Statistics: avito_get_item_stats (unique views, contacts and favourites of up to 200 ads, 270 days back), avito_get_calls_stats.
• Autoload settings: avito_get_autoload_profile, avito_update_autoload_profile, avito_start_autoload_upload.
• Autoload reports: avito_list_autoload_uploads, avito_get_current_autoload_upload, avito_list_current_autoload_upload_items, avito_get_last_successful_autoload_upload, avito_list_last_successful_autoload_upload_items (errors and warnings per ad).
• Feed format: avito_get_autoload_category_tree, then avito_get_autoload_category_fields with a slug.
• Ids: an ad has an Avito id (avito_id, the number in its URL) and, when it comes from a feed, the feed's own id (ad_id). avito_get_feed_ids_by_avito_ids and avito_get_avito_ids_by_feed_ids translate.
• Messenger: avito_list_chats (use unread_only for new conversations), avito_get_chat, avito_list_messages, avito_mark_chat_read, avito_send_message.

Formats: prices are whole rubles. Dates are YYYY-MM-DD; upload filters take RFC 3339 (2026-10-01T00:00:00Z); avito_get_operations_history takes YYYY-MM-DDTHH:MM:SS. Messenger times are Unix seconds. Avito works in Moscow time (UTC+3); convert before quoting a time to the user. Messages in Avito's answers are in Russian; translate them for the user when needed.

Paging: avito_list_items pages with page and per_page (stop when a page has fewer ads than per_page); uploads and their items return meta.pages; chats and messages use limit and offset (at most 1000).

Rate limits: listing ads at most 25 requests a minute, price changes 150 a minute, reading one ad 500 a minute. On 429 wait a minute before retrying.

Common errors ({"result": {"status": false, "message": ...}} or {"error": {"code", "message"}})

• 401 "Bad bearer token" or 403 "invalid access token": the token is missing or no longer valid; check the client ID and secret (a regenerated secret makes the old one fail).
• 403 otherwise: the tariff does not include this API (Messenger above all), or the user_id is not this account.
• 404: the ad, chat or upload does not exist or belongs to another account; the autoload report tools answer 404 when there is no matching upload yet.
• 400: a parameter is wrong, e.g. a price in a category that does not allow changing it here, or an operations window longer than a week.
• 429: rate limit.

Out of scope here: promotion services (VAS) and their prices, ads campaigns, CPA and call tracking, delivery and orders, ratings and reviews, Avito Jobs (vacancies and CVs), short-term rentals, the account hierarchy of employees, webhooks, sending images or voice messages, and creating or editing ad content (that goes through the autoload feed).