Facebook Page

用于通过 Meta Graph API 管理 Facebook Page 的技能。

功能

• 列出用户所管理的所有 Page
• 发布内容（文本、图片、链接）
• 列出 Page 的所有帖子
• 列出 / 回复 / 隐藏 / 删除评论

初始化配置（仅需一次）

1. 创建 Meta App

1. 访问 https://developers.facebook.com/apps/ → 点击 Create App
2. 选择 "Other" → "Business"（或根据使用场景选择 Consumer）
3. 填写应用名称和邮箱
4. 进入 App settings > Basic，获取 App ID 和 App Secret

2. 配置 OAuth

1. 点击 Add Product → 添加 Facebook Login
2. 在 Facebook Login > Settings 中：
   • Valid OAuth Redirect URIs：留空（使用 manual code flow）
3. 进入 App Roles > Roles → 添加管理员（Admin）或开发者（Developer）账号

3. 配置 .env 文件

cd skills/facebook-page
cp .env.example .env
# 编辑 .env，填入 App ID 和 App Secret

4. 安装依赖并获取 Token

cd scripts
npm install
node auth.js login

该脚本将执行以下操作：

1. 输出一个 URL，用户需在浏览器中打开、登录并授权所需权限
2. 用户复制授权成功后的 URL（其中包含 code=...）
3. 将该 URL 粘贴到终端中
4. 脚本使用 code 换取长期有效的 user token，再换取对应的 page token
5. 将 tokens 保存至 ~/.config/fbpage/tokens.json

命令行指令

列出所有 Page

node cli.js pages

发布纯文本帖

node cli.js post create --page PAGE_ID --message "Hello world"

发布带图片的帖

node cli.js post create --page PAGE_ID --message "Caption" --photo /path/to/image.jpg

发布带链接的帖

node cli.js post create --page PAGE_ID --message "Check this out" --link "https://example.com"

列出 Page 的帖子（限制数量）

node cli.js post list --page PAGE_ID --limit 10

列出某条帖子下的评论

node cli.js comments list --post POST_ID

回复某条评论

node cli.js comments reply --comment COMMENT_ID --message "Thanks!"

隐藏某条评论

node cli.js comments hide --comment COMMENT_ID

删除某条评论

node cli.js comments delete --comment COMMENT_ID

必需的权限（Permissions）

• pages_show_list —— 列出 Page
• pages_read_engagement —— 读取帖子与评论
• pages_manage_posts —— 发布、编辑、删除帖子
• pages_manage_engagement —— 管理评论

注意事项

• Page Token 不会过期（前提是基于长期有效的 user token 获取）
• 切勿将 token 输出或打印到日志中
• 处于 Testing mode 的 App 仅对 Roles 中配置的账号生效