# Авито Реклама: Прямой вызов API Авито Рекламы — MCP-инструмент (tool)

**MCP-инструмент (tool) для Авито Рекламы:** Универсальный запрос к любому пути API Авито Рекламы — для эндпоинтов, у которых нет отдельного инструмента, например GET "v1/account/{accountID}/balance" или POST "v1/account/{accountID}/campaigns".

Техническое имя: `raw_request`

## Какую задачу решает

> Я хочу выполнить дополнительный запрос к API.

Универсальный запрос к любому пути API Авито Рекламы — для эндпоинтов, у которых нет отдельного инструмента, например GET "v1/account/{accountID}/balance" или POST "v1/account/{accountID}/campaigns".

## Когда использовать

Используйте эту возможность, когда нужен результат «Прямой вызов API Авито Рекламы» без ручной работы в интерфейсе Авито Рекламы. Операция выполняется только по вызову из AI-приложения.

## Что нужно передать

- `path` — **обязательно**. Путь API, например "v1/account/{accountID}/groups" или "v1/account/{accountID}/campaigns/123/stats".
- `method` — **необязательно**. HTTP-метод. По умолчанию GET.
- `body` — **необязательно**. Тело запроса в JSON, например {"filter":{},"limit":20,"page":1} для эндпоинта списка.
- `confirmWrite` — **необязательно**. Для POST и DELETE должен быть true. Установка флага подтверждает, что путь может писать: funds-transfer и delete-user — такие же POST/DELETE, как и любое чтение списка.

## Что вернёт

Возвращает сырой ответ плюс apiPointBalance (остаток недельных баллов).

## Что изменится в Авито Рекламе

Исходный код помечает весь вызов «Прямой вызов API Авито Рекламы» как опасный. Конкретное воздействие зависит от переданного действия и описано ниже; перед вызовом проверьте параметры и обратимость результата.

## Пример запроса

> Выполнить дополнительный запрос к API в Авито Рекламе. Если не хватает обязательных идентификаторов, сначала уточни их. Сначала покажи, какие данные изменятся, и дождись подтверждения.

## Возможные ошибки и ограничения

Пути задаются относительно базы API и привязаны к аккаунту: подстановка {accountID} заменяется на настроенный id аккаунта, путь с другим аккаунтом отклоняется, как и путь, выходящий за базу API. `body` отправляется как JSON. Через него доступны все пишущие эндпоинты — funds-transfer, bonus-transfer, delete-user и create-*, — причём без клиентских проверок, которые делают отдельные инструменты, и ничего из этого не отменить; когда специальный инструмент есть, лучше взять его: transfer_funds / delete_user / create_*. confirmWrite=true — явное подтверждение того, что путь может писать, поэтому перед установкой флага путь стоит проверить: POST используется и для безобидных чтений — списков и статистики, — которым флаг тоже нужен. GET выполняется без ограничений.

Доступ также зависит от прав токена, квот и ограничений исходного API.

## Связанные MCP-инструменты

Связанных специализированных инструментов в этой группе нет.

## Технические сведения

- **Воздействие:** опасная операция
- **Группа:** Дополнительные методы API
- **Источник описания:** регистрация `raw_request` в `src/tools/raw.ts`
- [Полный технический справочник](../TOOLS.md)
- [Все MCP-возможности](./index.md)