核心用法
beehiiv skill 是 Maton 提供的 beehiiv API 网关封装，通过 MATON_API_KEY 环境变量进行统一认证，自动处理 OAuth 授权流程。用户无需直接对接 beehiiv 的复杂 OAuth 流程，只需通过 Maton 的连接管理界面完成一次授权，即可调用完整的 beehiiv v2 API。
主要功能模块包括：
- Publications（出版物）：管理 Newsletter 主配置、查看统计指标
- Subscriptions（订阅者）：创建/查询/更新/删除订阅者，支持自定义字段扩展
- Posts（文章）：发布和管理 Newsletter 内容
- Custom Fields（自定义字段）：扩展订阅者元数据，支持 string/integer/boolean/date 等多种类型
- Segments（细分群体）：基于条件筛选订阅者群体
- Tiers（订阅层级）：管理免费/付费订阅层级
- Automations（自动化）：配置邮件自动化工作流
所有 API 通过 https://gateway.maton.ai/beehiiv/ 代理转发，Maton 自动注入 OAuth Token。支持游标分页（推荐）和传统页码分页（限制100页）。
显著优点
1. OAuth 托管简化：无需自建 OAuth 流程，通过 Maton 控制台一键授权
2. 统一认证：单 API Key 管理多平台连接，降低密钥泄露风险
3. 完整 API 覆盖：涵盖 beehiiv v2 全部核心功能，包括付费层级和自动化
4. 灵活扩展：自定义字段系统允许深度个性化订阅者数据
5. 多连接支持：可同时管理多个 beehiiv 账号，通过 Maton-Connection 头指定
潜在缺点与局限性
1. 供应商锁定：完全依赖 Maton 网关，若 Maton 服务中断则无法直接 fallback 到原生 beehiiv API
2. 额外依赖层：相比直接调用 beehiiv API，增加了网络跳转和潜在延迟
3. 功能延迟：beehiiv API 更新需等待 Maton 网关同步，可能存在功能滞后
4. 付费门槛：需要 Maton 账号和 API Key，对仅使用 beehiiv 的用户增加成本
5. 调试复杂度：错误排查需区分 Maton 网关层和 beehiiv API 层问题
适合人群
- Newsletter 创作者和运营团队需要自动化订阅者管理
- 需要将 beehiiv 数据同步到内部 CRM 或数据分析系统的开发者
- 同时运营多个 beehiiv 出版物，需要统一管理的机构用户
- 希望避免 OAuth 开发成本，快速集成 beehiiv 功能的低代码/无代码场景
常规风险
1. API 密钥泄露：MATON_API_KEY 泄露可能导致所有连接的数据暴露，需严格保管
2. 数据隐私合规：通过第三方网关处理订阅者邮箱等 PII 数据，需评估 GDPR/CCPA 合规性
3. 速率限制：beehiiv 和 Maton 双重限速，高频操作可能触发 429 错误
4. 连接失效：beehiiv OAuth 授权过期或撤销会导致 API 调用失败，需监控连接状态
5. 误操作风险：DELETE 操作直接永久删除资源，生产环境建议先在沙盒测试