Live Web Data by Teneo Protocol

resmi

Seçtiğiniz ülkedeki yerel ziyaretçilerin gördüğü şekilde, herkese açık herhangi bir web sayfasını canlı olarak temiz Markdown biçiminde getiren uzak MCP sunucusu ve API. Yapay zekâ ajanları için web verisi çıkarma, getirme ve kazıma; yerel sonuçlar ve istek başına fiyatlandırma sunar. livewebdata.com, Teneo Protocol tarafından sunulan Live Web Data API’dir.

livewebdata.com üzerinde görüntüle

Live Web Data By Teneo Protocol MCP ile neler yapabilirsiniz?

Canlı sayfa içeriğini alın — Asistanınızdan herhangi bir herkese açık URL'yi okumasını ve ana içeriğini temiz Markdown, düz metin veya HTML olarak döndürmesini isteyin.
Görüntüleme ülkesini seçin — ISO-3166 alfa-2 kodunu kullanarak bir sayfanın belirli bir ülkeden, örneğin de, gb veya us kodlarıyla, nasıl göründüğünü isteyin.
Çıktı boyutunu ve kapsamını kontrol edin — max_characters değerini 500 ile 100.000 arasında ayarlayın ve kısa ana içeriği ya da sayfanın tüm gövdesini seçin.
Hesap durumunu kontrol edin — Büyük grupları çalıştırmadan önce asistandan kalan kredileri, planı ve hız sınırını kontrol etmesini isteyin; bu çağrı ücretsizdir.
Alma hatalarını yönetin — Kısıtlı siteler, bulunamayan sayfalar, zaman aşımları, hız sınırları ve yetersiz krediler için uygulanabilir hata mesajları alın.

Barındırılan MCP Sunucusu

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

Claude Code, Codex, Cursor ve daha fazlasına kurulur

Dokümantasyon

Claude, Cursor, VS Code ve diğer tüm MCP istemcilerinde Live Web Data API’yi bir araç olarak kullanın — tek bir URL ve mevcut API anahtarınızla.

MCP nedir

Model Context Protocol (MCP), yapay zekâ ajanlarının harici araçları keşfetmesini ve çağırmasını sağlayan açık bir standarttır. MCP sunucumuz, Contents API’yi iki araç olarak sunar; böylece bir ajan herkese açık herhangi bir web sayfasını kendi başına okuyabilir.

Sunucu ve kimlik doğrulama

	Değer
Sunucu URL’si	`https://livewebdata.com/mcp`
Aktarım	Streamable HTTP (durumsuz): `POST` üzerinden JSON-RPC; `GET` ve `DELETE`, `405` yanıtını verir
Kimlik doğrulama	`Authorization: Bearer <api_key>`
Anahtarlar	REST API ile aynı anahtarlar — API keys altında bir tane oluşturun

Eksik veya geçersiz anahtarlar, herhangi bir araç çalıştırılmadan önce HTTP 401 ile reddedilir (askıya alınmış hesaplar: 403, "API access for this account is suspended. Contact support.").

İstemci kurulumu

YOUR_KEY yerine API anahtarınızı yazın. Kontrol panelindeki Integrations sayfası anahtarınızı sizin için doldurur.

Bunu terminalinizde çalıştırın. Sunucu artık bu projedeki tüm Claude Code oturumlarında kullanılabilir.

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

Tüm projelerde kullanılabilir olması için --scope user ekleyin. claude mcp list ile kontrol edin.

get_page_contents

Herkese açık bir web sayfasını canlı olarak getirir ve ana içeriğini temiz Markdown, düz metin veya HTML olarak döndürür. Salt okunur, idempotent. Her çağrıda tek URL.

Parametre	Tür	Varsayılan	Açıklama
`url`	string (http/https, en fazla 8,192 karakter)	zorunlu	Getirilecek herkese açık URL.
`country`	ISO-3166 alpha-2	`"us"`	Sayfayı bu ülkeden görüntülendiği şekilde getirir; ör. 'de', 'gb', 'us'.
`format`	`"markdown"` \| `"text"` \| `"html"`	`"markdown"`	Çıktı biçimi. Markdown tercih edilir. Sayfanın HTML’i yalnızca `"html"` için getirilir ve döndürülür.
`max_characters`	integer 500–100000	`8000`	Döndürülecek içeriğin en fazla karakter sayısı. Sonuç ajanın bağlamına eklendiğinden, REST API’nin varsayılan değerinden (`text.maxCharacters`, 100,000) daha küçüktür; içerik kesilirse bu değeri artırın.
`verbosity`	`"compact"` \| `"full"`	`"compact"`	compact = yalnızca ana içerik, full = sayfanın tüm gövdesi.

Sonuç, kısa bir başlıkla başlayan ve ardından içeriğin geldiği tek bir metin öğesidir. REST biçemindeki tam JSON da structuredContent olarak döndürülür (results[].html yalnızca format: "html" için).

# 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

Bağlı hesabın kalan kredilerini, planını ve hız sınırını kontrol eder. Ajanlar büyük gruplar hâlinde işlem yapmadan önce bu aracı çağırmalıdır. Parametre almaz, ücretsizdir. GET /v1/account ile aynı değerleri döndürür.

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

Hatalar

Hatalar, isError: true ve ajanın uygulayabileceği tek bir eyleme dönük cümleyle döndürülür. Ücret alınmadığında mesaj “No credits were charged.” ifadesiyle biter.

Durum	Ajan için mesaj
451 kısıtlı hedef	Bu web sitesi kısıtlı ve getirilemiyor. Yeniden denemeyin; başka bir kaynak kullanın.
`CRAWL_NOT_RENDERED`	Sayfada kullanılabilir metin yok: JavaScript ile işlenmesi gerekiyor veya işlendiğinde bile metin göstermiyor. Başka bir kaynak ya da aynı bilgi için farklı bir URL deneyin.
`CRAWL_NOT_FOUND`	Sayfa bulunamadı (404/410).
`SOURCE_NOT_AVAILABLE`	Web sitesi bu isteği reddetti. Başka bir kaynak kullanın.
`SOURCE_BLOCKED`	Web sitesi erişimi reddetti. Başka bir kaynak kullanın.
`CRAWL_LIVECRAWL_TIMEOUT`	Sayfanın yüklenmesi zaman aşımına uğradı. Daha uzun bir zaman aşımıyla bir kez yeniden deneyin; aksi takdirde başka bir kaynak kullanın.
`BROWSER_UNAVAILABLE`	Tarayıcıyla işleme geçici olarak kullanılamıyor. Birkaç dakika sonra yeniden deneyin; aksi takdirde başka bir kaynak kullanın.
`RATE_LIMITED`	Kullanıcının planındaki işleme sınırına ulaşıldı. Şimdi yeniden işleme denemeyin; başka bir kaynak kullanın.
402 yetersiz kredi	Hesabın kredisi tükendi. Kullanıcıya …/dashboard/billing adresinden kredi yüklemesini söyleyin.
429 hız sınırı aşıldı	Hız sınırına ulaşıldı. Yeniden denemeden önce N saniye bekleyin.
401 / 403	API anahtarı geçersiz veya askıya alınmış. Kullanıcıya anahtarını …/dashboard/keys adresinden kontrol etmesini söyleyin.
5 dakika sonra hâlâ getiriliyor	Sayfanın yüklenmesi 5 dakika içinde tamamlanmadı ve getirme işlemi yine de ücretlendirilebilir. Başka bir kaynak kullanın.

Krediler

MCP çağrıları, REST çağrılarıyla tamamen aynı şekilde ücretlendirilir: başarılı sayfa başına 1 kredi; başarısız istekler (site tarafından erişimin reddedilmesi dâhil) ücretsizdir. Kullanım bölümünde mcp kanalıyla görünürler. Credits bölümüne bakın.