facebook-automata-mcp

MCP (Model Context Protocol) сервер для официального Facebook Graph API. Предоставляет полный набор инструментов для страниц, публикаций, комментариев, лайков/реакций, фото/видео, событий и аналитики, а также специальные инструменты для хранения и проверки ваших учетных данных Facebook.

Установка и запуск

Установка не требуется, если у вас есть uv:

uvx facebook-automata-mcp

Или установите с помощью pip:

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

Использование с MCP-клиентом (например, Claude Desktop / Claude Code)

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

Related MCP server: Facebook MCP Server

Учетные данные

Вам не нужно вручную редактировать файл конфигурации. Как только сервер подключен к вашему MCP-клиенту, просто попросите его (своими словами) настроить Facebook, что вызовет инструмент set_facebook_credentials, например:

"Установите мой токен доступа Facebook на EAAB..."

Это позволит:

1. Проверить токен через GET /me.

2. Сохранить его в ~/.facebook-automata-mcp/credentials.json (создается с правами 0700/0600, только для владельца).

3. Вернуть вашу проверенную личность (id/name).

Поля, которые вы можете указать:

Проверяйте текущие учетные данные в любое время с помощью check_facebook_credentials (выполняет живую проверку) или get_credentials_status (офлайн, просто проверяет наличие файла). Удалите их с помощью clear_facebook_credentials.

Учетные данные также можно указать через переменные окружения вместо (или в дополнение к) сохраненному файлу — переменные окружения всегда имеют приоритет:

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

Получение токена

Самый быстрый способ для страницы — Graph API Explorer от Meta: выберите свое приложение, сгенерируйте токен доступа пользователя с правами pages_show_list, pages_read_engagement, pages_read_user_content, pages_manage_posts и pages_manage_engagement, затем вызовите get_my_accounts здесь, чтобы получить собственный токен доступа вашей страницы (с областью действия страницы), и используйте его как access_token для инструментов уровня страницы.

Инструменты

Учетные данные

• set_facebook_credentials — сохранить и проверить токен

• check_facebook_credentials — живая проверка + информация /debug_token

• get_credentials_status — офлайн-проверка

• clear_facebook_credentials — удалить сохраненные учетные данные

Идентичность

• get_my_profile, get_user_profile, get_my_accounts

Страницы

• 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

Публикации

• get_post, publish_page_post, delete_post

Комментарии

• get_post_comments (включает информацию о том, кто прокомментировал), get_comment, get_comment_replies, publish_comment, reply_to_comment, delete_comment, hide_comment

Лайки / Реакции

• get_post_likes, get_post_reactions (кто + какая реакция), get_comment_likes, get_comment_reactions, like_object, unlike_object

Медиа

• upload_page_photo, upload_page_video

Запасной выход

• graph_api_get, graph_api_post, graph_api_delete — вызвать любую конечную точку Graph API, не охваченную выше

Все инструменты спискового типа принимают limit и after (курсор пагинации из next_cursor предыдущего вызова) и возвращают {ok, data, paging, next_cursor}.

Примечания об ограничениях Facebook API

• Современные версии Graph API ограничивают большинство полей личного профиля и классические данные «кто лайкнул это / список друзей» для обычных пользователей из-за политики конфиденциальности — контент, принадлежащий страницам (публикации страниц, их комментарии и реакции), является основным поддерживаемым сценарием использования.

• Некоторые действия (публикация, удаление, скрытие комментариев, аналитика) требуют токен доступа страницы с соответствующими разрешениями (pages_manage_posts, pages_manage_engagement, read_insights и т. д.) и, для публичных приложений, проверки приложения Meta (Meta App Review).

Разработка

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

Публикация на PyPI

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

После публикации любой может запустить его с помощью uvx facebook-automata-mcp без постоянной установки.

Лицензия

MIT