avito-api skill
An Avito Business API skill: a full OpenAPI spec with 245 operations, an OAuth2 helper and an endpoint lookup CLI
- 15 ★ on the repository
- Last commit
Extended access
Why this level
- Requires Avito account client_id and client_secret
- Can change listings and send messages on the account's behalf
Install
- Works in
- Services
Manual install
cp -r avito-api ~/.claude/skills/avito-apiFor other agents, place the folder in their Agent Skills directory.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Requires Avito account client_id and client_secret
- Can change listings and send messages on the account's behalf
This is third-party code. Review the repository files before installing.
What it does
The skill bundles a merged OpenAPI 3.0 spec from Avito's official catalog (25 sections: listings, Messenger, Delivery, Avito Jobs, Autoload, Autoteka, promotion, Avito Ads and more) plus official per-section guides. get_token.py fetches a Client Credentials token and lookup_endpoint.py searches endpoints and shows parameters, schemas and rate limits without loading 2 MB of JSON into context. The agent then calls the API with curl or requests.
Who it is for. For sellers and developers automating Avito listings, chats and orders.
Good fit when
- You need your listings or their statistics
- You need to read and send Avito chat messages
- You need to work out an Avito Delivery or Autoload integration
Not a fit when
- You have no registered Avito API application
- You need other users' data without the OAuth Authorization Code flow
Example request
Show my active Avito listings and unread chatsLimitations
Requires client_id and client_secret from the Avito account. Some endpoints require the Authorization Code flow with scopes. The skill is not affiliated with Avito; docs in references belong to KEH eCommerce LLC, and API terms should be checked yourself.
How to disable. Remove ~/.claude/skills/avito-api and the AVITO_CLIENT_ID and AVITO_CLIENT_SECRET variables.
FAQ
Where do I get client_id and client_secret?
In the Avito account: Settings, Avito API, Register a new application.
How long is a token valid?
24 hours. The skill recommends caching it per session and refreshing on 401.
Discussion
No questions or reviews yet.
Related
All Avito toolsA skill that connects two Avito MCP servers: the official API for your own account and public search for competitor research
A CLI and skill for Avito search through your own already open browser over CDP: search, filters, listing cards, seller reviews, no API keys
A plugin with skills and distributed MCP servers for parsing the Avito catalog, price monitoring and notifications, with an honest legal risk section
An MCP server for an Avito seller account: buyer chats, listings, stats, promotion and orders, with a read-only mode
A single-marketplace distribution of the marketplaces-mcp-ru core just for Avito: 64 API methods via a method catalog instead of a hundred separate tools
avito-mcp with multiple accounts
avito-mcp
An Avito API MCP with support for up to nine accounts, an honest list of what the API cannot change, and a Railway deployment
README in short
avito-api follows the agentskills.io format and installs by copying the folder into a skills directory. The spec and markdown guides are collected from the official developers.avito.ru catalog. SKILL.md covers auth, spec lookup, versioning quirks, rate limits, error shapes and the Autoload deprecation timeline. Code and SKILL.md are MIT; the documentation belongs to Avito.
README badge
Original SKILL.md
---
name: avito-api
description: >-
Use when the user works with Avito (avito.ru) for business via API — объявления,
чаты, доставка/заказы, Авито.Работа, Автозагрузка, Автотека, продвижение, Авито
Promo, Авито Реклама, аналитика, тарифы, рейтинги. Triggers: "Avito API",
"авито апи", "Авито Promo", avito-promo, "объявления на авито", "чаты авито",
"Автотека", "Авито Реклама", api.avito.ru.
---
# Avito Business API
This skill helps you call the Avito Business API (`https://api.avito.ru`). It bundles the full OpenAPI 3.0 spec built from the **official developer catalog** (`developers.avito.ru/api-catalog`) — 238 paths / 245 operations across 25 sections — plus the per-section integration docs Avito publishes alongside.
The spec is large (~2.0 MB). Don't read it whole — use the helpers described below to pull only what you need.
## Authentication — OAuth2 Client Credentials
Almost every endpoint requires a Bearer token. Tokens are valid for 24h. The credentials come from the user's Avito account → Настройки → Avito API → Регистрация нового приложения, which gives a `client_id` + `client_secret`.
**Get a token:**
```bash
AVITO_CLIENT_ID=... AVITO_CLIENT_SECRET=... \
python3 scripts/get_token.py
# prints just the access_token; add --json for the full response
```
## How to find the right endpoint — DO THIS FIRST
```bash
python3 scripts/lookup_endpoint.py tags
python3 scripts/lookup_endpoint.py search чат
python3 scripts/lookup_endpoint.py show /messenger/v2/accounts/{user_id}/chats
```