facebook-pages-mcp

facebook-pages-mcp

Meta Graph API v25.0 を利用した、Facebook Pages のオーガニック分析と管理向け MCP サーバーです。

Claude Code や、MCP に対応したあらゆる AI ツール向けに構築されています。AI アシスタントから Facebook ページのデータ（投稿、インサイト、コメントなど）に直接アクセスできます。

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 を通じてページを管理しています。このサーバーはどちらにも対応しています。

クイックスタート

オプション 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"
      }
    }
  }
}

ページアクセストークンの取得

ステップ 1：Meta アプリを作成する

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. ページについて確認されたら、"Opt in to all current and future Pages" を選択します

ステップ 3：ページアクセストークンを取得する

ページを 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

ページが個人アカウントにある場合：

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

対象のページの 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}

ヒント： 自分が管理者のページでは、長期間有効なユーザートークンから生成されたページトークンは期限切れになりません。

ツール

読み取りツール

ツール	説明
get_page_info	ページのメタデータ：名前、カテゴリ、フォロワー数、連絡先情報、カバー写真
get_page_insights	期間指定と集計単位（日／週／28 日）に対応したページレベルの分析
get_published_posts	ページが作成した投稿のページネーション付き一覧
get_post_insights	投稿ごとのエンゲージメント：インプレッション、クリック数、種類別リアクション
get_post_comments	投稿者情報と「いいね！」数・返信数を含む、ページネーション付きコメント一覧
get_video_insights	動画のパフォーマンス：再生数、視聴時間、リアクション
get_page_feed	訪問者の投稿を含むフィード全体

書き込みツール

ツール	説明
create_post	ページにテキスト、リンク、写真の投稿を公開

ユーティリティツール

ツール	説明
refresh_token_info	トークンの有効性、期限、付与されたスコープを確認

指標と 2026 年 6 月の廃止

Meta は 2026 年 6 月 15 日に、以下のページレベルの指標を廃止しました。

廃止された指標	代替指標
page_impressions	page_views_total
page_reach	ページ閲覧者指標（順次導入中）
page_impressions_unique	メディア閲覧者指標（順次導入中）

このサーバーは、廃止されていない指標のみを使用します：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	はい	有効期間の長いページアクセストークン
FB_PAGE_ID	はい	デフォルトの Facebook ページ ID（数値）

開発

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

コントリビュート

Issue と PR を歓迎します。Meta が API を変更した場合（変更されます）、Issue を作成してください。

ライセンス

MIT — LICENSE を参照してください。

---

レックス・ジョーンズ による The SEO Engine の一環として開発されました。