核心用法
facebook-page 是一个基于 Meta Graph API v25.0 的通用技能,允许用户通过自然语言指令直接操控 Facebook 主页的几乎所有功能。技能采用"意图识别 → 动态构建 API 调用"的架构,无需预设脚本或固定命令模式。
主要功能覆盖:
- 内容发布:文本、图片、视频、链接帖子,支持即时发布或定时排期
- 内容管理:删除帖子、发布草稿、获取近期帖子列表
- 互动管理:获取评论、回复评论、隐藏/删除评论、点赞帖子
- 数据分析:主页洞察(粉丝数、曝光量)和单帖洞察(互动数据)
- 活动管理:创建和查看主页活动
- 主页信息:读取主页基本信息、角色权限、相册列表
技术实现:
- 凭证存储于
~/.config/fb-page/credentials.json,包含永不过期的 Page Token - 支持标准 HTTP 方法(GET/POST/DELETE)及 multipart 文件上传
- 内置完整错误码映射表,可精准识别权限缺失、Token 过期等问题
显著优点
1. 官方直连:直接调用 Meta Graph API,无中间商,数据不经过第三方
2. 权限透明:每个功能所需权限明确标注,缺失时精确告知用户补充步骤
3. 灵活构建:不依赖预设命令,根据用户自然语言意图动态构造 API 调用
4. 安全存储:凭证文件建议设置 600 权限,明确禁止提交至版本控制
潜在缺点与局限性
- 配置门槛高:需完成 App 创建、权限申请、Token 交换等 Meta 开发者流程
- 权限审核严格:部分功能需 Meta 官方审核,开发阶段仅限测试账号
- Rate Limit 未详述:文档未明确说明 API 调用频率限制
- 无批量操作优化:大量内容管理时需逐条调用
- 平台依赖:仅支持 Facebook,不支持 Instagram 等其他 Meta 平台
适合人群
- 需要自动化管理 Facebook 主页的社交媒体运营者
- 具备基本 API 概念的技术用户或开发者
- 对数据隐私敏感、希望避免第三方工具的企业账号管理者
常规风险
- Token 泄露风险:永不过期 Token 一旦泄露需重新生成,建议严格限制凭证文件权限
- 权限过度授予:Token 绑定多种权限,需最小权限原则管理
- 内容合规责任:自动化发布内容仍需遵守 Facebook 社区准则,违规可能导致主页限制
- API 变更风险:Meta 可能弃用端点或调整权限模型