Yandex Cloud Search Cost Control

---
name: yandex-cloud-search-cost-control
description: "Расследование, остановка и контроль расходов Yandex Cloud Search API без раскрытия доступов."
---

# Контроль расходов Yandex Cloud Search API

## Разделение продуктов

Не смешивай:

- платный Yandex Cloud Search API, в частности `POST /v2/web/search`;
- Яндекс Директ;
- Wordstat;
- встроенный веб-поиск модели;
- браузерный сбор и другие обходчики;
- другие платные источники выдачи, в том числе XMLRiver: его расход проверяется по балансу до и после (`get_info`) и журналу сборщика, а не по биллингу Yandex Cloud.

Источник расхода не считается найденным, пока не совпали продукт, время, ключ или служебная учётная запись, настроенный вызывающий контур и факт вызова.

## Порядок расследования

1. Подтверди строку биллинга, платный продукт и окно времени.
2. Собери безопасные названия облака, папки, служебных учётных записей и ключей. Идентификаторы маскируй, секреты не печатай.
3. Проверь все местные вызывающие контуры: подключаемые службы, файлы среды, сценарии, расписания, процессы и журналы фактических вызовов.
4. Если мониторинг или журнал аудита недоступен, зафиксируй разрыв атрибуции. Пустой журнал не доказывает отсутствие расхода.
5. Сначала отключи или приостанови доказанный местный вызывающий контур, затем перечитай его состояние.
6. Удаление, отключение или замена облачного ключа требует явного одобрения с названием ключа, служебной учётной записью, областью, влиянием и путём восстановления.
7. После изменения повторно проверь ключ, вызывающий контур и окно фактического потребления. Нулевой отчёт сначала сверь с заведомо положительным днём или другим надёжным контролем.

Подробности к порядку:

- Если биллинг доказывает платное использование Search API, а мониторинг недоступен (ограничения биллинга, нет метрик, прав или лимитов сервиса) и журнал аудита пуст или не был включён, разрыв атрибуции записывается явно, а расследование продолжается безопасными доказательствами: продукт и окно, перечень ключей с правом поиска, локальная настройка MCP и инструментов, журналы реальных платных вызовов, процессы и расписания, варианты отключения вызывающего контура.
- Инструмент в списке подключённых или пустой журнал ничего не доказывают. Вызывающий контур считается причастным, только если есть настройка и свидетельство процесса, расписания, сеанса или запроса, связывающее его с платным `/v2/web/search`.
- Различать название ключа, идентификатор ресурса, значение секрета, служебную учётную запись, каталог, области действия, время создания и признаки последнего использования. Первый найденный ключ — не обязательно тот, что тратит деньги.
- Нулевой отчёт за целевой день проверяется тем же путём выгрузки на заведомо положительном дне или продукте: иначе ноль может оказаться артефактом фильтра, схемы, прав, задержки или названия продукта.
- План удаления или отключения ключа содержит: человекочитаемое имя ключа и маскированный идентификатор; служебную учётную запись, каталог и облако; вызывающий контур, если известен; ожидаемое влияние; путь отката или замены; подтверждение, что секрет не выводился и не попал в отчёты. При неполной атрибуции сначала приостанавливается локальный вызывающий контур или ключ убирается из локальной настройки инструмента, а не удаляется облачный ключ вслепую.

## Ворота публичного моста

`mcp/yandex-search` по умолчанию выключен. Он читает ключ и папку только из `YANDEX_SEARCH_API_KEY` и `YANDEX_SEARCH_FOLDER_ID`.

- `YANDEX_SEARCH_ROUTE=manual` разрешает один вызов, только если его тело содержит точный `paid_search_approval` с `approved=true`, маршрутом, `max_calls=1` и ссылкой на одобрение.
- `YANDEX_SEARCH_ROUTE=approved` требует закрытый `YANDEX_SEARCH_APPROVAL_FILE`, точный отпечаток папки, срок, список маршрутов, предел вызовов и закрытый `YANDEX_SEARCH_USAGE_LEDGER`.

Вызов резервирует единицу лимита до сети. Повтора и переключения на другой платный маршрут после ошибки нет.

## Отчёт

Сначала укажи подтверждённый платный продукт и окно, затем вызывающий контур или разрыв атрибуции, потом безопасные названия ключей и служебных учётных записей, принятое действие и проверку после него. Не утверждай, что расход остановлен, без чтения состояния вызывающего контура и окна фактического потребления.