facebook-pages-mcp

facebook-pages-mcp

适用于 Facebook Pages 自然流量分析与管理的 MCP 服务，由 Meta Graph API v25.0 提供支持。

专为 Claude Code 和任何兼容 MCP 的 AI 工具打造。让你的 AI 助手直接访问 Facebook Page 数据——帖子、洞察数据、评论等。

这是 Rex Jones 推出的 The SEO Engine 工具包的一部分，为代理机构和企业提供 AI 驱动的 SEO 与社交媒体工具。

为什么要开发这个工具

• 此前没有好用的 Facebook Pages MCP 服务。 Instagram 已有多个此类服务，而 Facebook Pages 还没有能在当前 API 版本上正常使用的服务。
• Meta 将于 2026 年 6 月 15 日弃用旧版指标。 page_impressions、page_reach 和 page_impressions_unique 将不再返回数据。本服务从一开始就使用替代指标。
• 支持 Business Manager。 大多数企业通过 Meta Business Manager 而非个人账户管理 Pages。本服务两种方式都支持。

快速开始

选项 1：使用 npx（无需安装）

{
  "mcpServers": {
    "facebook-pages": {
      "command": "npx",
      "args": ["-y", "facebook-pages-mcp"],
      "env": {
        "FB_PAGE_ACCESS_TOKEN": "your_page_access_token",
        "FB_PAGE_ID": "your_page_id"
      }
    }
  }
}

选项 2：克隆并构建

git clone https://github.com/lanternrow/facebook-pages-mcp.git
cd facebook-pages-mcp
npm install
npm run build

然后将以下内容添加到 Claude Code MCP 设置中：

{
  "mcpServers": {
    "facebook-pages": {
      "command": "node",
      "args": ["/path/to/facebook-pages-mcp/dist/index.js"],
      "env": {
        "FB_PAGE_ACCESS_TOKEN": "your_page_access_token",
        "FB_PAGE_ID": "your_page_id"
      }
    }
  }
}

获取 Page Access Token

步骤 1：创建 Meta App

1. 前往 Meta for Developers 并点击 Create App
2. 为应用命名，并选择 "Manage everything on your Page" 用例
3. 将其关联到你的 Business Portfolio

步骤 2：在 Graph API Explorer 中生成令牌

1. 打开 Graph API Explorer
2. 从 Meta App 下拉菜单中选择你的应用
3. 添加权限：pages_show_list、pages_read_engagement、business_management
4. 点击 Generate Access Token 并完成 OAuth 流程
5. 系统询问 Pages 时，选择 "Opt in to all current and future Pages"

步骤 3：获取 Page Access Token

如果你的 Pages 通过 Business Manager 管理（大多数企业）：

# First, find your business ID
GET /me/businesses?fields=id,name

# Then get Page tokens for that business
GET /{business-id}/owned_pages?fields=id,name,access_token

如果你的 Pages 位于个人账户下：

GET /me/accounts?fields=id,name,access_token

复制目标 Page 对应的 access_token 和 id。

步骤 4：换取长期令牌（推荐）

短期令牌约 1 小时后过期。换取长期令牌（约 60 天）：

GET /oauth/access_token
  ?grant_type=fb_exchange_token
  &client_id={your-app-id}
  &client_secret={your-app-secret}
  &fb_exchange_token={short-lived-token}

提示： 对于你拥有管理员权限的 Pages，由长期 User Token 衍生的 Page 令牌永不过期。

工具

读取工具

工具	说明
get_page_info	Page 元数据：名称、类别、粉丝数、联系信息、封面照片
get_page_insights	Page 级分析数据，支持日期范围和周期聚合（日／周／28 天）
get_published_posts	按分页列出由 Page 发布的帖子
get_post_insights	单条帖子的互动数据：展示次数、点击次数、按类型统计的反应
get_post_comments	按分页列出评论，包含作者信息以及点赞和回复数
get_video_insights	视频表现：观看次数、观看时长、反应
get_page_feed	完整动态，包括访客帖子

写入工具

工具	说明
create_post	在 Page 上发布文字、链接或照片帖子

实用工具

工具	说明
refresh_token_info	检查令牌有效性、过期时间和已授予的权限范围

指标与 2026 年 6 月的弃用

Meta 于 2026 年 6 月 15 日弃用了以下 Page 级指标：

已弃用	替代指标
page_impressions	page_views_total
page_reach	Page Viewer 指标（正在推出）
page_impressions_unique	Media Viewers 指标（正在推出）

本服务仅使用未弃用的指标：page_views_total、page_fans、page_fan_adds、page_fan_removes、page_actions_post_reactions_total。

架构

src/
  index.ts          # MCP server entry point, tool registration
  client.ts         # Graph API HTTP client (native fetch, no dependencies)
  types.ts          # TypeScript interfaces for API responses
  tools/
    pages.ts        # get_page_info, get_page_feed
    insights.ts     # get_page_insights, get_video_insights
    posts.ts        # get_published_posts, get_post_insights, get_post_comments, create_post
    utils.ts        # refresh_token_info

• 零外部 HTTP 依赖 — 使用 Node 18+ 原生 fetch
• 速率限制跟踪 — 捕获 x-app-usage 和 x-page-usage 标头
• 基于游标的分页 — 所有列表端点都支持 after 游标和可配置的限制
• Zod 校验 — 校验所有工具输入，并提供清晰的错误消息

环境变量

变量	必填	描述
FB_PAGE_ACCESS_TOKEN	是	长期有效的 Page Access Token
FB_PAGE_ID	是	默认 Facebook Page ID（数字）

开发

npm run dev    # Watch mode — recompiles on save
npm run build  # Production build
npm start      # Run the server

贡献

欢迎提交问题和 PR。如果 Meta 更改了 API（他们迟早会这么做），请提交问题。

许可证

MIT — 参见 LICENSE。

---

由 Rex Jones 构建，属于 The SEO Engine 项目的一部分。