Live Web Data by Teneo Protocol

公式

選択した国のローカルユーザーと同じように、あらゆる公開ウェブページをリアルタイムで取得し、クリーンなMarkdownで返すリモートMCPサーバーおよびAPI。AIエージェント向けのウェブデータ抽出、取得、スクレイピングに対応し、リクエストごとに現地の検索結果や価格を取得できます。livewebdata.comは、Teneo Protocolの製品であるLive Web Data APIです。

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をツールとして使用できます。必要なのは1つのURLと、お持ちのAPIキーだけです。

MCPとは

Model Context Protocol(MCP)は、AIエージェントが外部ツールを検出して呼び出せるようにするオープン標準です。当社のMCPサーバーはContents APIを2つのツールとして公開しているため、エージェントは任意の公開Webページを自律的に読み取れます。

サーバーと認証

値
サーバーURLhttps://livewebdata.com/mcp
トランスポートStreamable HTTP(ステートレス):POST経由のJSON-RPC。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

公開Webページをリアルタイムで取得し、主要なコンテンツをクリーンなMarkdown、プレーンテキスト、またはHTMLで返します。読み取り専用で、冪等です。1回の呼び出しにつきURLは1つです。

パラメーター型デフォルト説明
urlstring(http/https、最大8,192文字)必須取得する公開URL。
countryISO-3166 alpha-2"us"この国から見たページを取得します。例:'de'、'gb'、'us'。
format"markdown" | "text" | "html""markdown"出力形式。markdownを推奨します。ページのHTMLが取得されて返されるのは"html"の場合のみです。
max_characters整数 500~1000008000返すコンテンツの最大文字数。結果はエージェントのコンテキストに入るため、REST APIのデフォルト(text.maxCharacters、100,000)より小さく設定されています。コンテンツが途中で切れている場合は値を大きくしてください。
verbosity"compact" | "full""compact"compact = 主要なコンテンツのみ、full = ページ本文全体。

結果は、短いヘッダーに続いてコンテンツが表示される1つのテキスト項目です。REST形式の完全なJSONも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と、エージェントが実行できる具体的な対処を示す1文で返されます。課金されなかった場合、メッセージの末尾に「クレジットは消費されていません。」と表示されます。

ケースエージェントへのメッセージ
451 制限対象このWebサイトは制限されているため取得できません。再試行せず、別の情報源を使用してください。
CRAWL_NOT_RENDEREDページに利用可能なテキストがありません。JavaScriptのレンダリングが必要か、レンダリング後もテキストが表示されません。別の情報源を試すか、同じ情報が得られる別のURLを使用してください。
CRAWL_NOT_FOUNDページが見つかりません(404/410)。
SOURCE_NOT_AVAILABLEWebサイトがこのリクエストを拒否しました。別の情報源を使用してください。
SOURCE_BLOCKEDWebサイトによってアクセスが拒否されました。別の情報源を使用してください。
CRAWL_LIVECRAWL_TIMEOUTページがタイムアウトしました。タイムアウトを長くして1回だけ再試行し、それでも失敗する場合は別の情報源を使用してください。
BROWSER_UNAVAILABLEブラウザーのレンダリングを一時的に利用できません。数分後に再試行し、それでも失敗する場合は別の情報源を使用してください。
RATE_LIMITEDユーザーのプランで利用できるレンダリング上限に達しました。今はレンダリングを再試行せず、別の情報源を使用してください。
402 クレジット不足アカウントのクレジットが不足しています。…/dashboard/billingでチャージするようユーザーに伝えてください。
429 レート制限レート制限に達しました。N秒待ってから再試行してください。
401 / 403APIキーが無効か、停止されています。…/dashboard/keysでキーを確認するようユーザーに伝えてください。
取得開始から5分経過しても処理中ページの読み込みが5分以内に完了せず、取得が課金される可能性があります。別の情報源を使用してください。

クレジット

MCPの呼び出しはRESTの呼び出しと同じ料金体系です。ページの取得に成功すると1クレジットが課金され、失敗したリクエスト(サイトによるアクセス拒否を含む)は無料です。Usageにはチャネルmcpとして表示されます。Creditsをご覧ください。