social-mcp

Opere directamente con el ecosistema de Meta: Facebook, Instagram y Threads usando las cookies de Chrome. Ejecución totalmente local, sin necesidad de tokens de API de terceros ni redirecciones OAuth.

Funciones

Related MCP server: Meta MCP Server

Principio de funcionamiento

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

Innovación principal: No requiere una aplicación de desarrollador de Facebook, no requiere PAGE_ACCESS_TOKEN, utiliza directamente tu estado de inicio de sesión real en Chrome.

Requisitos previos

• Python 3.11+

• Chrome o Chromium (con Facebook ya iniciado sesión)

• macOS / Linux

• Recomendado: Tener habilitado el demonio AIpuss-browser (social-mcp detectará y reutilizará automáticamente la conexión CDP)

Instalación

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

# 用 uv 安裝（推薦）
uv sync

# 或用 pip
pip install -e .

Configuración

1. Permitir que Chrome use cookies heredadas (Obligatorio)

Facebook bloquea por defecto las "aplicaciones que usan cookies heredadas", debes activarlo manualmente:

1. Abre la página web de Facebook, haz clic en tu foto de perfil en la esquina superior derecha → Configuración y privacidad → Configuración

2. Menú de la izquierda → Seguridad e inicio de sesión

3. Desplázate hacia abajo y busca "Permitir aplicaciones que usan cookies heredadas"

4. Cambia a "Activado"

Si no ves esta opción, significa que tu cuenta ya lo permite por defecto, continúa con el siguiente paso.

2. Configurar variables de entorno (Opcional)

# .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. Confirmar que Chrome ha iniciado sesión

Asegúrate de que tu perfil 3 de Chrome (llamado MY) haya iniciado sesión en Facebook e Instagram. Si usas el demonio AIpuss-browser, leerá este perfil por defecto.

Modo de uso

Iniciar el servidor MCP

# 基本啟動
uv run social-mcp

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

Conectar a Claude Desktop

En ~/Library/Application Support/Claude/claude_desktop_config.json añade:

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

Reinicia Claude Desktop y podrás usar todas las herramientas anteriores en tus conversaciones.

Conectar a Hermes Agent

En el bloque mcp de ~/.hermes/config.yaml añade, o usa directamente:

hermes tools enable social

Ejemplos de uso de herramientas

你：幫我發一篇 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="好的，明天見")
       → ✅ 訊息已發送

Sobre la integración con AIpuss-browser

social-mcp detectará automáticamente el demonio AIpuss-browser:

1. Lee ~/.agent-browser/default.stream para obtener la URL de WebSocket de CDP

2. Se conecta a la sesión de Chrome de AIpuss a través de WebSocket

3. Lee las cookies directamente desde CDP (evitando las restricciones de document.cookie en modo headless)

Ventajas:

• El Chrome de AIpuss ya contiene tu estado de inicio de sesión, no necesitas abrir otro navegador

• Ejecución totalmente local, las cookies no pasan por ningún servidor de terceros

• Si el demonio AIpuss no está en ejecución, se iniciará automáticamente un Chrome independiente como respaldo

Notas de seguridad

• Las cookies permanecen siempre locales: social-mcp solo se ejecuta en tu propia máquina, las cookies no se envían a terceros

• No se almacenan datos sensibles: las cookies solo existen en la memoria y desaparecen al finalizar el programa

• Recomendación: Usa un perfil de Chrome dedicado en lugar de tu perfil principal

Limitaciones y problemas conocidos

Desarrollo

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

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

# 單元測試
uv run pytest

Licencia

MIT License

Nota: Esta herramienta es solo para uso personal de automatización. Las operaciones masivas o automatizadas en Facebook/IG pueden violar los términos de servicio de Meta, por favor evalúa los riesgos por tu cuenta.