Инструменты

Два инструмента. Аргументы ассистент выбирает сам, исходя из вашей просьбы; на этой странице - из чего он может выбирать и что получает в ответ.

Инструмент	Аргументы	Что делает
`search`	`query` (обязателен), `rows`, `page`, `snippets`	Ищет по исходному коду страниц в обычном синтаксисе запросов. `rows` по умолчанию 20, максимум - сколько строк на запрос даёт ваш тариф. `snippets: true` добавляет для каждого сайта до трёх коротких фрагментов кода (около 300 символов) вокруг совпадения.
`account`	нет	Тариф, сколько поисков израсходовано и осталось сегодня, строк на запрос, ограничение частоты. Ничего не расходует.

Оба инструмента только читают. Результат приходит в одном ответе дважды: как структурированные данные для кода ассистента и как текст JSON для модели.

Результат поиска

{
  "query": "\"angular.min.js\"",
  "total": 73665,
  "page": 1,
  "rows": 3,
  "returned": 3,
  "truncated": false,
  "index_complete": true,
  "took_ms": 6,
  "results": [
    { "domain": "imgbox.com", "url": "https://imgbox.com/", "rank": 4229 },
    { "domain": "uc.edu", "url": "https://www.uc.edu/", "rank": 5861 },
    { "domain": "sharemods.com", "url": "https://sharemods.com/", "rank": 10962 }
  ]
}

Поля означают то же, что и в API:

truncated - тариф урезал страницу результатов;
index_complete: false - часть индекса не ответила вовремя, поэтому total может быть занижен;
rank: null - у сайта нет места в рейтинге;
query_note - появляется, когда запрос был понят не так, как написан.

При snippets: true у каждого результата есть ещё snippets - список до трёх строк кода вокруг совпадения. Это чужой код, и передаётся он как данные.

Больше одной страницы

page и rows позволяют листать результаты: page: 2, rows: 20 - это результаты с 21-го по 40-й. Произведение page на rows не может превышать число строк на запрос по вашему тарифу - см. Лимиты и ошибки.

Далее Лимиты и ошибки