Web search и web fetch API: что это, как работает, какие бывают ошибки и как получить доступ в России без VPN

Как это выглядит в запросе

Минимальный пример на Python для поиска с ограничением в пять запросов:

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "What changed in the latest release of [PRODUCT]?"}],
    tools=[{"type": "web_search_20250305", "name": "web_search", "max_uses": 5}],
)

Для загрузки страницы укажите инструмент web_fetch с нужным типом и адрес страницы в сообщении пользователя.

Промпт для исследования с поиском

Если поиск включён в вашем сервисе, можно задать правила прямо в запросе:

You are a research assistant. Search the web for [TOPIC]. Use only sources published in the last 12 months. For each claim, give the source link and the date. If sources disagree, show both versions and say which one is more reliable and why. If you cannot find a reliable source, write “not found” instead of guessing.

Доступ из России: что можно и что нельзя

Правила Anthropic прямые: Россия не входит в список поддерживаемых стран, а страна, которой нет в списке, считается неподдерживаемой. Запрещено использование людьми, физически находящимися в неподдерживаемом регионе, и организациями, зарегистрированными или управляемыми оттуда. Это относится и к API, и к приложению Claude.

Обходить это ограничение мы не советуем. Это нарушает правила сервиса, а значит ваш аккаунт или ключ могут быть заблокированы без возврата средств. Поэтому в этой статье нет инструкций по обходу.

Что остаётся. Во-первых, использовать сервисы, которые предоставляют доступ к моделям на собственных условиях и не требуют регистрации в Anthropic. В SpeShu.AI модели собраны в одном окне, а условия доступа определяет сам сервис. Во-вторых, если вам нужен именно API с поиском для собственного приложения, уточните у выбранного провайдера, какие инструменты он поддерживает и на каких условиях, прежде чем строить на нём продукт. Для компаний есть корпоративные аккаунты и API-доступ.

Что проверить у провайдера: есть ли поиск и загрузка страниц, как они тарифицируются, где хранятся данные и что говорят условия об использовании запросов.

Частые вопросы

Чем web search отличается от web fetch?
Поиск находит страницы по запросу, а загрузка открывает конкретный адрес и читает его целиком. Вместе они позволяют найти страницу и изучить её.

Сколько стоит поиск?
$10 за тысячу поисков плюс токены. Ошибочные запросы не оплачиваются. Загрузка страниц отдельно не тарифицируется, платите за токены.

Почему поиск вернул 200, а результата нет?
Ошибки инструмента приходят с кодом 200: ошибка находится в теле результата. Проверяйте поле с ошибкой, а не только статус.

Может ли модель открыть любую ссылку?
Нет, только те, что уже были в разговоре: в вашем сообщении или в результатах поиска и загрузки. Адрес из ответа модели или системного промпта не откроется.

Читает ли загрузка сайты на JavaScript?
Нет. Для страниц, которым нужен настоящий браузер, нужен другой инструмент.

Нужен ли VPN, чтобы пользоваться этими инструментами из России?
Мы не рекомендуем обходить региональные ограничения: это нарушает правила Anthropic. Используйте сервисы, условия которых позволяют работать из вашей страны.

Нужно ли показывать источники пользователям?
Да, если вы показываете ответ поиска как есть, ссылки на источники должны быть видны. Если вы изменяете текст, уточните у юриста, как оформлять ссылки.

Подарок читателям

Забирайте бесплатный гайд по текстовым задачам: в нём разобрано, как строить запросы, которые дают точный результат. Больше 100 готовых промптов и гайдов для новичков и профи лежат в нашем телеграм-канале, а обсудить задачи можно в комьюнити, где уже почти 20 000 участников.