avito-api

Установка

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

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл содержит объединенную OpenAPI 3.0 спецификацию из официального каталога Avito (25 разделов: объявления, Мессенджер, Доставка, Авито.Работа, Автозагрузка, Автотека, продвижение, Авито Реклама и другие) и официальные гайды по разделам. Скрипт get_token.py получает токен по Client Credentials, lookup_endpoint.py ищет эндпоинты и показывает параметры, схемы и лимиты без загрузки 2 МБ JSON в контекст. Агент затем вызывает API через curl или requests.

Для кого. Для продавцов и разработчиков, которые автоматизируют работу с объявлениями, чатами и заказами на Авито.

Пример запроса к агенту

Покажи мои активные объявления на Авито и непрочитанные чаты

Ограничения

Нужны 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
• Может менять объявления и отправлять сообщения от имени аккаунта

Коротко о README

avito-api оформлен в формате agentskills.io и ставится копированием папки в каталог скиллов. Спецификация и markdown-гайды собраны из официального каталога developers.avito.ru. SKILL.md описывает авторизацию, работу с поиском по спеке, особенности версий, лимиты, форматы ошибок и сроки вывода старых методов Автозагрузки. Код и SKILL.md под MIT, документация принадлежит 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
```

Похожие