facebook-automata-mcp

Servidor MCP (Model Context Protocol) para la API oficial de Facebook Graph. Expone un conjunto completo de herramientas para Páginas, Publicaciones, Comentarios, Me gusta/Reacciones, Fotos/Videos, Eventos e Insights, además de herramientas dedicadas para almacenar y validar tus credenciales de Facebook.

Instalación y ejecución

No necesitas instalar nada si tienes uv:

uvx facebook-automata-mcp

O instala con pip:

pip install facebook-automata-mcp
facebook-automata-mcp

Uso con un cliente MCP (p. ej. Claude Desktop / Claude Code)

{
  "mcpServers": {
    "facebook": {
      "command": "uvx",
      "args": ["facebook-automata-mcp"]
    }
  }
}

Related MCP server: Facebook MCP Server

Credenciales

No necesitas editar ningún archivo de configuración manualmente. Una vez que el servidor esté conectado a tu cliente MCP, solo pídele (con tus propias palabras) que configure Facebook, lo que llamará a la herramienta set_facebook_credentials, por ejemplo:

"Configura mi token de acceso de Facebook a EAAB..."

Esto hará lo siguiente:

1. Validará el token contra GET /me.

2. Lo guardará en ~/.facebook-automata-mcp/credentials.json (creado con permisos 0700/0600, solo para el propietario).

3. Devolverá tu identidad validada (id/nombre).

Campos que puedes proporcionar:

Comprueba las credenciales actuales en cualquier momento con check_facebook_credentials (realiza una llamada de validación en vivo) o get_credentials_status (sin conexión, solo comprueba que el archivo existe). Elimínalas con clear_facebook_credentials.

Las credenciales también se pueden proporcionar mediante variables de entorno en lugar de (o además de) el archivo almacenado — las variables de entorno siempre tienen prioridad:

FACEBOOK_AUTOMATA_MCP_ACCESS_TOKEN=...
FACEBOOK_AUTOMATA_MCP_APP_ID=...
FACEBOOK_AUTOMATA_MCP_APP_SECRET=...
FACEBOOK_AUTOMATA_MCP_PAGE_ID=...
FACEBOOK_AUTOMATA_MCP_API_VERSION=v21.0
FACEBOOK_AUTOMATA_MCP_HOME=/custom/path   # overrides ~/.facebook-automata-mcp

Cómo obtener un token

La forma más rápida para una Página es el Graph API Explorer de Meta: selecciona tu aplicación, genera un token de acceso de usuario con pages_show_list, pages_read_engagement, pages_read_user_content, pages_manage_posts y pages_manage_engagement, luego llama a get_my_accounts aquí para obtener el token de acceso propio de tu Página (con ámbito de página) y úsalo como access_token para las herramientas a nivel de Página.

Herramientas

Credenciales

• set_facebook_credentials — guarda y valida un token

• check_facebook_credentials — validación en vivo + información de /debug_token

• get_credentials_status — comprobación sin conexión

• clear_facebook_credentials — elimina las credenciales almacenadas

Identidad

• get_my_profile, get_user_profile, get_my_accounts

Páginas

• search_pages, get_page_info, get_page_posts, get_page_feed, get_page_tagged_posts, get_page_events, get_page_photos, get_page_videos, get_page_albums, get_page_insights

Publicaciones

• get_post, publish_page_post, delete_post

Comentarios

• get_post_comments (incluye quién comentó), get_comment, get_comment_replies, publish_comment, reply_to_comment, delete_comment, hide_comment

Me gusta / Reacciones

• get_post_likes, get_post_reactions (quién y qué reacción), get_comment_likes, get_comment_reactions, like_object, unlike_object

Multimedia

• upload_page_photo, upload_page_video

Vía de escape

• graph_api_get, graph_api_post, graph_api_delete — llama a cualquier edge de Graph API no cubierto anteriormente

Todas las herramientas de tipo lista aceptan limit y after (cursor de paginación del next_cursor de la llamada anterior) y devuelven {ok, data, paging, next_cursor}.

Notas sobre las limitaciones de la API de Facebook

• Las versiones modernas de Graph API restringen la mayoría de los campos de perfiles personales y los datos clásicos de "a quién le gusta esto / lista de amigos" para usuarios normales debido a la política de privacidad — el contenido propiedad de Páginas (publicaciones de la Página, sus comentarios y reacciones) es el caso de uso principal admitido.

• Algunas acciones (publicar, eliminar, ocultar comentarios, insights) requieren un token de acceso de Página con los permisos correspondientes (pages_manage_posts, pages_manage_engagement, read_insights, etc.) y, para aplicaciones públicas, la revisión de la aplicación de Meta (Meta App Review).

Desarrollo

python -m venv .venv && source .venv/bin/activate
pip install -e .
facebook-automata-mcp

Publicar en PyPI

pip install build twine
python -m build
twine upload dist/*

Una vez publicado, cualquiera puede ejecutarlo con uvx facebook-automata-mcp sin instalar nada de forma permanente.

Licencia

MIT