URLpipe について
URLpipe は、JavaScript の実行後に公開ウェブページを調べたいエージェント向けの、ホスト型ブラウザーレンダリングサービスです。MCP ツールでレンダリング済みコンテンツ、画面キャプチャ、メタデータ、抽出結果、診断情報を取得できます。
主な機能
- 01Chrome でページをレンダリング
- 02Markdown または HTML でページ内容を返却
- 03スクリーンショットと PDF の取得
- 04メタデータとサイト技術の確認
- 05指定スキーマに沿ったデータ抽出
- 06Lighthouse 実行とコンソールエラー収集
活用シーン
- 01JavaScript で構築されたページの閲覧
- 02目視確認用のページキャプチャ
- 03ウェブページから指定フィールドを抽出
- 04ページ性能とコンソール問題の確認
MCP 対応
`https://urlpipe.dev/mcp` でホスト型 Streamable HTTP MCP サーバーを提供します。MCP クライアントはページ取得・分析ツール、プロンプト、料金リソースを利用でき、アクセスは bearer token で制御されます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://urlpipe.dev/mcpclaude mcp add --transport http dev-urlpipe https://urlpipe.dev/mcp{"mcpServers":{"dev-urlpipe":{"type":"http","url":"https://urlpipe.dev/mcp"}}}Cursor で開く{"servers":{"dev-urlpipe":{"type":"http","url":"https://urlpipe.dev/mcp"}}}VS Code で開く{"mcpServers":{"dev-urlpipe":{"type":"http","url":"https://urlpipe.dev/mcp"}}}{"mcpServers":{"dev-urlpipe":{"serverUrl":"https://urlpipe.dev/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
https://urlpipe.dev/mcp認証が必要ツール
17このツールにパラメーターはありません。
詳細
URLpipe MCP サーバー
ページの JavaScript を実行してから読み込むブラウザーを、エージェントに提供します。
ウェブサイト ·
ドキュメント ·
料金
通常の fetch ツールは HTTP GET を実行します。ブラウザー上でページを生成するサイト、
つまり React、Vue、多くのドキュメントサイトやダッシュボードでは、
空の枠しか返されません。その結果、エージェントはページを読めないと言うか、
ページに何があったのかを推測することになります。
URLpipe はまずすべてのページを実際の Chrome で読み込み、エージェントが求めたものを渡します。 Markdown 形式のページ、確認できるスクリーンショット、PDF、メタデータ、定義したスキーマに 基づくデータ、コンソールエラー、Lighthouse の監査結果を取得できます。
- ホステッド。
https://urlpipe.dev/mcpで Streamable HTTP を利用できます。インストールや実行は不要です。 - ベアラートークンは 1 つ。 読み取り専用にしたり、1 つのプロジェクトに限定したり、有効期限を設定したりできます。
- 17 個のツール。 すべての API 操作に加え、結果、リクエスト履歴、プロジェクト、使用状況を利用できます。
- HTTP API と同じクレジット。 毎月 1,000 クレジットを無料で利用でき、カード登録も不要です。キャッシュ済みの結果は無料です。
- EU で処理。 取得、レンダリング、保存はすべてヨーロッパで行われます。
このリポジトリには、サーバーのレジストリー登録情報(server.json)と
各クライアントのセットアップ手順が含まれています。サーバー本体は urlpipe.dev で稼働しています。
トークンを取得する
- 登録し、メールアドレスを確認します。
- ダッシュボードで Organization → MCP access を開き、トークンを作成します。通常どおり動作するエージェントには Fetch pages and read results を選び、クレジットを決して消費させたくない場合は Read past results only を選びます。
- トークンをコピーします。一度しか表示されません。
すべてのクライアントは Authorization: Bearer YOUR_TOKEN として送信します。
クライアントを接続する
Claude Code
claude mcp add --transport http urlpipe https://urlpipe.dev/mcp \
--scope user \
--header "Authorization: Bearer YOUR_TOKEN"
または、.mcp.json を使ってチームと共有し、各自が自分の URLPIPE_TOKEN を設定します。
{
"mcpServers": {
"urlpipe": {
"type": "http",
"url": "https://urlpipe.dev/mcp",
"headers": {
"Authorization": "Bearer ${URLPIPE_TOKEN}"
}
}
}
}
Claude Desktop
組織で Customize → Connectors → Add custom
connector にリクエストヘッダーを設定できる場合は、No sign-in を選んで https://urlpipe.dev/mcp を追加し、
authorization ヘッダーに Bearer YOUR_TOKEN を設定します。それ以外の場合は、
オープンソースの mcp-remote ブリッジを
claude_desktop_config.json で使用します(Node.js が必要です)。
{
"mcpServers": {
"urlpipe": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://urlpipe.dev/mcp",
"--header",
"Authorization:${URLPIPE_AUTH}",
"--transport",
"http-only"
],
"env": {
"URLPIPE_AUTH": "Bearer YOUR_TOKEN"
}
}
}
}
Cursor
~/.cursor/mcp.json、またはプロジェクト内の .cursor/mcp.json を使います。
{
"mcpServers": {
"urlpipe": {
"url": "https://urlpipe.dev/mcp",
"headers": {
"Authorization": "Bearer ${env:URLPIPE_TOKEN}"
}
}
}
}
VS Code
.vscode/mcp.json を使います。VS Code がトークンを一度だけ尋ね、安全に保存します。
{
"inputs": [
{
"type": "promptString",
"id": "urlpipe-token",
"description": "URLpipe MCP token",
"password": true
}
],
"servers": {
"urlpipe": {
"type": "http",
"url": "https://urlpipe.dev/mcp",
"headers": {
"Authorization": "Bearer ${input:urlpipe-token}"
}
}
}
}
Windsurf
mcp_config.json を使います。
{
"mcpServers": {
"urlpipe": {
"serverUrl": "https://urlpipe.dev/mcp",
"headers": {
"Authorization": "Bearer ${env:URLPIPE_TOKEN}"
}
}
}
}
Cline
cline_mcp_settings.json を使います。
{
"mcpServers": {
"urlpipe": {
"type": "streamableHttp",
"url": "https://urlpipe.dev/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
},
"disabled": false,
"autoApprove": ["list_projects", "get_usage", "get_result"]
}
}
}
Zed
settings.json を使います。
{
"context_servers": {
"urlpipe": {
"url": "https://urlpipe.dev/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}
ディレクトリーから
URLpipe は Smithery、
Glama、
cursor.directory(Cursor プラグインとして)、
および公式 MCP Registry に dev.urlpipe/mcp として掲載されています。Smithery では、トークンをそのまま貼り付けてください。
サーバーは Bearer プレフィックスの有無にかかわらず受け付けます。
各クライアントの手順をステップごとに説明したページには、試せる最初のプロンプトとトラブルシューティングも掲載しています。 こちらをご覧ください。
ツール
| ツール | 返される内容 | クレジット |
|---|---|---|
list_projects | トークンでアクセスできるプロジェクトです。最初に実行してください。取得系のツールはすべて project_id を必要とします。 | 0 |
get_usage | プランで許可されている内容、今期の残り利用枠、各操作のコストです。 | 0 |
fetch_markdown | JavaScript の実行後に、ページの主要コンテンツをクリーンな Markdown で返します。ページを読むにはこちらを使ってください。 | 1 |
fetch_html | レンダリング後の DOM を返します。ブラウザーから見える内容であり、シェルの curl が取得する内容とは異なります。 | 1 |
capture_screenshot | ページ全体のスクリーンショットを画像で返し、モデルが確認できます。ビューポート、デバイススケール、ダークモード、セレクターで指定した要素 1 つ、PNG/JPEG/WebP に対応しています。 | 1 |
capture_pdf | Web フォントや遅延読み込み画像を含む、レンダリング後のページ全体を PDF で返します。用紙サイズ、向き、余白、倍率、印刷用または画面表示用のスタイルシートを指定できます。 | 1 |
capture_console_errors | 読み込み中の console.error と console.warn、捕捉されなかった例外、未処理の Promise 拒否を返します。 | 1 |
run_lighthouse_audit | パフォーマンス、アクセシビリティ、ベストプラクティス、SEO、Core Web Vitals を対象とした、本格的な Lighthouse 監査です。 | 2 |
extract_metadata | ページが宣言している Open Graph、Twitter カード、JSON-LD、メタタグなどをすべて返します。すべてのページで同じキーを持つ 1 つのオブジェクトに、タイトル、著者、日付、共有画像、アイコン、フィードなどが含まれます。 | 1 |
detect_technologies | サイトを構成する CMS、フレームワーク、分析ツール、CDN、Web サーバーなどを、それぞれのバージョン、信頼度、判定根拠となったシグナルとともに返します。 | 1 |
extract_keywords | 言語モデルが順位付けした、ページを最もよく表す 5~15 個の用語です。 | 15 |
summarize_page | ページの主要コンテンツを短くまとめた Markdown です。 | 17 |
extract_data | 定義したスキーマに沿ってページからデータを抽出します。フィールド名を指定すると、ページに値がない場合は null を返し、それ以外は指定したキーだけを返します。商品詳細、価格、連絡先データ、項目のリストなどに対応します。 | 24 |
scrape_url | 1 回のページ訪問で、上記の複数の操作を実行します。各操作の料金は通常どおり発生します。 | 合計 |
get_result | トークンを指定して、以前のリクエストの結果を取得します。 | 0 |
list_requests | プロジェクトの最近のリクエストを、新しい順に返します。 | 0 |
get_request | 結果を除く、過去の 1 件のリクエストに関するすべての情報を返します。処理時間、キャッシュ、Webhook の配信状況などが含まれます。 | 0 |
非同期がデフォルトです。 HTTP の場合と同様、取得系のツールはすぐにトークンを返し、get_result で結果を取得します。代わりに sync: true を渡すと、完了まで待機します。
ほとんどのエージェントはツールの説明からこの仕組みを把握しますが、プロンプトで「sync: true を使ってください」と伝えておくと、余分な往復を省けます。
同じリクエストを繰り返しても無料です。 結果は 30 日間保持され、max_age(デフォルトでは 7 日)以内の新しい結果が再利用されます。
プロンプトとリソース
MCP プロンプト(スラッシュコマンドとして表示されることが多い)に対応したクライアントでは、すぐに使えるプロンプトが 3 つ表示されます。
| プロンプト | 引数 | 機能 |
|---|---|---|
read_page | url、question(任意) | ページを Markdown として読み込み、質問に回答するか、ページを要約します。 |
audit_page | url、device(任意:mobile または desktop) | Lighthouse のスコア、Core Web Vitals、コンソールエラーをまとめたヘルスレポートを作成します。 |
compare_pages | url_a、url_b、focus(任意) | 2 つのページを並べて、それぞれの内容と見せ方を比較します。 |
リソース urlpipe://pricing にはプランと各操作の料金が記載されているため、エージェントはクレジットを消費する前に料金を確認できます。
initialize、tools/list、prompts/list、resources/list はトークンなしで応答するため、これらの情報をサーバーから直接確認できます。
curl -s https://urlpipe.dev/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
最初のプロンプト
Using urlpipe with sync: true, read https://news.ycombinator.com as Markdown and list
the five top stories with their links. Then take a screenshot of the first story's page
and tell me what the page looks like.
対応していないこと
URLpipe は一度に 1 つの URL に関する質問に回答します。サイト全体をクロールしたり、URL を検出したり、localhost やプライベートアドレスにアクセスしたりすることはありません。独自のサーバーから公開ページを取得します。デフォルトでは、各サイトの robots.txt に従います。
リンク
- MCP サーバーの概要
- MCP のドキュメント — トークン、スコープ、制限
- HTTP API のドキュメント と OpenAPI 仕様
- 無料ツール — アカウントなしですべての操作をお試しいただけます
- ご質問:[email protected]
MIT ライセンス:このリポジトリ内の設定とドキュメントが対象です。 URLpipe サービスには、利用規約が適用されます。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。