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ページを自律的に読み取れます。
サーバーと認証
| 値 | |
|---|---|
| サーバー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アクセスは停止されています。サポートにお問い合わせください。」)。
クライアントの設定
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つです。
| パラメーター | 型 | デフォルト | 説明 |
|---|---|---|---|
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 | 整数 500~100000 | 8000 | 返すコンテンツの最大文字数。結果はエージェントのコンテキストに入るため、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_AVAILABLE | Webサイトがこのリクエストを拒否しました。別の情報源を使用してください。 |
SOURCE_BLOCKED | Webサイトによってアクセスが拒否されました。別の情報源を使用してください。 |
CRAWL_LIVECRAWL_TIMEOUT | ページがタイムアウトしました。タイムアウトを長くして1回だけ再試行し、それでも失敗する場合は別の情報源を使用してください。 |
BROWSER_UNAVAILABLE | ブラウザーのレンダリングを一時的に利用できません。数分後に再試行し、それでも失敗する場合は別の情報源を使用してください。 |
RATE_LIMITED | ユーザーのプランで利用できるレンダリング上限に達しました。今はレンダリングを再試行せず、別の情報源を使用してください。 |
| 402 クレジット不足 | アカウントのクレジットが不足しています。…/dashboard/billingでチャージするようユーザーに伝えてください。 |
| 429 レート制限 | レート制限に達しました。N秒待ってから再試行してください。 |
| 401 / 403 | APIキーが無効か、停止されています。…/dashboard/keysでキーを確認するようユーザーに伝えてください。 |
| 取得開始から5分経過しても処理中 | ページの読み込みが5分以内に完了せず、取得が課金される可能性があります。別の情報源を使用してください。 |
クレジット
MCPの呼び出しはRESTの呼び出しと同じ料金体系です。ページの取得に成功すると1クレジットが課金され、失敗したリクエスト(サイトによるアクセス拒否を含む)は無料です。Usageにはチャネルmcpとして表示されます。Creditsをご覧ください。