PrintFriendly

面向 AI 编辑器的 PrintFriendly

PrintFriendly 的 MCP 服务可让你的 AI 编辑器或 Agent 将任何公开网页读取为简洁的 Markdown，去除广告、导航和弹出窗口；还可将网页、HTML 或 Markdown 转换为 PDF、Word、Markdown、HTML 或 JSON 文档。它适用于 Cursor、Claude Code、VS Code、Gemini CLI、Windsurf、Cline，以及任何支持通过 HTTP 使用 MCP 的其他客户端。服务运行于 https://mcp.printfriendly.com，你只需要一个 API key。

获取免费密钥

在 printfriendly.com/me/api-key 创建密钥。免费套餐每月包含 100 份文档。

下方凡是出现 YOUR_API_KEY 的地方，都替换为你的密钥。服务接受 Authorization: Bearer YOUR_API_KEY 或 X-API-Key: YOUR_API_KEY 形式的密钥。

安装

Cursor

点击按钮会打开 Cursor，并将服务添加为 YOUR_API_KEY 占位符。打开 Cursor 设置，进入 MCP，然后将占位符替换为你的密钥。如果按钮无法打开 Cursor，请改为将此链接粘贴到浏览器中：

cursor://anysphere.cursor-deeplink/mcp/install?name=printfriendly&config=eyJ1cmwiOiJodHRwczovL21jcC5wcmludGZyaWVuZGx5LmNvbSIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciBZT1VSX0FQSV9LRVkifX0%3D

或者手动将其添加到 .cursor/mcp.json（或适用于所有项目的 ~/.cursor/mcp.json）：

{
  "mcpServers": {
    "printfriendly": {
      "url": "https://mcp.printfriendly.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

不要将真实密钥纳入版本控制。在你提交的文件中，使用 "Bearer ${env:PRINTFRIENDLY_API_KEY}"，并设置该环境变量。

此仓库也是一个 Cursor 插件：.cursor-plugin/plugin.json 声明了 PRINTFRIENDLY_API_KEY 变量，mcp.json 使用该变量。

VS Code

点击任一按钮都会打开 VS Code，并将服务添加为 YOUR_API_KEY 占位符。运行 MCP: List Servers，选择 PrintFriendly，打开其配置并将占位符替换为你的密钥。

也可以在终端中安装：

code --add-mcp '{"name":"printfriendly","type":"http","url":"https://mcp.printfriendly.com","headers":{"Authorization":"Bearer YOUR_API_KEY"}}'

如需避免将密钥写入文件，请将以下内容放入 .vscode/mcp.json。服务首次启动时，VS Code 会提示你输入密钥。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "printfriendly-api-key",
      "description": "PrintFriendly API key",
      "password": true
    }
  ],
  "servers": {
    "printfriendly": {
      "type": "http",
      "url": "https://mcp.printfriendly.com",
      "headers": {
        "Authorization": "Bearer ${input:printfriendly-api-key}"
      }
    }
  }
}

Claude Code

claude mcp add --transport http printfriendly https://mcp.printfriendly.com --header "Authorization: Bearer YOUR_API_KEY"

添加 --scope user 可使其在所有项目中可用。在 Claude Code 中运行 /mcp 检查连接：如果密钥错误，这里会显示 401。

若要通过项目中的 .mcp.json 文件与团队共享服务，请引用环境变量，而不要直接填写密钥：

{
  "mcpServers": {
    "printfriendly": {
      "type": "http",
      "url": "https://mcp.printfriendly.com",
      "headers": {
        "Authorization": "Bearer ${PRINTFRIENDLY_API_KEY}"
      }
    }
  }
}

Gemini CLI

安装扩展。Gemini CLI 会提示你输入 API key，并避免将其存入项目文件：

gemini extensions install https://github.com/printfriendly/printfriendly-mcp

之后可通过 gemini extensions config printfriendly 更改密钥。

或者不使用扩展，直接添加服务：

gemini mcp add --transport http printfriendly https://mcp.printfriendly.com --header "Authorization: Bearer YOUR_API_KEY"

这会将配置写入当前项目的 .gemini/settings.json。添加 --scope user 可改为写入 ~/.gemini/settings.json。你也可以手动编辑该文件。Gemini CLI 会在请求头中展开 $PRINTFRIENDLY_API_KEY，因此密钥可以保留在 shell 环境中：

{
  "mcpServers": {
    "printfriendly": {
      "httpUrl": "https://mcp.printfriendly.com",
      "headers": {
        "Authorization": "Bearer $PRINTFRIENDLY_API_KEY"
      }
    }
  }
}

此仓库也是一个 Gemini CLI 扩展：gemini-extension.json 声明了服务和 PRINTFRIENDLY_API_KEY 设置，GEMINI.md 则为 Gemini 简要说明了各工具的适用时机。

Windsurf

在 Cascade 面板中，打开 Actions 菜单，选择 Open MCP config file，然后添加下面的代码块。Windsurf 使用 serverUrl，而大多数客户端使用 url；它还会读取格式为 ${env:NAME} 的环境变量，因此密钥可以不写入文件：

{
  "mcpServers": {
    "printfriendly": {
      "serverUrl": "https://mcp.printfriendly.com",
      "headers": {
        "Authorization": "Bearer ${env:PRINTFRIENDLY_API_KEY}"
      }
    }
  }
}

你也可以改用 "Bearer YOUR_API_KEY"，直接将密钥写入文件。

Cline

Cline 从 cline_mcp_settings.json 读取远程服务。要打开该文件，请点击 Cline 面板顶部的 MCP Servers 图标，打开 Configure 标签页，然后点击 Configure MCP Servers。此服务需要在 Cline 中设置 "type": "streamableHttp"；如果不设置类型，Cline 会默认使用较旧的 SSE 传输方式。

{
  "mcpServers": {
    "printfriendly": {
      "type": "streamableHttp",
      "url": "https://mcp.printfriendly.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      },
      "disabled": false
    }
  }
}

你也可以将 llms-install.md 中的说明发给 Cline，让它为你设置服务。

其他客户端

大多数 MCP 客户端会从设置文件中读取类似这样的代码块。文件名和外层键因客户端而异，但服务条目相同。

{
  "mcpServers": {
    "printfriendly": {
      "type": "http",
      "url": "https://mcp.printfriendly.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

工具

read_page

读取网页并以整洁的 Markdown 返回主要内容，以及标题、作者、日期和字数。除非你提出要求，否则不会包含链接地址；如果网页很长，则会在段落处截断并说明原因。

• “阅读 https://example.com/some-article 并告诉我三个主要要点。”
• “阅读这个文档页面，保留链接，然后列出其中提到的所有 API 端点。”

create_document

根据网页地址、HTML 或 Markdown 创建文档。可选择 pdf、docx、markdown、html 或 json。PDF 和 Word 格式的结果会以下载链接形式提供，有效期为 48 小时。

• “将 https://example.com/recipe 制作为 A4 纸张尺寸的 PDF。”
• “将此页面转换为 Word 文档：https://example.com/report”
• “将这份 Markdown 保存为标题为‘会议记录’的 PDF。”

限制

免费套餐每月包含 100 份文档。对任一工具的每次成功调用均计为一份文档，失败调用不计入。服务仅读取公开网页，因此需要登录或付费访问的页面可能会返回空内容。需要更多文档的付费套餐请访问 printfriendly.com/api。

链接

• 文档
• 服务条款
• 隐私政策
• MIT 许可证