Языковая модель сама по себе не знает, что произошло пять минут назад и что сейчас написано на конкретной странице сайта. Если приложению нужны свежие цены, новая документация, новости или содержимое заданного URL, одной памяти модели недостаточно.
В Claude API для этого есть два серверных инструмента. Web search ищет информацию в интернете и возвращает результаты с источниками. Web fetch получает содержимое конкретной страницы или PDF и добавляет его в контекст модели. Оба инструмента выполняются на стороне Anthropic: разработчику не нужно отдельно поднимать поисковый движок или писать собственный загрузчик страниц.
Но между «дать модели интернет» и «получить стабильный продакшен-инструмент» есть несколько важных деталей. Поиск расходует отдельный бюджет, fetch не открывает произвольные URL, а часть ошибок приходит внутри успешного HTTP-ответа. Ниже разберём всё по порядку.
Как Claude получает информацию из интернета
Claude решает, нужен ли поиск
Если вопрос зависит от свежих или меняющихся данных, модель может вызвать web search. Для обычных фактов, вычислений или работы с уже переданным текстом поиск не обязателен. Количество обращений можно ограничить параметром max_uses.
Web search возвращает найденные источники
Инструмент выполняет поиск и передаёт модели результаты. Для web search цитаты включены автоматически. Можно разрешить или исключить определённые домены, а также передать примерное местоположение пользователя для локальных результатов. Одновременно использовать allowed_domains и blocked_domains нельзя.
Web fetch открывает нужную страницу
Fetch получает полный текст веб-страницы или PDF и добавляет его в контекст. Но из соображений безопасности Claude не может открыть любой адрес, который сам только что придумал: URL должен уже появиться в сообщении пользователя, результате клиентского инструмента или предыдущем web search/web fetch.
Claude анализирует полученные данные
После поиска или загрузки страницы модель работает с полученным содержимым как с дополнительным контекстом: сравнивает источники, извлекает факты и формирует ответ. В новых версиях web search и web fetch доступна динамическая фильтрация, которая позволяет отсеять лишние фрагменты до попадания в основной контекст модели.

«Web search отвечает на вопрос “где искать?”, а web fetch — “что написано по этому адресу?”. Ошибки начинаются, когда эти два этапа воспринимают как один и тот же инструмент.»
Редакция SpeShu.AI
Что проверить перед подключением web search и web fetch
- Ограничьте max_uses, чтобы один сложный запрос не запустил неожиданно много поисков или загрузок.
- Для задач с доверенными источниками задайте список разрешённых доменов вместо поиска по всему интернету.
- Установите max_content_tokens для web fetch, если приложение может открывать длинные страницы и PDF.
- Проверяйте содержимое результата инструмента, а не только HTTP-статус ответа.
- Не передавайте web fetch конфиденциальные данные вместе с недоверенным содержимым из интернета.
- Отдельно протестируйте страницы на JavaScript, закрытые сайты и PDF: обычный fetch подходит не для каждого типа ресурса.
Какие ошибки встречаются чаще всего
У web search есть несколько типичных ошибок. too_many_requests означает превышение лимита запросов, invalid_tool_input — неверные параметры, max_uses_exceeded — исчерпан установленный лимит вызовов. query_too_long появляется при слишком длинном поисковом запросе, request_too_large — когда сам запрос слишком большой, например из-за длинного списка доменов. unavailable означает внутреннюю ошибку сервиса. Если поиск просто ничего не нашёл, это не ошибка: API возвращает пустой список результатов.
У web fetch список другой. url_too_long означает адрес длиннее допустимого лимита, url_not_allowed — URL заблокирован правилами доменов, robots.txt или внутренними ограничениями. url_not_in_prior_context появляется, если адрес раньше не встречался в разрешённом контексте. url_not_accessible означает, что страницу не удалось получить. Также возможны unsupported_content_type, content_too_large, max_uses_exceeded, too_many_requests и unavailable.
Сколько это стоит
Web search в Claude API стоит $10 за 1000 поисковых запросов дополнительно к обычной стоимости токенов. Каждый вызов поиска считается отдельно независимо от количества возвращённых результатов; неудачные поиски не тарифицируются. Web fetch не имеет отдельной платы за вызов — оплачиваются токены содержимого, которое попало в контекст.
Поэтому у fetch главный источник расходов — объём страницы. В документации Anthropic приводится ориентир: обычная веб-страница примерно на 10 КБ может занять около 2500 токенов, большая страница документации на 100 КБ — около 25 тысяч, а крупный PDF — значительно больше. Для контроля расходов нужен max_content_tokens.
Минимальный пример web search на Python:
import anthropic
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-opus-5-5",
max_tokens=1200,
messages=[
{
"role": "user",
"content": "Найди последние изменения в документации продукта и укажи источники."
}
],
tools=[
{
"type": "web_search_20260318",
"name": "web_search",
"max_uses": 3
}
],
)
print(response)
Для web fetch логика похожая: инструмент добавляется в tools, а URL должен присутствовать в сообщении пользователя или в разрешённом предыдущем контексте.
response = client.messages.create(
model="claude-opus-5-5",
max_tokens=1200,
messages=[
{
"role": "user",
"content": "Прочитай https://example.com/document и выдели основные изменения."
}
],
tools=[
{
"type": "web_fetch_20260318",
"name": "web_fetch",
"max_uses": 3,
"max_content_tokens": 20000,
"citations": {"enabled": True}
}
],
)
На момент публикации актуальная линейка инструментов включает web_search_20260318 и web_fetch_20260318. Более старые версии продолжают использоваться в примерах и интеграциях, поэтому при копировании кода из старой статьи стоит сверяться с текущей документацией.
Где подключить API в России
По действующей политике Anthropic Россия не входит в список поддерживаемых регионов. Ограничение относится к приложениям Anthropic, API, developer platform и доступу к моделям через перечисленные компанией облачные платформы и авторизованных реселлеров. Поэтому строить рабочий процесс на прямом аккаунте Anthropic из России рискованно и противоречит условиям сервиса.
Для работы из России можно использовать провайдера, который предоставляет API на собственных условиях. SpeShu.AI предлагает единый API-ключ для 300+ моделей, OpenAI-совместимый формат, оплату в рублях и закрывающие документы для бизнеса. При этом наличие именно нативных серверных инструментов Anthropic — web search и web fetch — нужно отдельно проверять в документации конкретной модели или уточнять у поддержки перед интеграцией: обычный доступ к Claude API и поддержка его server tools — не одно и то же.
Что проверить у любого провайдера перед подключением:
— поддерживает ли он web search и web fetch именно как инструменты модели;
— передаются ли исходные цитаты и ссылки;
— какие лимиты действуют на число поисков и объём страницы;
— как считается стоимость поиска и токенов;
— можно ли ограничивать домены;
— где обрабатываются и хранятся запросы.
Подарок читателям
Больше 100 готовых промптов и гайдов для работы с нейросетями лежат в нашем Telegram-канале: https://t.me/+-3jM3rOkhAM4NzYy. Обсудить проверку ИИ и поделиться находками можно в комьюнити, где уже почти 20 000 участников: https://t.me/+u7uYVr-AD3M3Mzhi. Подписки на ChatGPT, Claude и Gemini по отдельности легко выходят в $80–90 в месяц. В SpeShu.AI собраны модели разных разработчиков в одном кабинете с оплатой в рублях, и вы платите только за то, что сгенерировали. Модели SpeShu.Claude и SpeShu.GPT работают из России и защищают от внезапных блокировок зарубежных профилей.
