Live Web Data by Teneo Protocol

npx add-mcp 'https://livewebdata.com/mcp'

Sử dụng Live Web Data API làm công cụ trong Claude, Cursor, VS Code và mọi MCP client khác — chỉ với một URL và API key hiện có của bạn.

MCP là gì

Model Context Protocol (MCP) là một tiêu chuẩn mở cho phép các tác nhân AI khám phá và gọi các công cụ bên ngoài. MCP server của chúng tôi cung cấp Contents API dưới dạng hai công cụ, để tác nhân có thể tự đọc bất kỳ trang web công khai nào.

Server và xác thực

	Giá trị
Server URL	https://livewebdata.com/mcp
Transport	Streamable HTTP (stateless): JSON-RPC qua POST; GET và DELETE trả lời 405
Xác thực	Authorization: Bearer <api_key>
Keys	Dùng cùng keys như REST API — tạo một key trong API keys

Keys bị thiếu hoặc không hợp lệ sẽ bị từ chối với HTTP 401 (tài khoản bị đình chỉ: 403, "API access for this account is suspended. Contact support.") trước khi bất kỳ công cụ nào chạy.

Thiết lập client

Thay YOUR_KEY bằng API key của bạn. Trên dashboard, trang Integrations sẽ tự điền key cho bạn.

Chạy lệnh này trong terminal. Sau đó, server sẽ khả dụng trong mọi phiên Claude Code của dự án này.

claude mcp add --transport http live-web-data https://livewebdata.com/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Thêm --scope user để dùng server trong tất cả dự án. Kiểm tra bằng claude mcp list.

get_page_contents

Tải trực tiếp một trang web công khai và trả về nội dung chính dưới dạng Markdown gọn gàng, văn bản thuần hoặc HTML. Chỉ đọc, có tính lặp lại an toàn. Mỗi lần gọi một URL.

Tham số	Kiểu	Mặc định	Mô tả
url	string (http/https, tối đa 8,192 ký tự)	bắt buộc	URL công khai cần tải.
country	ISO-3166 alpha-2	"us"	Tải trang theo cách hiển thị tại quốc gia này, ví dụ 'de', 'gb', 'us'.
format	"markdown" | "text" | "html"	"markdown"	Định dạng đầu ra. Nên dùng markdown. HTML của trang chỉ được tải và trả về khi dùng "html".
max_characters	integer 500–100000	8000	Số ký tự nội dung tối đa được trả về. Mức này thấp hơn mặc định của REST API (text.maxCharacters, 100,000) vì kết quả được đưa vào ngữ cảnh của tác nhân; hãy tăng giới hạn nếu nội dung bị cắt.
verbosity	"compact" | "full"	"compact"	compact = chỉ nội dung chính, full = toàn bộ phần thân trang.

Kết quả gồm một mục văn bản với phần đầu ngắn, theo sau là nội dung. JSON đầy đủ theo kiểu REST cũng được trả về dưới dạng structuredContent (chỉ kèm results[].html khi dùng 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

Kiểm tra số credit còn lại, gói dịch vụ và giới hạn tốc độ của tài khoản được kết nối. Tác nhân nên gọi công cụ này trước khi xử lý các lô lớn. Không có tham số, miễn phí. Trả về các số liệu giống như GET /v1/account.

Plan: Starter · Credits left: 8,412 · Rate limit: 2 URL/s (burst 4) · Status: active

Lỗi

Lỗi được trả về cùng với isError: true và một câu hướng dẫn hành động mà tác nhân có thể làm theo. Nếu không bị tính phí, thông báo sẽ kết thúc bằng “No credits were charged.”

Trường hợp	Thông báo gửi cho tác nhân
451 restricted target	Trang web này bị hạn chế và không thể truy xuất. Đừng thử lại; hãy dùng nguồn khác.
CRAWL_NOT_RENDERED	Trang không có văn bản có thể sử dụng: trang cần được kết xuất bằng JavaScript hoặc không hiển thị văn bản ngay cả sau khi kết xuất. Hãy thử nguồn khác hoặc URL khác chứa cùng thông tin.
CRAWL_NOT_FOUND	Không tìm thấy trang (404/410).
SOURCE_NOT_AVAILABLE	Trang web đã từ chối yêu cầu này. Hãy dùng nguồn khác.
SOURCE_BLOCKED	Trang web đã từ chối quyền truy cập. Hãy dùng nguồn khác.
CRAWL_LIVECRAWL_TIMEOUT	Đã hết thời gian chờ tải trang. Thử lại một lần với thời gian chờ dài hơn; nếu không, hãy dùng nguồn khác.
BROWSER_UNAVAILABLE	Tính năng kết xuất bằng trình duyệt tạm thời không khả dụng. Hãy thử lại sau vài phút; nếu không, hãy dùng nguồn khác.
RATE_LIMITED	Đã đạt giới hạn kết xuất của gói dịch vụ người dùng. Đừng thử kết xuất lại lúc này; hãy dùng nguồn khác.
402 insufficient credits	Tài khoản đã hết credit. Hãy yêu cầu người dùng nạp thêm tại …/dashboard/billing.
429 rate limited	Đã đạt giới hạn tốc độ. Chờ N giây rồi thử lại.
401 / 403	API key không hợp lệ hoặc đã bị đình chỉ. Hãy yêu cầu người dùng kiểm tra key tại …/dashboard/keys.
Vẫn đang tải sau 5 phút	Trang chưa tải xong trong vòng 5 phút và yêu cầu tải có thể vẫn bị tính phí. Hãy dùng nguồn khác.

Credit

Các lệnh gọi MCP được tính phí giống hệt các lệnh gọi REST: 1 credit cho mỗi trang tải thành công; các yêu cầu thất bại (bao gồm cả trường hợp trang web từ chối truy cập) đều miễn phí. Chúng xuất hiện trong Usage với channel mcp. Xem Credits.