SocialAPIs MCP Server: Unified Social Media API for AI-Proxy Data Access

MCP Server

Social media Research and data .JavaScript

rating : 2 points

downloads : 4.6K

update time : 2025-12-29

What is SocialAPIs MCP Server?

SocialAPIs MCP Server is a social media data access tool specifically designed for AI assistants. Through the Model Context Protocol (MCP), AI assistants like Claude can directly query and analyze social media data, such as Facebook page information, post content, and user interactions. You don't need to write code or handle complex API authentication. Simply configure it easily to let the AI assistant obtain social media data for you.

How to use SocialAPIs MCP Server?

Using SocialAPIs is very simple: 1) Register to get an API key; 2) Configure the MCP server in Claude Desktop; 3) After restarting Claude, you can directly ask questions related to social media. For example, you can ask Claude: 'Get the details of Nike's Facebook page', and Claude will obtain and analyze the relevant data through SocialAPIs.

Applicable scenarios

SocialAPIs is particularly suitable for: brand monitoring (tracking brand performance on social media), competitor analysis (comparing the social media strategies of different brands), content strategy research (analyzing which types of content get more interactions), and market research (understanding industry trends and user feedback). Whether you are a marketer, brand manager, or researcher, you can quickly obtain social media insights through an AI assistant.

Main features

Unified social media API

Access data from multiple social media platforms through a single interface without having to learn the APIs of different platforms separately.

AI - first design

Optimized specifically for AI assistants like Claude and Cursor, providing a natural language query interface.

Rich data types

Supports obtaining various data types such as page information, post content, comments, interaction data, and video details.

Advanced filtering function

Supports filtering data by time range, pagination, etc., to obtain accurate social media information.

Simple authentication

Uses API key authentication without a complex OAuth process, and the configuration is simple and fast.

Full support for Facebook

Supports complete functions such as Facebook pages, groups, posts, videos, and comments.

Advantages

No programming knowledge required: Ordinary users can access social media data through an AI assistant.

Simple configuration: Only an API key and a few lines of configuration are needed to use it.

Rich data: Provides detailed social media metrics and analysis data.

High security: The API key is stored locally and not transmitted to third - parties.

Fast response: Provides low - latency services through the global edge network.

Transparent cost: Offers a free package and a clear pricing plan.

Limitations

Currently, it mainly supports the Facebook platform, and functions for other platforms are under development.

The free package has a request limit of 200 times per month.

Requires Claude Desktop or other AI assistants that support MCP.

Some advanced functions require a paid package.

How to use

Get an API key

Visit the socialapis.io website to register an account and get your API key in the console.

Install the MCP server

Install the SocialAPIs MCP package globally via npm.

Configure Claude Desktop

Edit the configuration file of Claude Desktop and add the SocialAPIs MCP server configuration.

Restart and start using

Restart Claude Desktop, and then you can directly ask Claude questions related to social media.

Usage examples

Brand monitoring

Monitor the performance of a specific brand on social media and detect abnormal situations in a timely manner.

Competitor analysis

Compare the performance of different brands on social media to understand the market competition situation.

Content strategy research

Analyze which types of content get better interactions on social media.

User feedback analysis

Understand users' real feedback and emotional tendencies towards a brand or product.

Frequently Asked Questions

Is SocialAPIs free?

Which social media platforms are supported?

Is programming knowledge required?

How is data security ensured?

What is the response speed like?

In addition to Claude, are other AI assistants supported?

Related resources

Official website

The official website of SocialAPIs, containing the latest information and registration entry.

Complete documentation

Detailed technical documentation and usage guides.

API reference

Complete API interface descriptions and parameter documentation.

MCP usage guide

Configuration and usage tutorials specifically for MCP integration.

GitHub repository

An open - source code repository containing examples and contribution guides.

Discord community

Join the community to get support, share experiences, and provide feedback and suggestions.

Example projects

Practical usage cases and example code.

🚀 SocialAPIs MCP Server

Unified social media API for AI agents, offering a single interface to access multiple social platforms and providing rich data for AI - powered analysis.

🚀 Quick Start

Installation

npm install -g @socialapis/mcp

Configuration

Add to your Claude Desktop config:

macOS:

nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows:

notepad %APPDATA%\Claude\claude_desktop_config.json

🔧 Configuration

Method 1: Command Line Argument (Recommended for Claude Desktop)

{
  "mcpServers": {
    "socialapis": {
      "command": "npx",
      "args": ["-y", "@socialapis/mcp", "YOUR_API_KEY"]
    }
  }
}

Method 2: Environment Variable

# Set environment variable
export SOCIALAPIS_API_KEY=your_api_key_here

# Run without argument
npx @socialapis/mcp

Method 3: .env File (For Development)

# Copy example file
cp .env.example .env

# Edit with your values
nano .env

.env file:

SOCIALAPIS_API_KEY=your_api_key_here
MCP_PROXY_URL=https://mcp.socialapis.io

Environment Variables

Property	Details
`SOCIALAPIS_API_KEY`	Your SocialAPIs API key (Required)
`MCP_PROXY_URL`	MCP proxy server URL. Defaults to `https://mcp.socialapis.io`
`PORT`	HTTP server port. Defaults to `3001`
`API_BASE_URL`	Backend API URL. Defaults to `https://api.socialapis.io/v1`

Get API Key

Sign up at socialapis.io
Go to Dashboard
Copy your API key
Replace YOUR_API_KEY in config

Test It

Restart Claude Desktop and ask:

Get Nike's Facebook page details

✨ Features

🌐 Unified API - One interface for multiple platforms
🤖 AI - First - Built for Claude, Cursor, and AI agents
📊 Rich Data - Posts, comments, engagement metrics
🔍 Advanced Filtering - Time ranges, pagination
🎯 Simple Auth - No OAuth complexity
⚡ Fast - Global edge network
🔒 Secure - API keys stay local

🛠️ Available Tools

Facebook Pages

facebook_get_page_id - Extract page ID from URL
facebook_get_page_details - Get page info, followers, likes
facebook_get_page_posts - Fetch posts with time filtering
facebook_get_page_reels - Get reels/short videos

Facebook Groups

facebook_get_group_id - Extract group ID from URL
facebook_get_group_details - Get group metadata
facebook_get_group_posts - Fetch group posts

Facebook Posts

facebook_get_post_id - Extract post ID from URL
facebook_get_post_details - Get reactions, comments, shares
facebook_get_post_attachments - Get media attachments
facebook_get_video_details - Get video metadata
facebook_get_post_comments - Fetch comments with pagination

More platforms coming soon: Instagram, TikTok, YouTube, Twitter

💻 Usage Examples

Brand Monitoring

Monitor Nike's Facebook page and alert me if engagement drops below average

Competitive Analysis

Compare engagement rates between Nike, Adidas, and Puma over the last month

Content Strategy

What types of posts get the most engagement on Coca - Cola's Facebook page?

Sentiment Analysis

Analyze comments on our recent posts and identify common themes

🔧 Technical Details

Architecture

Claude Desktop
    ↓
@socialapis/mcp (local MCP client)
    ↓
https://mcp.socialapis.io (global proxy)
    ↓
https://api.socialapis.io (data API)

Why this architecture?

✅ Low latency (global edge network)
✅ High reliability (99.9% uptime)
✅ Auto rate limiting
✅ Smart caching
✅ Your API key stays local

Local Setup

# Clone repository
git clone https://github.com/SocialAPIsHub/mcp-server.git
cd mcp-server

# Install dependencies
npm install

# Run MCP client
npm start YOUR_API_KEY

# Run HTTP proxy server
npm run serve

Project Structure

mcp-server/
├── src/
│   └── tools.js          # Tool definitions
├── mcp-wrapper.js        # MCP client (runs locally)
├── server.js             # HTTP proxy server
├── package.json
├── Dockerfile
└── README.md

Testing

# Test MCP client locally
node mcp-wrapper.js YOUR_API_KEY

# Test HTTP proxy
curl http://localhost:3001/health
curl http://localhost:3001/tools

# Test specific tool
curl -X POST http://localhost:3001/proxy \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"facebook_get_page_details","arguments":{"link":"https://facebook.com/nike"}}'

📊 Pricing

Plan	Requests/Month	Price
Free	200	$0
Starter	30,000	$49
Pro	120,000	$179
Enterprise	Unlimited	Custom

View detailed pricing →

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for details.

Quick Contribution Guide

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📚 Documentation

💬 Support

📧 Email: support@socialapis.io
💬 Discord: discord.gg/socialapis
🐛 Issues: GitHub Issues
📚 Docs: docs.socialapis.io

🗺️ Roadmap

[x] Facebook API support
[x] MCP server implementation
[x] HTTP proxy server
[x] npm package published
[ ] Instagram support
[ ] TikTok support
[ ] YouTube support
[ ] Twitter/X support
[ ] Real - time webhooks
[ ] Advanced analytics
[ ] Python SDK
[ ] LangChain integration

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Built with Model Context Protocol
Powered by Anthropic Claude
Inspired by the AI agent community

🌟 Star History

**Made with ❤️ by the SocialAPIs Team** [Website](https://socialapis.io) • [Twitter](https://twitter.com/socialapis) • [Discord](https://discord.gg/socialapis)