avito-api

Install

cp -r avito-api ~/.claude/skills/avito-api

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.

Example request

Show my active Avito listings and unread chats

Limitations

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.

Security check

• Requires Avito account client_id and client_secret
• Can change listings and send messages on the account's behalf

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.

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
```

Related