facebook-mcp-сервер

Facebook MCP-сервер

Этот проект представляет собой сервер MCP для автоматизации и управления взаимодействиями на странице Facebook с использованием API Facebook Graph. Он предоставляет инструменты для создания постов, модерации комментариев, получения аналитических сведений о постах и фильтрации негативных отзывов — готовый к подключению к Claude или другим агентам на основе LLM.

🤖 Что это?

Этот MCP предоставляет набор инструментов, вызываемых с помощью ИИ, которые подключаются напрямую к странице Facebook, абстрагируя общие операции API в виде функций, совместимых с LLM.

✅ Преимущества

Позволяет менеджерам социальных сетей автоматизировать модерацию и аналитику.
Легко интегрируется с Claude Desktop или любым клиентом Agent .
Обеспечивает точный контроль над контентом Facebook на естественном языке.

📦 Особенности

Инструмент	Описание
`post_to_facebook`	Создайте новую публикацию на Facebook с сообщением.
`reply_to_comment`	Ответить на конкретный комментарий к посту.
`get_page_posts`	Получить последние сообщения со страницы.
`get_post_comments`	Получить комментарии к указанному посту.
`delete_post`	Удалить конкретную запись по идентификатору.
`delete_comment`	Удалить конкретный комментарий по идентификатору.
`delete_comment_from_post`	Псевдоним для удаления комментария из определенного поста.
`filter_negative_comments`	Отфильтровывать комментарии с ключевыми словами с негативной тональностью.
`get_number_of_comments`	Подсчитайте количество комментариев к посту.
`get_number_of_likes`	Подсчитайте количество лайков под публикацией.
`get_post_impressions`	Получите общее количество показов поста.
`get_post_impressions_unique`	Получите количество уникальных пользователей, которые увидели публикацию.
`get_post_impressions_paid`	Получите количество платных показов поста.
`get_post_impressions_organic`	Получите количество органических показов поста.
`get_post_engaged_users`	Получите количество пользователей, которые взаимодействовали с публикацией.
`get_post_clicks`	Получите количество кликов по посту.
`get_post_reactions_like_total`	Получите общее количество реакций «Нравится».
`get_post_top_commenters`	Получите список самых популярных комментаторов поста.
`post_image_to_facebook`	Опубликуйте изображение с подписью на странице Facebook.
`send_dm_to_user`	Отправьте прямое сообщение пользователю.
`update_post`	Обновляет сообщение существующей публикации.

🚀 Настройка и установка

1. Клонировать репозиторий

git clone https://github.com/your-org/facebook-mcp-server.git
cd facebook-mcp-server

2. 🛠️ Установка

Установите зависимости с помощью uv, быстрого менеджера пакетов Python: Если uv еще не установлен, выполните:

curl -Ls https://astral.sh/uv/install.sh | bash

После установки uv установите зависимости проекта:

uv pip install -r requirements.txt

3. Настройка среды

Создайте файл .env в корневом каталоге и добавьте учетные данные вашей страницы Facebook. Вы можете получить их по адресу https://developers.facebook.com/tools/explorer

FACEBOOK_ACCESS_TOKEN=your_facebook_page_access_token
FACEBOOK_PAGE_ID=your_page_id

🧩 Использование с Claude Desktop

Чтобы настроить FacebookMCP в Clade:

Открытая клада.
Перейдите в Настройки → Разработчик → Изменить конфигурацию.
В открывшемся файле конфигурации добавьте следующую запись:

"FacebookMCP": {
  "command": "uv",
  "args": [
    "run",
    "--with",
    "mcp[cli]",
    "--with",
    "requests",
    "mcp",
    "run",
    "/path/to/facebook-mcp-server/server.py"
  ]
}

✅ Вы готовы к работе!

Вот и все — ваш сервер Facebook MCP теперь полностью настроен и готов к работе с Claude Desktop. Теперь вы можете публиковать, модерировать и измерять вовлеченность — все это с помощью подсказок на естественном языке!

🤝 Вклад

Приветствуются ваши вклады, сообщения о проблемах и запросы на новые функции!
Не стесняйтесь создавать ответвления репозитория и отправлять запрос на извлечение.

Создайте ветку: git checkout -b feature/YourFeature
Зафиксируйте изменения: git commit -m 'feat: add new feature'
Отправка в ветку: git push origin feature/YourFeature
Откройте запрос на извлечение 🎉

facebook-mcp-server