SmartFetch

Name: SmartFetch
Author: Friezaaaa

远程服务

github.com/Friezaaaa浏览器自动化03 周前更新

代码仓库

关于 SmartFetch

SmartFetch 1.11.1 是网页抓取服务的紧急故障关闭版本。抓取和浏览器渲染不可用；MCP 工具仍可发现，但调用会返回错误，同时健康检查和信息路由保持免费可用。

主要功能

01紧急模式下停用抓取
02停用浏览器渲染
03四个 MCP 工具标记为不可用
04免费健康检查与信息路由
05不可用操作返回有限错误

适用场景

01检查服务是否存活
02查看 MCP 工具可用状态
03验证紧急模式下的 API 行为

MCP 相关

MCP 初始化和工具发现仍可用。列出的四个工具——`fetch_webpage`、`webpage_to_markdown`、`extract_webpage_text` 和 `render_webpage`——均标记为不可用，调用时会返回错误。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://smartfetch-production-ea53.up.railway.app/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http friezaaaa-smartfetch https://smartfetch-production-ea53.up.railway.app/mcp

Cursor.cursor/mcp.json{"mcpServers":{"friezaaaa-smartfetch":{"type":"http","url":"https://smartfetch-production-ea53.up.railway.app/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"friezaaaa-smartfetch":{"type":"http","url":"https://smartfetch-production-ea53.up.railway.app/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"friezaaaa-smartfetch":{"type":"http","url":"https://smartfetch-production-ea53.up.railway.app/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"friezaaaa-smartfetch":{"serverUrl":"https://smartfetch-production-ea53.up.railway.app/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

参数	类型	必填
url	string	是
max_chars	integer	否
force_browser	boolean	否

详细介绍

SmartFetch V1.11.1 — 紧急故障关闭模式

此源代码树是一个紧急遏制版本。检索功能暂时不可用。浏览器渲染功能暂时不可用。每个有效的 POST /fetch 请求以及对现有四个 MCP 工具中任意一个的调用，都会在支付验证、DNS、网络检索、提供方处理或结算之前失败。对于不可用的操作，不会发起支付挑战。

V1.11 付费功能仍处于禁用状态：八个 V1.11 REST 变体返回普通 404 响应，另外两个 MCP 工具则不存在。V1.11 Stage 5 基准测试默认仍处于离线状态；此版本不授权进行真实的提供方基准测试，也不会激活 Exa 或 Gemini。

此仓库版本为 1.11.1。此版本不声称已发布 V1.11.1 镜像、Official MCP Registry 条目或 x402scan 列表。V1.10.6 仍是单独发布的 Official MCP Registry 版本；发布此紧急版本需要单独审核和授权。部署、生产配置、Registry 发布和 x402scan 更改是相互独立的操作。

当前公开契约

GET /health 仍是免费的存活状态路由。其 JSON 包含 version: "1.11.1"、retrieval_available: false、browser_available: false 和 mode: "emergency_fail_closed"。
/、/docs、/openapi.json、/llms.txt、/.well-known/x402、/meta、/robots.txt 和 /sitemap.xml 仍然免费。它们会标明检索不可用，并声明可执行的付费资源数量为零。
有效的 POST /fetch 会返回有限的 HTTP 503 retrieval_unavailable。有效的强制浏览器请求则会返回有限的 HTTP 503 browser_unavailable。两者都会包含 Retry-After: 3600 和 Cache-Control: no-store，且不会处理支付标头。
格式错误、超大或不受支持的请求信封仍会返回有限的验证错误，不会被重新标记为不可用。
MCP initialize 和 tools/list 仍然免费。tools/list 仅公开 fetch_webpage、webpage_to_markdown、extract_webpage_text 和 render_webpage，且每个工具都明确标记为不可用。调用其中任意工具都会在支付包装器或检索处理程序运行之前返回有限的错误结果。
八个 V1.11 REST 变体仍返回 404，search_and_extract 和 extract_structured_data 则不会出现在 MCP 发现结果中。

在此紧急模式下，不存在成功的检索响应。附加标记 content_trust: untrusted_external 仅保留给未来成功检索的结果使用；它不会插入紧急错误，也不会改写源内容。

本地源代码验证

请使用隔离的 Python 环境，安装仓库声明的依赖项，并在构建前运行紧急测试套件。本地容器构建命令为：

docker build -t smartfetch:v1.11.1 .

这是一个本地镜像标签，并非远程发布的 V1.11.1 镜像。Dockerfile 以 UID/GID 10001:10001 运行，且不会安装 Chromium、FFmpeg 或 FFprobe。已构建镜像的门禁会在本地启动的容器内运行紧急 API/MCP 冒烟测试脚本。启动或进行这些免费检查不需要任何提供方、支付协调器、钱包或支付凭据。

发布和回滚边界

在已批准的 SSRF、取消、凭据隔离和清理边界得到验证之前，不要激活 V1.11 付费接口或恢复检索功能。安全回滚只能使用另一个已验证的故障关闭镜像；禁止恢复启用了检索功能的 V1.11.0 镜像。恢复浏览器功能以及任何支持检索的架构，都需要单独通过精确运行时和最终镜像遏制门禁。部署验证完成后，如需发布到 Official MCP Registry 或 x402scan，仍须获得单独授权。

较早的 Git 历史中仍可查看 V1.10 支付和检索的详细信息。这些内容并非指示你向此紧急服务付款或对其执行检索。

支持 Markdown

登录后评论