URLpipe

URLpipe MCP 服务

让你的 Agent 使用能先运行网页 JavaScript 再读取内容的浏览器。
网站 · 文档 · 定价

---

普通的 fetch 工具会执行 HTTP GET。在浏览器中构建页面的网站上—— React、Vue，以及大多数文档网站和仪表盘——它会返回一个空壳；Agent 要么说自己无法读取页面，要么猜测页面内容。

URLpipe 会先在真正的 Chrome 中加载每个页面，然后将 Agent 请求的内容交给它：页面的 Markdown、可供查看的截图、PDF、元数据、符合你定义架构的数据、控制台错误或 Lighthouse 审计结果。

• 托管服务。 通过 https://urlpipe.dev/mcp 提供 Streamable HTTP。无需安装或运行任何东西。
• 一个 Bearer 令牌。 可设为只读、限定为单个项目，或设置过期时间。
• 17 个工具。 涵盖每项 API 操作，以及结果、请求历史、项目和用量。
• 与 HTTP API 使用相同的点数。 每月免费 1,000 点，无需信用卡。缓存结果不收费。
• 在欧盟处理。 获取、渲染和存储均在欧洲进行。

此仓库包含该服务的注册信息（server.json）以及各客户端的配置。服务本身运行于 urlpipe.dev。

获取令牌

1. 注册并确认你的电子邮件地址。
2. 在控制面板中，打开 Organization → MCP access 并创建令牌。对于正常工作的 Agent，选择 Fetch pages and read results；对于必须绝不消耗点数的 Agent，选择 Read past results only。
3. 复制令牌——它只会显示一次。

每个客户端都会将令牌作为 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 中设置请求头，请添加 https://urlpipe.dev/mcp，选择 No sign-in，并将 authorization 请求头设为 Bearer YOUR_TOKEN。否则，可在 claude_desktop_config.json 中使用开源 mcp-remote 桥接工具（需要 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 注册表，名称为 dev.urlpipe/mcp。在 Smithery 上，直接粘贴令牌即可——服务接受带或不带 Bearer 前缀的令牌。

各客户端的分步指南、可尝试的首个提示词以及故障排查说明，请访问 urlpipe.dev/integrations。

工具

工具	返回内容	积分
list_projects	令牌可访问的项目。从这里开始：每个抓取工具都需要 project_id。	0
get_usage	套餐允许的操作、本周期剩余额度，以及每项操作的费用。	0
fetch_markdown	页面运行完 JavaScript 后的主要内容，格式简洁，为 Markdown。阅读页面时使用此工具。	1
fetch_html	渲染后的 DOM——浏览器看到的内容，而不是 shell 的 curl 获取到的内容。	1
capture_screenshot	整页截图，以模型可查看的图像形式返回。支持视口、设备缩放比例、深色模式、按选择器截取单个元素，以及 PNG/JPEG/WebP 格式。	1
capture_pdf	整个渲染后的页面转为 PDF，包含网页字体和延迟加载的图片。支持纸张大小、方向、页边距、缩放比例，以及打印或屏幕样式表。	1
capture_console_errors	加载期间的 console.error 和 console.warn、未捕获的异常以及未处理的 Promise 拒绝。	1
run_lighthouse_audit	真正的 Lighthouse 审计：性能、无障碍、最佳实践、SEO 和 Core Web Vitals。	2
extract_metadata	页面声明的所有元数据——Open Graph、Twitter 卡片、JSON-LD、meta 标签等，汇总在一个对象中；每个页面使用相同的键：标题、作者、日期、分享图片、图标、订阅源等。	1
detect_technologies	网站使用的技术——CMS、框架、分析工具、CDN、Web 服务器等，并提供各项技术的版本、置信度和判定依据。	1
extract_keywords	由语言模型评估并排序的 5–15 个最能代表页面的词语。	15
summarize_page	页面主要内容的简短 Markdown 摘要。	17
extract_data	按你定义的架构从页面提取数据：指定字段名后，恰好返回这些键；页面未提供值时则返回 null。适用于产品详情、价格、联系信息和项目列表。	24
scrape_url	一次访问页面即可执行上述多项操作。每项操作照常计费。	总和
get_result	根据令牌获取先前请求的结果。	0
list_requests	项目最近的请求，按时间从新到旧排列。	0
get_request	获取某个历史请求的所有信息，但不包括结果：耗时、缓存和 Webhook 传递情况。	0

**默认采用异步模式，**与 HTTP 一样：抓取工具会立即返回令牌，之后由 get_result 获取结果。也可以传入 sync: true 等待结果。大多数 Agent 会根据工具说明自行理解这一点；在提示词中注明“使用 sync: true”可以省去一次往返。

**重复请求免费。**结果会保留 30 天；只要结果的时效未超过 max_age（默认 7 天），就会重复使用。

提示词和资源

能够显示 MCP 提示词（通常显示为斜杠命令）的客户端会提供三个可直接使用的提示词：

提示词	参数	功能
read_page	url、question（可选）	以 Markdown 格式读取页面并回答问题，或总结页面。
audit_page	url、device（可选：mobile 或 desktop）	健康报告：Lighthouse 评分、Core Web Vitals 和控制台错误。
compare_pages	url_a、url_b、focus（可选）	并排对比两个页面：各自表达的内容及呈现方式。

资源 urlpipe://pricing 包含各套餐及每项操作的费用，Agent 可在使用积分前查询价格。

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 一次只回答有关一个 URL 的问题。它不会抓取整个网站、发现 URL，也无法访问 localhost 和私有地址——它从自己的服务抓取公开页面。默认情况下，它会遵循各网站的 robots.txt。

链接

• MCP 服务概览
• MCP 文档 — 令牌、作用域、限制
• HTTP API 文档 和 OpenAPI 规范
• 免费工具 — 无需账户即可试用所有操作
• 有疑问请联系：[email protected]

本仓库中的配置和文档采用 MIT 许可证。 URLpipe 服务受其条款约束。