beehiiv

beehiiv/agents

为 AI Agent 打造的 beehiiv 官方工具，基于 beehiiv MCP 服务构建。

此仓库包含 Claude Code、Grok Build、Gemini CLI、Cursor 和 Codex 的插件清单，以及官方 MCP 注册表条目。它们都指向同一个托管服务：https://mcp.beehiiv.com/mcp。不会在你的机器上运行任何程序。

你可以做什么

连接后，Agent 可直接在你的 beehiiv 工作区中操作：

• 帖子。 草拟、编辑和复制帖子及帖子模板。读取帖子内容、统计数据、点击量、评论和单个订阅者的互动情况。发布和发送仍由你在 beehiiv 中手动操作，因此 Agent 会准备好帖子，再由你点击发送。
• 社区。 创建频道、发布和置顶帖子、审核举报、管理成员和角色、发送邀请和私信，以及读取社区指标。
• 播客。 创建节目和单集、上传音频、安排单集发布时间，以及读取转录文本和单集统计数据。
• 自动化。 构建用户旅程、步骤、触发器和自动化邮件，包括 A/B 变体。激活自动化仍需由你在编辑器中手动操作。
• 受众。 管理订阅、细分群组、标签、自定义字段、新闻简报列表和注册流程。
• 变现。 产品、层级、付费优惠、订单、付费墙、广告网络和赞助商网络。
• 增长。 推荐、引荐计划、投票和调查。
• 分析。 出版物和网站分析、帖子和播客统计数据、投票和调查回复、收益。

该服务还会介绍自身功能。让 Agent 调用 search_documentation、read_documentation 或任意 learn_* 工具，它就会获取有关帖子撰写和社区内容创作的最新指南，而不是凭空猜测。

技能

该插件还附带了出版商最常用的技能：入门和新出版物设置、效果与收入报告、退订量激增、自动化流程流失、媒体资料包、细分群组、帖子编辑和升级活动。完整列表请参阅 plugins/beehiiv/README.md。支持 Agent Skills 的客户端会随插件加载这些技能；其他客户端则仅使用 MCP 服务。

安装

Claude

beehiiv 已收录在 Claude 连接器目录中。前往 beehiiv 连接器页面添加，然后按提示登录。

ChatGPT

beehiiv 已收录在 ChatGPT 和 Codex 共用的插件目录中。前往 beehiiv 插件页面添加。

Claude Code 和 Cursor

/plugin marketplace add beehiiv/agents
/plugin install beehiiv@beehiiv

Grok Build

grok plugin install beehiiv/agents

Gemini CLI

gemini extensions install https://github.com/beehiiv/agents

Codex

运行 /plugins，选择 beehiiv，然后选择 Install Plugin。Codex 和 ChatGPT 共用一个插件目录，因此在任一平台安装即可同时用于两者。

或者手动将服务添加到 ~/.codex/config.toml：

[mcp_servers.beehiiv]
url = "https://mcp.beehiiv.com/mcp"
enabled = true

克隆此仓库并信任它也可以。.codex/config.toml 会为仓库内的会话注册该服务。

其他 MCP 客户端

通过 Streamable HTTP 将其指向 https://mcp.beehiiv.com/mcp。配置示例可在 beehiiv 工作区的 Settings → Workspace → MCP 中找到。

身份验证

OAuth 2.1。无需复制 API 密钥，也无需在此仓库中存储机密。

首次使用时，客户端会自动注册自身（RFC 7591 动态客户端注册），并在浏览器中打开 beehiiv 页面，让你登录并授予访问权限。客户端会收到一个作用域为 read 和 write 的访问令牌和刷新令牌。

每次工具调用都会根据你自己的 beehiiv 权限进行授权。Agent 只能访问你本就有权访问的出版物。

要求

• 拥有一个包含 MCP 访问权限的 beehiiv 账户。
• 为工作区启用 MCP。请查看 设置 → 工作区 → MCP。

如果工作区未启用 MCP，工具调用会返回权限错误。请参阅 开始使用 beehiiv MCP ，了解当前的计划要求。

某些工具组需要单独授权，因此 Agent 可用的工具取决于你的计划和 工作区设置。

布局

.mcp.json lives at plugins/beehiiv/ and states the server URL once.
Every ecosystem manifest beside it delegates to that file.

.claude-plugin/marketplace.json     point their client at ./plugins/beehiiv
.cursor-plugin/marketplace.json
.grok-plugin/marketplace.json
plugins/beehiiv/.mcp.json           the shared server config
plugins/beehiiv/.claude-plugin/     per-ecosystem plugin manifests
plugins/beehiiv/.cursor-plugin/
plugins/beehiiv/.grok-plugin/
plugins/beehiiv/.codex-plugin/
gemini-extension.json               must sit at the repo root
server.json                         official MCP registry entry

Gemini 要求其清单位于仓库的绝对根目录，并且不支持委托给共享文件，因此服务器 URL 会在此处再次出现。

网络端点和凭据

为便于审核，以及供审计此插件访问目标的人查看，现声明如下：

端点	用途
https://mcp.beehiiv.com/mcp	MCP 服务。所有工具调用。
https://mcp.beehiiv.com/.well-known/oauth-protected-resource	OAuth 资源发现（RFC 9728）。
https://mcp.beehiiv.com/.well-known/oauth-authorization-server	OAuth 服务元数据（RFC 8414）。
https://mcp.beehiiv.com/register	动态客户端注册（RFC 7591）。
https://mcp.beehiiv.com/authorize	启动登录流程。重定向至 app.beehiiv.com。
https://mcp.beehiiv.com/token	令牌交换和刷新。

所需凭据：beehiiv 账户。该插件会申请 read 和 write 作用域。

此仓库除 scripts/validate.sh 外不包含可执行代码，也不含安装钩子或本地进程。插件是指向托管 HTTPS 端点的 JSON 清单。

验证

./scripts/validate.sh

许可证

MIT。请参阅 LICENSE。