avito-api — скилл
Скилл для Avito Business API: полный OpenAPI-спек на 245 операций, OAuth2-хелпер и CLI для поиска эндпоинтов
- 15 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Требует client_id и client_secret аккаунта Avito
- Может менять объявления и отправлять сообщения от имени аккаунта
Установка
- Работает в
- Сервисы
Ручная установка
cp -r avito-api ~/.claude/skills/avito-apiДля других агентов положите папку в их каталог Agent Skills.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Требует client_id и client_secret аккаунта Avito
- Может менять объявления и отправлять сообщения от имени аккаунта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл содержит объединенную OpenAPI 3.0 спецификацию из официального каталога Avito (25 разделов: объявления, Мессенджер, Доставка, Авито.Работа, Автозагрузка, Автотека, продвижение, Авито Реклама и другие) и официальные гайды по разделам. Скрипт get_token.py получает токен по Client Credentials, lookup_endpoint.py ищет эндпоинты и показывает параметры, схемы и лимиты без загрузки 2 МБ JSON в контекст. Агент затем вызывает API через curl или requests.
Для кого. Для продавцов и разработчиков, которые автоматизируют работу с объявлениями, чатами и заказами на Авито.
Подходит, если
- Нужно получить список своих объявлений или статистику по ним
- Нужно читать и отправлять сообщения в чатах Авито
- Нужно разобраться с интеграцией Авито Доставки или Автозагрузки
Не подходит, если
- Нет зарегистрированного приложения в Avito API
- Нужны данные чужих пользователей без OAuth Authorization Code
Пример запроса к агенту
Покажи мои активные объявления на Авито и непрочитанные чатыОграничения
Нужны client_id и client_secret из кабинета Avito. Часть эндпоинтов требует Authorization Code flow со scope. Скилл не аффилирован с Avito, документация в references принадлежит ООО «КЕХ еКоммерц», условия использования API нужно проверять самостоятельно.
Как отключить. Удалите каталог ~/.claude/skills/avito-api и переменные AVITO_CLIENT_ID и AVITO_CLIENT_SECRET.
Частые вопросы
Где получить client_id и client_secret?
В кабинете Avito: Настройки, Avito API, Регистрация нового приложения.
Сколько живет токен?
24 часа. Скилл советует кешировать его на сессию и обновлять при 401.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Авито — все инструментыСкилл для оптимизации объявлений Avito
Avito Skill + MCP Setup
Скилл, который связывает два MCP Avito: свой аккаунт по официальному API и публичный поиск для анализа конкурентов
CLI и скилл для поиска на Авито через уже открытый браузер по CDP: поиск, фильтры, карточки, отзывы продавца, без API-ключей
Плагин с навыками и распределенными MCP-серверами для парсинга каталога Авито, мониторинга цен и уведомлений, с честным разделом о правовых рисках
MCP-сервер для аккаунта продавца на Авито: чаты с покупателями, объявления, статистика, продвижение и заказы с режимом только чтения
Однорыночная поставка ядра marketplaces-mcp-ru только под Авито: 64 метода API, каталог методов вместо сотни отдельных инструментов
MCP для API Авито с поддержкой до девяти кабинетов, честным списком того, что API не умеет менять, и деплоем на Railway
Коротко о README
avito-api оформлен в формате agentskills.io и ставится копированием папки в каталог скиллов. Спецификация и markdown-гайды собраны из официального каталога developers.avito.ru. SKILL.md описывает авторизацию, работу с поиском по спеке, особенности версий, лимиты, форматы ошибок и сроки вывода старых методов Автозагрузки. Код и SKILL.md под MIT, документация принадлежит Avito.
Бейдж для README
Исходный 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
```