Marketing Skills 仓库中的 Beehiiv 集成指南：用 REST API v2 与 CLI 构建 Newsletter 自动化工作流

AI 技能人工智能【免费下载链接】marketingskillsMarketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.项目地址https://gitcode.com/GitHub_Trending/mar/marketingskills点击查看免费下载本文面向需要在 AI Agent如 Claude Code中编程化管理 Newsletter 的开发者与营销工程师系统讲解 Marketing Skills 仓库对 Beehiiv 的集成方式。读完本文你将掌握 Beehiiv REST API v2 的认证方式、出版物/订阅/文章/分组/自动化/推荐计划六大资源端点的完整用法、光标分页等 API 模式以及如何通过仓库自带的零依赖 Node CLItools/clis/beehiiv.js在命令行中快速完成订阅者管理与发文流程。集成能力总览Marketing Skills 仓库通过 tools/REGISTRY.md 统一维护营销工具索引Beehiiv 在注册表中归属Newsletter类别与 Mailchimp、Kit、Customer.io 等 Email 类工具并列。Beehiiv 本身是面向 Newsletter 业务的平台提供订阅者管理、文章发布、自动化Automations与推荐计划Referral Program能力。从集成方式看以 tools/integrations/beehiiv.md 的 Capabilities 表为准IntegrationAvailableNotesAPI✓REST API v2覆盖 publications、subscriptions、posts、segmentsMCP-暂不可用CLI✓tools/clis/beehiiv.jsSDK-无官方 SDK但提供 OpenAPI 规范可用于代码生成仓库的策略是为不提供自带 SDK/CLI 的营销平台补充零依赖的单文件 Node CLI。Beehiiv 正是这种情况——无官方 SDK、无 MCP 服务因此仓库提供了 tools/clis/beehiiv.js 作为标准访问入口让 Agent 无需安装任何依赖即可操作 Beehiiv 全量 API。认证Bearer Token 与密钥安全Beehiiv API v2 使用最简单的 Bearer Token 认证方式类型Bearer Token请求头Authorization: Bearer {api_key}获取位置Beehiiv 工作区设置Workspace Settings中的 Settings API地址为 app.beehiiv.com重要提示API Key 仅在创建时展示一次必须立即复制并妥善保存之后无法再次查看仓库中的 CLI 实现完全遵循这一认证方式。tools/clis/beehiiv.js 第 3-9 行从环境变量读取密钥并在缺失时直接报错退出const API_KEY process.env.BEEHIIV_API_KEY const BASE_URL https://api.beehiiv.com/v2 if (!API_KEY) { console.error(JSON.stringify({ error: BEEHIIV_API_KEY environment variable required })) process.exit(1) }而每次实际请求第 15-23 行都会携带标准的三件套请求头const res await fetch(${BASE_URL}${path}, { method, headers: { Authorization: Bearer ${API_KEY}, Content-Type: application/json, Accept: application/json, }, body: body ? JSON.stringify(body) : undefined, })按照 tools/clis/README.md 的安全规范仓库要求所有密钥一律通过环境变量传入绝不硬编码进脚本。对 Beehiiv 而言就是设置BEEHIIV_API_KEYexport BEEHIIV_API_KEYyour-api-key-hereCLI 还内置了--dry-run安全预览模式tools/clis/beehiiv.js 第 12-14 行只输出请求方法、URL 与脱敏后的请求头Authorization: ***不真正发送请求方便 Agent 在正式操作前核对请求结构。CLI 安装与命令模式Beehiiv CLI 是零依赖单文件脚本仅要求 Node 18使用原生fetch无需npm install。三种安装方式见 tools/clis/README.md方式一直接运行node tools/clis/beehiiv.js publications list方式二Symlink 到全局路径ln -sf $(pwd)/tools/clis/beehiiv.js ~/.local/bin/beehiiv beehiiv subscriptions list --publication pub_xxx方式三把整个 tools/clis 目录加入 PATHexport PATH$PATH:/path/to/marketingskills/tools/clis所有 CLI 遵循统一的命令模式{tool} resource action [options]详见 tools/clis/README.md。Beehiiv CLI 支持的命令由 tools/clis/beehiiv.js 第 224-236 行的 usage 信息完整列出publications: publications [list | get --publication id] subscriptions: subscriptions [list | get --id id | create --email email | update --id id | delete --id id] --publication id posts: posts [list | get --id id | create --title title | delete --id id] --publication id segments: segments [list | get --id id] --publication id automations: automations [list | get --id id] --publication id referral-program: referral-program [get] --publication id options: --publication id --limit n --email email --status status --tier tier所有命令输出 JSON 到 stdout可直接管道给jq解析或存入文件例如beehiiv subscriptions list --publication pub_xxx --status active | jq .data[].email常见 Agent 操作六大资源端点实战Beehiiv API v2 的全部端点都以出版物publication为作用域publication ID 是绝大多数操作必需的路径参数。以下端点均来自 tools/integrations/beehiiv.md 的 Common Agent Operations并标注了 CLI 中对应的子命令。出版物Publications列出与查询出版物信息# 列出所有出版物 GET https://api.beehiiv.com/v2/publications# 获取单个出版物详情 GET https://api.beehiiv.com/v2/publications/{publicationId}CLI 对应命令beehiiv publications list beehiiv publications get --publication pub_xxx在 tools/clis/beehiiv.js 中publication与pub两个参数别名均被接受第 57 行get 子命令要求必须提供--publication否则返回错误对象。订阅Subscriptions订阅者管理是 Newsletter 自动化最核心的操作支持增删改查# 列出订阅分页 状态过滤 GET https://api.beehiiv.com/v2/publications/{publicationId}/subscriptions?limit10statusactive # 按邮箱精确过滤 GET https://api.beehiiv.com/v2/publications/{publicationId}/subscriptions?emailuserexample.com# 创建订阅 POST https://api.beehiiv.com/v2/publications/{publicationId}/subscriptions { email: userexample.com, reactivate_existing: false, send_welcome_email: true, utm_source: api, tier: free }# 更新订阅如升级到 premium PUT https://api.beehiiv.com/v2/publications/{publicationId}/subscriptions/{subscriptionId} { tier: premium }# 删除订阅 DELETE https://api.beehiiv.com/v2/publications/{publicationId}/subscriptions/{subscriptionId}对应的 CLI 子命令在 tools/clis/beehiiv.js 第 76-131 行实现。create子命令的完整参数值得注意第 97-110 行它把 body 的每个字段都暴露为--风格选项便于 Agent 组合调用beehiiv subscriptions create --publication pub_xxx --email userexample.com \ --reactivate-existing --send-welcome-email \ --utm-source api --utm-medium newsletter --utm-campaign launch \ --tier free --referring-site example.com其中--reactivate-existing和--send-welcome-email是布尔开关出现即置为true--referring-site映射为 body 中的referring_site字段。list子命令第 78-88 行则支持--email、--status、--tier、--cursor、--expand等过滤与扩展参数与 API 查询参数一一对应。文章Posts文章管理支持列出、查询、创建与删除其中创建文章仅 Enterprise 计划可用# 列出文章默认 10 条可加 statusconfirmed 只看已确认/已排期的 GET https://api.beehiiv.com/v2/publications/{publicationId}/posts?limit10statusconfirmed# 创建文章草稿Enterprise only POST https://api.beehiiv.com/v2/publications/{publicationId}/posts { title: Weekly Update, subtitle: What happened this week, content: pHello subscribers.../p, status: draft }CLI 的posts createtools/clis/beehiiv.js 第 151-160 行以--title为必填参数--subtitle、--content、--status可选beehiiv posts create --publication pub_xxx \ --title Weekly Update --subtitle What happened this week \ --content pHello subscribers.../p --status draft注意 CLI 中status的合法取值沿用 API 定义draft草稿、confirmed已确认/已排期、archived已归档。分组与自动化Segments / Automations# 列出分段用于订阅者细分 GET https://api.beehiiv.com/v2/publications/{publicationId}/segments # 列出自动化流程 GET https://api.beehiiv.com/v2/publications/{publicationId}/automationsCLI 对应beehiiv segments list --publication pub_xxx beehiiv segments get --publication pub_xxx --id seg_xxx beehiiv automations list --publication pub_xxx beehiiv automations get --publication pub_xxx --id auto_xxx推荐计划Referral ProgramGET https://api.beehiiv.com/v2/publications/{publicationId}/referral_programCLI 对应referral-program get子命令tools/clis/beehiiv.js 第 212-222 行是查询出版物推荐计划配置的唯一下级命令。API 模式与分页约定Beehiiv API v2 有两个关键模式约定来自 tools/integrations/beehiiv.md 的 API Pattern 章节Publication 作用域除GET /publications之外的所有端点都以/publications/{publicationId}为前缀publication ID 是必需的路径参数。光标分页Cursor-based Pagination列表类响应使用cursor参数获取后续页而非页码偏移。CLI 的subscriptions list与posts list都支持--cursor透传tools/clis/beehiiv.js 第 85 行、第 140 行Agent 可以在分页循环中把响应里的 cursor 原样传回以拉取下一页数据。关键字段与指标解读订阅字段Subscription Fieldsstatus— 订阅状态validating校验中、invalid无效、pending待定、active活跃、inactive不活跃tier— 订阅层级free或premiumcreated— 订阅创建时间戳utm_source、utm_medium、utm_campaign— 获客渠道追踪与创建订阅请求中的 UTM 参数一一对应referral_code— 订阅者专属推荐码可用于构建推荐计划闭环文章字段Post Fieldsstatus—draft、confirmed已排期、archivedpublish_date— 文章实际/计划发布时间stats— 打开率Open rate、点击率Click rate、订阅者数需要配合expand[]stats展开获取通用查询参数Common Query Parameters参数说明limit每页结果数取值范围 1-100默认 10cursor下一页游标expand[]附加数据展开stats、custom_fields、referralsstatus按订阅/文章状态过滤tier按订阅层级过滤free、premiumCLI 对expand[]的支持体现在subscriptions list的--expand选项tools/clis/beehiiv.js 第 86 行Agent 可通过--expand stats一次性取回订阅者的统计附加数据。速率限制与批处理约束Beehiiv API 的速率限制按 API Key 独立生效来自 tools/integrations/beehiiv.md 的 Rate Limits 章节。由于不提供批量操作端点涉及大量数据的场景需要以单条请求迭代完成。为提高效率应始终使用光标分页拉取列表数据而不是一次请求获取全部记录。Agent 在处理大批量订阅者同步时建议在循环中控制请求节奏并捕获429类限流响应做退避重试。典型应用场景根据 tools/integrations/beehiiv.md 的 When to Use 章节Beehiiv 集成主要适用于编程化管理 Newsletter 订阅者— 通过 subscriptions 端点批量增删改查结合tier区分 free/premium 用户从外部表单或落地页同步订阅者— 将营销活动产生的邮箱实时写入 Beehiiv创建订阅时携带utm_source等参数保留获客归因配合reactivate_existing与send_welcome_email控制行为构建推荐计划集成— 通过referral_program端点读取配置利用订阅者的referral_code字段串联推荐链路自动化文章创建与发布流程— 对 Enterprise 计划用户用posts create将内容系统自动生成的 Newsletter 以draft状态写入经人工确认后再发布追踪订阅者增长与互动指标— 用expand[]stats拉取打开率、点击率等增长指标用于后续分析这些场景与仓库中的营销技能形成互补订阅者生命周期与序列设计可参考 skills/emails/SKILL.md欢迎序列、培育序列、重激活序列的设计规范与模板见 skills/emails/references/sequence-templates.md推荐计划的产品化设计触发时机、分享机制、激励结构、衡量指标可参考 skills/referrals/SKILL.md内容发布节奏与选题策略则可参考 skills/content-strategy/SKILL.md。关联技能与生态定位tools/integrations/beehiiv.md 末尾将 Beehiiv 与四个仓库技能关联emails— Newsletter 序列与生命周期邮件设计newsletter-growth— 订阅者增长专项referrals— 推荐计划与口碑增长content-strategy— 内容战略与分发在工具生态定位上tools/REGISTRY.md 的 Email 类别中将 Beehiiv 标记为 Newsletter platform并给出选型建议Resend for transactional (dev-friendly)... Beehiiv for newsletters——即 Newsletter 业务场景首选 Beehiiv而事务性邮件则选择 Resend 等工具两类工具在 Agent 工作流中可以各司其职、协同配合。仓库整体遵循为没有自带 SDK/MCP 的营销平台补齐 CLI 访问层的策略Beehiiv 正是该策略的典型落地案例开发者可以直接复用 tools/clis/beehiiv.js 或在自建脚本中遵循相同的环境变量认证与 JSON 输出约定。赞分享AI 技能人工智能【免费下载链接】marketingskillsMarketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.项目地址https://gitcode.com/GitHub_Trending/mar/marketingskills点击查看免费下载相关推荐DeepSeek Harness 沙箱策略上下文重构能力中立Capability-Neutral设计与注册表消除实践DeepSeek Harness 沙箱策略上下文重构能力中立Capability Neutral设计与注册表消除实践 本文基于 DeepSeek HarnAI 技能人工智能终极Kubero API与CLI使用指南自动化集成与CI/CD工作流实战终极Kubero API与CLI使用指南自动化集成与CI/CD工作流实战 Kubero作为一款免费的自托管PaaS解决方案为开发者提供了媲美Heroku、N云原生后端运维BambuStudio 真实 AMS 渐变与多拼槽颜色语义的 E2E 验证实战基于 WebView2 CDP 与 Playwright 的真机验证方案BambuStudio 真实 AMS 渐变与多拼槽颜色语义的 E2E 验证实战基于 WebView2 CDP 与 Playwright 的真机验证方案 导读AI 技能人工智能上一篇DLSS Swapper终极指南3步掌握游戏性能优化神器下一篇DLSS Swapper终极指南轻松管理游戏DLSS版本的免费神器创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考