social-mcp

ChromeのCookieを使用して、Metaの全サービス（Facebook、Instagram、Threads）を直接操作します。 完全にローカルで動作し、サードパーティのAPIトークンやOAuthリダイレクトは不要です。

機能

Related MCP server: Meta MCP Server

原理

你的 Chrome（已登入 Facebook）
    ↓ CDP (Chrome DevTools Protocol)
social-mcp 讀取 cookies
    ↓
直接 call Facebook Graph API（用 cookie session）
    ↓
完成發帖 / 讀取收件箱 / 發 IG / 發 Threads

核心的なイノベーション：Facebook Developer Appや PAGE_ACCESS_TOKEN は不要です。Chrome内の実際のログイン状態を直接利用します。

前提条件

• Python 3.11+

• Chrome または Chromium（Facebookにログイン済みであること）

• macOS / Linux

• 推奨：AIpuss-browserデーモンを有効にしていること（social-mcpが自動的に検出し、CDP接続を再利用します）

インストール

# clone 並進入目錄
git clone https://github.com/whypuss/social-mcp.git
cd social-mcp

# 用 uv 安裝（推薦）
uv sync

# 或用 pip
pip install -e .

設定

1. ChromeでのレガシーCookieの使用を許可する（必須）

Facebookはデフォルトで「レガシーCookieを使用するアプリ」をブロックしているため、手動で有効にする必要があります：

1. Facebookのウェブサイトを開き、右上のアイコンをクリック → 設定とプライバシー → 設定

2. 左側のメニュー → セキュリティとログイン

3. 下にスクロールし、「レガシーCookieを使用するアプリを許可」を見つける

4. 「オン」に切り替える

このオプションがない場合は、アカウントがデフォルトで許可されているため、次のステップに進んでください。

2. 環境変数の設定（オプション）

# .env 檔（放在 social-mcp/ 目錄下）
cp .env.example .env
nano .env

# Facebook 粉絲頁 ID（可從粉絲頁網址取得）
# 例如：https://www.facebook.com/MyPage → FACEBOOK_PAGE_ID=MyPage
FACEBOOK_PAGE_ID=你的頁面ID

# Instagram Business 帳號 ID（從 Meta Business Suite 取得）
IG_USER_ID=你的IG帳號數字ID

3. Chromeのログイン確認

Chromeのプロファイル3（名前 MY）でFacebookとInstagramにログインしていることを確認してください。 AIpuss-browserデーモンを使用する場合、デフォルトでこのプロファイルが読み込まれます。

使用方法

MCPサーバーの起動

# 基本啟動
uv run social-mcp

# 除錯模式（看完整日誌）
uv run social-mcp --debug

Claude Desktopへの接続

~/Library/Application Support/Claude/claude_desktop_config.json に以下を追加します：

{
  "mcpServers": {
    "social": {
      "command": "uv",
      "args": ["run", "--project", "/路徑/到/social-mcp", "social-mcp"]
    }
  }
}

Claude Desktopを再起動すると、会話の中で上記のすべてのツールを使用できるようになります。

Hermes Agentへの接続

~/.hermes/config.yaml の mcp セクションに追加するか、直接以下を実行します：

hermes tools enable social

ツール使用例

你：幫我發一篇 Facebook 帖：「測試成功！」
Agent → post_facebook(message="測試成功！")
       → ✅ 成功！URL: https://www.facebook.com/123456789

你：讀取最新的 Messenger 訊息
Agent → get_messenger_inbox(limit=5)
       → ## Messenger 收件箱（5筆）
         1. [2026-04-24 10:00] 王小明：明天開會嗎？
         2. [2026-04-24 09:45] 李小美：收到了，謝謝！

你：回覆王大明（ID: 100001234567890）說「好的，明天見」
Agent → send_messenger(thread_id="100001234567890", message="好的，明天見")
       → ✅ 訊息已發送

AIpuss-browserとの統合について

social-mcpはAIpuss-browserデーモンを自動的に検出します：

1. ~/.agent-browser/default.stream を読み取り、CDP WebSocket URLを取得

2. WebSocket経由でAIpussのChromeセッションに接続

3. CDPから直接Cookieを読み取る（ヘッドレスモードでの document.cookie の制限を回避）

メリット：

• AIpussのChromeには既にログイン状態が含まれているため、別のブラウザを開く必要がない

• 完全にローカルで動作し、Cookieがサードパーティのサーバーを経由することはない

• AIpussデーモンが実行されていない場合は、自動的に独立したChromeを起動するフォールバック機能がある

セキュリティに関する説明

• Cookieは常にローカルに保持：social-mcp は自分のマシン上でのみ動作し、Cookieがサードパーティに送信されることはありません

• 機密データの保存なし：Cookieはメモリ上にのみ存在し、プログラム終了後に消去されます

• 推奨：メインのプロファイルではなく、専用のChromeプロファイルを使用してください

制限事項と既知の問題

開発

# 安裝開發依賴
uv sync --extra dev

# 程式碼檢查
uv run ruff check social_mcp/

# 單元測試
uv run pytest

ライセンス

MIT License

注意：本ツールは個人の自動化目的でのみ使用してください。Facebook/IGに対する大量または自動化された操作は、Metaの利用規約に違反する可能性があるため、リスクを自己判断の上でご利用ください。