Facebook MCP server for automating posts, comment moderation, insights, and sentiment filtering.
Python
Create README.md
Hagai Henee54f5fcbdf7
diff --git a/README.md b/README.mdnew file mode 100644index 0000000..80f811f--- /dev/null+++ b/README.md@@ -0,0 +1,114 @@+# Facebook MCP Server++This project is a **Modular Command Processor (MCP)** agent for automating and managing interactions on a Facebook Page using the Facebook Graph API. It exposes tools to create posts, moderate comments, fetch post insights, and filter negative feedback — ready to plug into Claude, ChatGPT, or other LLM-based agents.++---++## 🤖 What Is This?++This MCP provides a suite of AI-callable tools that connect directly to a Facebook Page, abstracting common API operations as LLM-friendly functions.++### ✅ Benefits++- Empowers **social media managers** to automate moderation and analytics.+- Seamlessly integrates with **Claude Desktop or OpenAI Agents**.+- Enables fine-grained control over Facebook content from natural language.++---++## 📦 Features++| Tool | Description |+|----------------------------------|---------------------------------------------------------------------|+| `post_to_facebook` | Create a new Facebook post with a message. |+| `reply_to_comment` | Reply to a specific comment on a post. |+| `get_page_posts` | Retrieve recent posts from the Page. |+| `get_post_comments` | Fetch comments on a given post. |+| `delete_post` | Delete a specific post by ID. |+| `delete_comment` | Delete a specific comment by ID. |+| `delete_comment_from_post` | Alias for deleting a comment from a specific post. |+| `filter_negative_comments` | Filter out comments with negative sentiment keywords. |+| `get_number_of_comments` | Count the number of comments on a post. |+| `get_number_of_likes` | Count the number of likes on a post. |+| `get_post_impressions` | Get total impressions on a post. |+| `get_post_impressions_unique` | Get number of unique users who saw the post. |+| `get_post_impressions_paid` | Get number of paid impressions on the post. |+| `get_post_impressions_organic` | Get number of organic impressions on the post. |+| `get_post_engaged_users` | Get number of users who engaged with the post. |+| `get_post_clicks` | Get number of clicks on the post. |+| `get_post_reactions_like_total` | Get total number of 'Like' reactions. |++---++## 🚀 Setup & Installation++### 1. Clone the Repository++```bash+git clone https://github.com/your-org/facebook-mcp-server.git+cd facebook-mcp-server+```++### 2. 🛠️ Installation++Install dependencies using uv, a fast Python package manager:+If uv is not already installed, run:+```bash+curl -Ls https://astral.sh/uv/install.sh | bash+```++Once uv is installed, install the project dependencies:+```bash+uv pip install -r requirements.txt+```++### 3. Set Up Environment++Create a .env file in the root directory and add your Facebook Page credentials.+You can obtain these from https://developers.facebook.com/tools/explorer++```bash+FACEBOOK_ACCESS_TOKEN=your_facebook_page_access_token+FACEBOOK_PAGE_ID=your_page_id+```++## 🧩 Using with Claude Desktop+To set up the FacebookMCP in Clade:++1. Open Clade.+2. Go to Settings → Developer → Edit Config.+3. In the config file that opens, add the following entry:++```bash+"FacebookMCP": {+ "command": "uv",+ "args": [+ "run",+ "--with",+ "mcp[cli]",+ "--with",+ "requests",+ "mcp",+ "run",+ "/path/to/facebook-mcp-server/server.py"+ ]+}+```++---++## ✅ You’re Ready to Go!++That’s it — your Facebook MCP server is now fully configured and ready to power Claude Desktop. You can now post, moderate, and measure engagement all through natural language prompts!++---++## 🤝 Contributing++Contributions, issues, and feature requests are welcome!+Feel free to fork the repo and submit a pull request.++- Create a branch: `git checkout -b feature/YourFeature`+- Commit your changes: `git commit -m 'feat: add new feature'`+- Push to the branch: `git push origin feature/YourFeature`+- Open a pull request 🎉