EveryPage

everypage-mcp

适用于 EveryPage 的 MCP 服务。让 AI 助手将 PDF 转换为可跟踪的分享链接，并告诉你实际有谁阅读了文档——他们读到了哪里、花了多长时间，以及停在哪一页。

“把这份提案分享给 Jane 和 Bob，然后明天告诉我他们是否有人读过定价页。”

§ 01 安装

无需安装：使用托管服务。 EveryPage 也会在 https://everypage.co/mcp 上运行此服务（Streamable HTTP、OAuth 登录、无需 API 密钥）。在 Claude 中，打开自定义 → 连接器 → 添加自定义连接器，然后粘贴该 URL；在 Claude Code 中，运行 claude mcp add --transport http everypage https://everypage.co/mcp。 请参阅 everypage.co/integrations/claude。 在此处上传文件时，需提供 https 链接，而不是本地文件路径。

此软件包（stdio）。 从 everypage.co/account 获取 API 密钥——格式类似 ep_live_…。然后将客户端指向该服务。

Claude Code

claude mcp add everypage --env EVERYPAGE_API_KEY=ep_live_... -- npx -y everypage-mcp

Claude Desktop、Cursor、VS Code，以及其他所有可读取 JSON 配置的工具

{
  "mcpServers": {
    "everypage": {
      "command": "npx",
      "args": ["-y", "everypage-mcp"],
      "env": { "EVERYPAGE_API_KEY": "ep_live_..." }
    }
  }
}

需要 Node 20 或更高版本。

§ 02 功能

工具	功能
everypage_share_pdf	上传 PDF（本地路径或 https URL），获取可跟踪链接、嵌入代码和 QR URL——并在同一次调用中应用分享设置
everypage_list_files	列出文档，可按名称筛选
everypage_get_file	获取单个文档的链接、保护设置和状态
everypage_update_file_settings	更改密码、到期时间、下载权限、查看器模式、邮箱验证、查看次数限制、页面范围和 slug
everypage_delete_file	将文档移至垃圾桶，或永久删除
everypage_replace_content	替换有效链接背后的 PDF，同时保留链接及其历史记录 · Pro
everypage_get_readership	查看谁读了文档、读到哪里，以及在哪里停止阅读
everypage_list_events	查看近期阅读、下载或已捕获的潜在客户，并提供轮询游标
everypage_create_variants	为每位收件人创建一个可跟踪链接，以便按姓名归属阅读记录 · Pro
everypage_list_variants	查看这些链接及其状态
everypage_update_variant	重命名、撤销或恢复某位收件人的链接 · Pro
everypage_delete_variant	删除链接，或根据 GDPR 删除收件人姓名 · Pro
everypage_list_webhooks	查看 Webhook 端点及其投递状态
everypage_manage_webhook	创建、测试或删除 Webhook 端点
everypage_account	查看已连接的账户、所属套餐以及套餐包含的权限

随附两个用作斜杠命令的提示词：readership_digest（过去 N 天发生的情况）和 send_tracked_copies（为每位收件人创建一个链接，确保操作无误）。

§ 03 值得了解的事项

文档可以用任何方式命名。 所有接受 file 的工具都支持 UUID、短链接 ID，或直接从浏览器复制的分享 URL——包括 /embed/ 链接和带有 ?via= 的链接，因此无需先查找 ID。

上传采用流式传输。 本地路径会从磁盘读取，而非载入内存，因此 Pro 计划下上传 2 GB 的文档也不会导致进程占用的内存不断增长。发送任何内容之前，系统会先检查文件的 PDF 魔数和计划规定的大小上限。

获取 URL 时不会使用你的凭据。 url 通道会从你指定的主机下载内容，不发送任何 EveryPage 请求头，然后再上传这些字节。你的 API 密钥绝不会传到第三方主机。

阅读情况会经过汇总，而非原样输出。 工具会计算出发现结果——触达漏斗中降幅最大的环节、重读次数最多的页面——并将原始数据行放入 structuredContent，供需要绘制图表的工具使用。

事件游标各自对应独立的数据流。 everypage_list_events 会返回 nextCursor，且它只对相同的 type 有效。三个数据流的 ID 序列彼此独立；混用会悄无声息地返回错误的时间范围。

删除默认可撤销。 everypage_delete_file 会将文件移入回收站，并明确说明这一点；purge: true 才是不可撤销的操作。无法撤销的工具会标记 MCP 的 destructiveHint，因此支持确认提示的客户端会在运行前询问是否确认。

§ 04 配置

变量	必需	默认值	含义
EVERYPAGE_API_KEY	是	—	ep_live_… API 密钥，或 ep_at_… OAuth 令牌（受授予的作用域限制）
EVERYPAGE_BASE_URL	否	https://everypage.co	API 来源，用于可自托管或开发实例
EVERYPAGE_READ_ONLY	否	false	true 时仅开放七个只读工具

§ 05 计划

部分功能受计划限制，拒绝请求时会说明需要哪个计划。 everypage_account 会报告当前计划及其限制。

	Free	Basic	Pro
上传大小	20 MiB	200 MiB	2 GiB
在线文档	3	100	不限
跟踪链接、分享设置、Webhook	✓	✓	✓
访问密码、查看次数限制、查看通知、单页统计		✓	✓
收件人专属链接、邮箱收集门槛、内容替换、水印、页面范围			✓

每个密钥每分钟最多可发出 120 个 API 请求。

§ 06 未包含的功能

/files/claim 和 Canva 发布通道（应用程序连接逻辑，不属于 Agent 工作），品牌素材和热点区域（Pro 计划的大型载荷，没有自然的 Agent 用途），以及经过身份验证的二维码获取功能——每个工具返回的 qr_url 都是公开的，无需凭据。如需其中任何功能，请提交 issue。

§ 07 开发

npm ci
npm run typecheck
npm test
npm run build
npm run inspector      # drive the tools by hand in the MCP inspector

工具接口已在 test/schemas.test.ts 中建立快照：重命名工具或其某个输入会有意导致 CI 失败，因为这会影响所有引用该名称的已保存提示词和 Agent 配置。

字段名称和输出结构由与 EveryPage Zapier、Make 和 n8n 集成共用的跨集成契约固定——请先修改该契约。

§ 08 链接

• EveryPage · MCP 集成页面
• 开发者 API · OpenAPI 规范
• 文档 · 支持

许可证

MIT