Live Web Data by Teneo Protocol
официальныйУдалённый MCP-сервер и API, которые загружают любую общедоступную веб-страницу в реальном времени в том виде, в каком её видят местные посетители, из выбранной вами страны и возвращают в виде чистого Markdown. Извлечение веб-данных, загрузка страниц и скрейпинг для ИИ-агентов с локальными результатами и оплатой за каждый запрос. livewebdata.com — это Live Web Data API, продукт Teneo Protocol.
Что можно делать с Live Web Data By Teneo Protocol MCP?
- Получение актуального содержимого страницы — Попросите ассистента прочитать любой общедоступный URL и вернуть основное содержимое в виде чистого Markdown, обычного текста или HTML.
- Выбор страны просмотра — Запросите страницу в том виде, в каком она отображается в конкретной стране, например
de,gbилиus, используя код страны ISO-3166 alpha-2. - Управление размером и охватом вывода — Установите
max_charactersв диапазоне от 500 до 100 000 и выберите компактное основное содержимое или полный текст страницы. - Проверка состояния аккаунта — Попросите ассистента проверить остаток кредитов, тарифный план и ограничение частоты запросов перед запуском больших пакетов; этот вызов бесплатный.
- Обработка ошибок получения данных — Получайте полезные сообщения об ошибках для сайтов с ограниченным доступом, отсутствующих страниц, тайм-аутов, ограничений частоты запросов и недостатка кредитов.
Размещённый MCP-сервер
npx add-mcp 'https://livewebdata.com/mcp'Устанавливается в Claude Code, Codex, Cursor и другие
Документация
Используйте Live Web Data API как инструмент в Claude, Cursor, VS Code и любом другом MCP-клиенте — с одним URL и вашим существующим API-ключом.
Что такое MCP
Model Context Protocol (MCP) — это открытый стандарт, который позволяет ИИ-агентам находить внешние инструменты и вызывать их. Наш MCP-сервер предоставляет Contents API в виде двух инструментов, поэтому агент может самостоятельно читать любые общедоступные веб-страницы.
Сервер и аутентификация
| Значение | |
|---|---|
| URL сервера | https://livewebdata.com/mcp |
| Транспорт | Streamable HTTP (без сохранения состояния): JSON-RPC через POST; GET и DELETE отвечают 405 |
| Аутентификация | Authorization: Bearer <api_key> |
| Ключи | Те же ключи, что и для REST API — создайте ключ на странице API keys |
Отсутствующие или недействительные ключи отклоняются с HTTP 401 (для приостановленных аккаунтов — 403, «Доступ к API для этого аккаунта приостановлен. Обратитесь в службу поддержки.») до запуска любого инструмента.
Настройка клиента
Замените YOUR_KEY своим API-ключом. На странице Integrations в панели управления ключ подставляется автоматически.
Выполните эту команду в терминале. После этого сервер будет доступен во всех сеансах Claude Code для этого проекта.
claude mcp add --transport http live-web-data https://livewebdata.com/mcp \
--header "Authorization: Bearer YOUR_KEY"
Добавьте --scope user, чтобы сервер был доступен во всех проектах. Проверьте с помощью claude mcp list.
get_page_contents
Загрузите общедоступную веб-страницу в реальном времени и получите её основное содержимое в формате чистого Markdown, обычного текста или HTML. Только чтение, идемпотентный вызов. Один URL за вызов.
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
url | string (http/https, не более 8,192 символов) | обязательно | Общедоступный URL для загрузки. |
country | ISO-3166 alpha-2 | "us" | Загрузить страницу так, как она отображается в этой стране, например 'de', 'gb', 'us'. |
format | "markdown" | "text" | "html" | "markdown" | Формат вывода. Предпочтителен markdown. HTML страницы загружается и возвращается только для "html". |
max_characters | integer 500–100000 | 8000 | Максимальное количество символов содержимого в ответе. Значение меньше, чем по умолчанию в REST API (text.maxCharacters, 100,000), поскольку результат помещается в контекст агента; увеличьте его, если содержимое обрезано. |
verbosity | "compact" | "full" | "compact" | compact = только основное содержимое, full = всё тело страницы. |
Результат — один текстовый элемент с кратким заголовком, за которым следует содержимое. Полный JSON в стиле REST также возвращается как structuredContent (с results[].html только для format: "html").
# Web scraping - Wikipedia
Source: https://en.wikipedia.org/wiki/Web_scraping · country: us · live · credits used: 1 · credits left: 8,411
# Web scraping - Wikipedia
…
get_account_status
Проверьте остаток кредитов, тарифный план и ограничение частоты запросов для подключённого аккаунта. Перед большими пакетами запросов агентам следует вызывать этот инструмент. Параметров нет, вызов бесплатный. Возвращает те же значения, что и GET /v1/account.
Plan: Starter · Credits left: 8,412 · Rate limit: 2 URL/s (burst 4) · Status: active
Ошибки
Ошибки возвращаются с isError: true и одним предложением с рекомендацией, которой агент может следовать. Если списания не было, сообщение заканчивается фразой «Кредиты не списаны».
| Случай | Сообщение для агента |
|---|---|
| 451 — ограниченный ресурс | Этот сайт ограничен, и его нельзя загрузить. Не повторяйте запрос; используйте другой источник. |
CRAWL_NOT_RENDERED | На странице нет доступного текста: для неё требуется рендеринг JavaScript или на ней нет текста даже после рендеринга. Попробуйте другой источник или другой URL с той же информацией. |
CRAWL_NOT_FOUND | Страница не найдена (404/410). |
SOURCE_NOT_AVAILABLE | Сайт отклонил этот запрос. Используйте другой источник. |
SOURCE_BLOCKED | Сайт запретил доступ. Используйте другой источник. |
CRAWL_LIVECRAWL_TIMEOUT | Время ожидания загрузки страницы истекло. Повторите запрос один раз с увеличенным тайм-аутом, иначе используйте другой источник. |
BROWSER_UNAVAILABLE | Рендеринг в браузере временно недоступен. Повторите попытку через несколько минут, иначе используйте другой источник. |
RATE_LIMITED | Достигнут лимит рендеринга для тарифного плана пользователя. Не повторяйте рендеринг сейчас; используйте другой источник. |
| 402 — недостаточно кредитов | На аккаунте закончились кредиты. Попросите пользователя пополнить баланс на …/dashboard/billing. |
| 429 — превышено ограничение частоты запросов | Достигнуто ограничение частоты запросов. Подождите N секунд перед повторной попыткой. |
| 401 / 403 | API-ключ недействителен или приостановлен. Попросите пользователя проверить ключ на странице …/dashboard/keys. |
| Загрузка продолжается более 5 минут | Страница не загрузилась за 5 минут, и за загрузку всё ещё может быть списана плата. Используйте другой источник. |
Кредиты
Вызовы MCP тарифицируются точно так же, как вызовы REST: 1 кредит за успешно загруженную страницу; неудачные запросы (включая отказ сайта в доступе) бесплатны. Они отображаются в разделе Usage с каналом mcp. См. Credits.