Live Web Data by Teneo Protocol

官方

远程 MCP 服务器和 API，可从您选择的国家/地区实时抓取任意公开网页，呈现当地访客所见的内容，并以整洁的 Markdown 格式返回。为 AI 智能体提供网页数据提取、抓取和采集服务，返回当地结果，并按请求计费。livewebdata.com 是 Live Web Data API，由 Teneo Protocol 推出。

访问 livewebdata.com

你可以用 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 等客户端

文档

在 Claude、Cursor、VS Code 和任何其他 MCP 客户端中，将 Live Web Data API 用作工具——只需一个 URL 和你现有的 API 密钥。

什么是 MCP

模型上下文协议（MCP）是一种开放标准，可让 AI 代理发现并调用外部工具。我们的 MCP 服务器将 Contents API 作为两个工具公开，因此代理可以自行读取任何公开网页。

服务器与身份验证

	值
服务器 URL	`https://livewebdata.com/mcp`
传输方式	Streamable HTTP（无状态）：通过 `POST` 传输 JSON-RPC；`GET` 和 `DELETE` 返回 `405`
身份验证	`Authorization: Bearer <api_key>`
密钥	与 REST API 使用相同的密钥——在 API keys 下创建

缺失或无效的密钥会在任何工具运行前被拒绝，并返回 HTTP 401（账户已暂停时返回 403，"API access for this account is suspended. Contact support."）。

客户端设置

将 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 = 整个页面正文。

结果包含一个简短标题，后接内容，作为一个文本项返回。完整的 REST 风格 JSON 也会作为 structuredContent 返回（仅当 format: "html" 时才包含 results[].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 返回，并附带一句代理可据此采取行动的说明。如果未扣除任何费用，消息会以“No credits were charged.”结尾。

情况	给代理的消息
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。