Skip to content

A Model Context Protocol (MCP) server that provides comprehensive access to LinkedIn data and functionalities using the AnySite API, enabling not only data retrieval but also robust management of user accounts.

License

MIT, MIT licenses found

Licenses found

MIT
LICENSE
MIT
LICENSE.md
Notifications You must be signed in to change notification settings

anysiteio/anysite-mcp-server

Repository files navigation

AnySite MCP Server Logo

🌐 AnySite MCP Server

Agent-First Web Scraping Infrastructure via Model Context Protocol

Connect your AI agents to real-time data from LinkedIn, Instagram, Reddit, Twitter, and any website through a single MCP server.

npm version License: MIT GitHub stars Documentation

🚀 Quick Start📖 Documentation🎮 Playground💬 Discord🐦 Twitter


🎯 What is AnySite MCP Server?

AnySite MCP Server is a Model Context Protocol (MCP) implementation that gives AI agents direct access to web data through platform-specific APIs. Unlike traditional web scrapers, AnySite provides:

  • 🔒 OAuth Authentication - Secure, one-click connection for Claude Desktop and other MCP clients
  • 🌐 Multi-Platform Support - LinkedIn, Instagram, Reddit, Twitter, and custom web parsing
  • 🤖 Agent-First Design - Built specifically for AI agents with structured data formats
  • 🔄 Self-Healing APIs - Auto-recovery from platform changes and rate limits
  • ⚡ Real-Time Data - Fresh data extraction without stale caches

Perfect for: AI research, lead generation, market intelligence, content monitoring, competitive analysis


⚡ Key Features

🎪 Supported Platforms

Platform Search Profiles Posts Comments DMs Analytics
LinkedIn
Instagram
Reddit ⚠️
Twitter/X ⚠️ ⚠️
Any Website - - - - -

🛠️ Core Capabilities

  • Advanced Search & Filtering - Find people by title, company, location, education, skills
  • Bulk Data Extraction - Extract thousands of profiles, posts, or comments in one request
  • Network Analysis - Map connections, followers, engagement patterns
  • Content Monitoring - Track posts, comments, reactions in real-time
  • Account Management - Send messages, connection requests, post comments (LinkedIn)
  • Smart Web Parsing - Extract structured data from any website using CSS selectors

🔐 Enterprise-Grade Features

  • Rate Limit Management - Automatic backoff and retry with exponential delays
  • Proxy Rotation - Built-in proxy support for high-volume requests
  • Error Recovery - Self-healing mechanisms for platform changes
  • Usage Analytics - Track API consumption and costs
  • Team Management - Multi-user accounts with role-based access

🚀 Quick Start

Option 1: Remote MCP with OAuth (Recommended)

Perfect for Claude Desktop, Cline, Cursor, Windsurf, and other MCP clients that support OAuth.

Step 1: Get Your OAuth URL

  1. Sign up at app.anysite.io (100 free credits included)
  2. Navigate to MCP Server Integration
  3. Copy your OAuth URL: https://api.anysite.io/mcp/sse

Step 2: Add to Your MCP Client

Claude Desktop (Click to expand)
  1. Open Claude DesktopSettingsConnectors
  2. Click Add Custom Connector
  3. Fill in:
    • Name: AnySite MCP
    • OAuth URL: https://api.anysite.io/mcp/sse
  4. Click AddConnectAllow Access

📖 Detailed Claude Desktop Setup Guide

Cline / Cursor / Windsurf

Add to your MCP configuration file:

{
  "mcpServers": {
    "anysite": {
      "command": "npx",
      "args": ["-y", "@anysite/mcp"],
      "env": {
        "ANYSITE_OAUTH_URL": "https://api.anysite.io/mcp/sse"
      }
    }
  }
}

Configuration file locations:

  • Cline: .cline/mcp_settings.json
  • Cursor: .cursor/mcp_config.json
  • Windsurf: .windsurf/mcp_config.json

Step 3: Verify Connection

Ask your AI agent:

What MCP tools do you have access to?

Expected response should include:

  • search_linkedin_users
  • get_linkedin_profile
  • get_instagram_user
  • search_reddit_posts
  • google_search
  • parse_webpage
  • ... and 50+ more tools

Option 2: Local MCP Server (For Development)

Perfect for testing, development, custom integrations.

Installation

# Clone the repository
git clone https://github.com/anysiteio/anysite-mcp-server.git
cd anysite-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Configuration

Create .env file:

ANYSITE_ACCESS_TOKEN=your_access_token
ANYSITE_ACCOUNT_ID=your_account_id

Get your credentials from app.anysite.io

Run Server

npm start

Connect to MCP Client

Add to your MCP configuration:

{
  "mcpServers": {
    "anysite-local": {
      "command": "node",
      "args": ["/path/to/anysite-mcp-server/build/index.js"],
      "env": {
        "ANYSITE_ACCESS_TOKEN": "your_token",
        "ANYSITE_ACCOUNT_ID": "your_account_id"
      }
    }
  }
}

🎮 Usage Examples

LinkedIn: Find Decision Makers

Find me 10 CTOs at AI companies in San Francisco

The MCP server will:

  1. Search LinkedIn users with title="CTO", company_keywords="AI", location="San Francisco"
  2. Return structured profiles with name, headline, company, location
  3. Provide direct LinkedIn URLs for each profile

Instagram: Monitor Brand Mentions

Get the latest 20 Instagram posts mentioning @yourbrand

Reddit: Analyze Discussions

Search Reddit for posts about "LLM agents" in the last week,
sorted by top engagement

Multi-Platform Research

1. Find the LinkedIn profile of John Doe at Company X
2. Get his recent posts and engagement metrics
3. Find his Twitter profile and latest tweets
4. Cross-reference with Instagram presence

📖 Documentation

📚 Full Documentation

🔧 Tool Categories (57 Total)

LinkedIn Tools (26 tools)

Search & Discovery (7 tools)

  • search_linkedin_users - Advanced user search with 10+ filters
  • linkedin_sn_search_users - Sales Navigator advanced search
  • get_linkedin_email_user - Find users by email address
  • get_linkedin_user_email_db - Batch email lookup (up to 10 profiles)
  • get_linkedin_google_company - Find companies via Google search
  • get_linkedin_company - Company details lookup
  • search_linkedin_posts - Search posts by keywords, author, date

Profile & Data (7 tools)

  • get_linkedin_profile - Full profile with experience, education, skills
  • get_linkedin_user_posts - User's post history
  • get_linkedin_user_reactions - Posts user reacted to
  • get_linkedin_user_comments - User's comment history
  • get_linkedin_user_connections - Network connections
  • get_linkedin_user_endorsers - Skill endorsers
  • get_linkedin_user_certificates - User certificates

Company Intelligence (4 tools)

  • get_linkedin_company_employees - Employee list with filters
  • get_linkedin_company_posts - Company updates
  • get_linkedin_post_reposts - Reshare analysis
  • get_linkedin_conversations - Conversation history

Engagement (4 tools)

  • get_linkedin_post_comments - Comment threads
  • get_linkedin_post_reactions - Who reacted and how
  • get_linkedin_post_reposts - Reshare analysis

Account Management (4 tools) - Requires ACCOUNT_ID

  • get_linkedin_management_me - Get own profile
  • send_linkedin_chat_message - Send DMs
  • get_linkedin_chat_messages - Retrieve conversations
  • send_linkedin_connection - Send connection requests
  • send_linkedin_post_comment - Comment on posts
  • send_linkedin_post - Create posts
Instagram Tools (8 tools)
  • get_instagram_user - Profile info, followers, posts count
  • get_instagram_user_posts - Post history with media
  • get_instagram_user_reels - Reels/videos
  • get_instagram_user_friendships - Followers/following lists
  • get_instagram_post - Post details with metrics
  • get_instagram_post_comments - Comment threads
  • get_instagram_post_likes - Who liked the post
  • search_instagram_posts - Hashtag and keyword search
Twitter/X Tools (5 tools)
  • get_twitter_user - Profile details
  • search_twitter_users - Find users
  • get_twitter_user_posts - Tweet history
  • search_twitter_posts - Advanced tweet search with 15+ filters
  • get_twitter_post - Tweet details
Reddit Tools (3 tools)
  • search_reddit_posts - Search with sort, time, subreddit filters
  • get_reddit_post - Post details with score, comments
  • get_reddit_post_comments - Comment trees with nested replies
Web Parsing Tools (2 tools)
  • parse_webpage - Extract content with 14+ CSS selector options
  • get_sitemap - Parse website sitemaps
Other Tools (3 tools)
  • google_search - Google search with clean results
  • search - ChatGPT Deep Research optimized search
  • fetch - ChatGPT Deep Research optimized profile fetch

🤝 Integrations

AnySite MCP Server works with any MCP-compatible client:

AI Assistants

  • Claude Desktop - Native OAuth support
  • Cline - MCP configuration
  • Cursor - Custom MCP server
  • Windsurf - MCP integration
  • Any MCP Client - Standard protocol

Development Tools

  • 🔧 n8n - AnySite n8n nodes
  • 🔧 LangChain - Custom tool integration
  • 🔧 AutoGen - Agent tool registration
  • 🔧 REST API - Direct API access

Comparison: Remote vs Local

Feature Remote MCP (OAuth) Local MCP
Setup Time < 2 minutes ~10 minutes
Authentication OAuth (secure, one-click) API keys in config
Updates Automatic Manual git pull
Best For Production, end-users Development, testing
Credentials Managed by AnySite Self-managed
Revocation One-click in dashboard Manual removal
MCP Clients Claude Desktop, Cline, etc. Any MCP client

Recommendation: Use Remote MCP for production and Local MCP for development/testing.


🏗️ Architecture

┌─────────────────┐
│   MCP Client    │ (Claude Desktop, Cline, etc.)
│   (AI Agent)    │
└────────┬────────┘
         │ MCP Protocol
         │
┌────────▼────────┐
│  AnySite MCP    │
│     Server      │
└────────┬────────┘
         │ REST API
         │
┌────────▼────────┐
│  AnySite API    │ ← OAuth Authentication
│   Platform      │ ← Rate Limiting
└────────┬────────┘ ← Proxy Rotation
         │
    ┌────┴────┬────────┬─────────┬──────────┐
    ▼         ▼        ▼         ▼          ▼
LinkedIn  Instagram  Reddit  Twitter  Any Website

Key Components:

  • MCP Protocol Layer - Standardized tool interface for AI agents
  • API Abstraction - Platform-specific API adapters with error handling
  • Authentication - OAuth 2.0 for secure credential management
  • Self-Healing - Auto-retry and fallback mechanisms
  • Rate Limiting - Smart backoff to prevent API bans

💡 Use Cases

🎯 Lead Generation & Sales

  • Find decision makers by title, company, location
  • Enrich CRM data with LinkedIn profiles
  • Monitor competitor hiring and expansion

📊 Market Intelligence

  • Track brand mentions across platforms
  • Analyze competitor social media strategy
  • Monitor industry trends and discussions

🔍 Research & Analytics

  • Collect datasets for AI training
  • Social network analysis
  • Content performance tracking

🤖 AI Agent Workflows

  • Multi-platform data correlation
  • Automated outreach campaigns
  • Cross-platform identity resolution

🛠️ Development

Building from Source

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

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run in development mode
npm run dev

# Run tests
npm test

Project Structure

anysite-mcp-server/
├── src/                      # Source code
│   ├── index.ts              # MCP server entry point (Smithery runtime)
│   ├── server.ts             # Server implementation (Traditional MCP)
│   └── types.ts              # TypeScript type definitions
├── build/                    # Compiled JavaScript
│   ├── index.js              # Main entry point
│   ├── server.js             # Server executable
│   ├── types.js              # Type definitions
│   ├── remote-server.js      # Remote server support
│   ├── streamable-server.js  # Streaming support
│   └── smithery.js           # Smithery integration
├── .claude/                  # Claude Code settings
│   └── settings.local.json
├── .cursor/                  # Cursor IDE settings
│   └── rules/
├── .smithery/                # Smithery CLI files
│   └── index.cjs
├── package.json              # npm package configuration
├── package-lock.json
├── tsconfig.json             # TypeScript configuration
├── smithery.yaml             # Smithery config
├── glama.json                # Glama integration
├── .env                      # Environment variables (local)
├── .npmrc                    # npm configuration
├── .gitignore
├── README.md                 # Documentation
├── CLAUDE.md                 # Claude Code instructions
├── LICENSE.md                # MIT License
└── LICENSE

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Areas we need help with:

  • 📝 Documentation improvements
  • 🐛 Bug fixes and testing
  • ✨ New platform integrations
  • 🌍 Translations

📊 Pricing & Limits

Free Tier

  • ✅ 100 free credits on signup
  • ✅ All 57 tools available
  • ✅ OAuth authentication
  • ⚠️ Rate limits apply

Pro Plans

  • 🚀 Higher rate limits
  • 🚀 Priority support
  • 🚀 Dedicated proxies
  • 🚀 Team collaboration

See pricing details


🔒 Security & Privacy

  • OAuth 2.0 - Industry-standard authentication
  • No Credential Storage - Your API keys stay with AnySite
  • Encrypted Transport - All data transmitted over HTTPS
  • GDPR Compliant - Data processing follows EU regulations
  • Revocable Access - One-click disconnect in dashboard

⚠️ Important: Always comply with platform terms of service and local regulations when scraping data.


💬 Community & Support


📄 License

This project is licensed under the MIT License.


🙏 Acknowledgments

Built with:

Special thanks to the MCP community for feedback and contributions.


⭐ Star us on GitHub if AnySite MCP Server helps your AI agents!

Made with ❤️ by the AnySite.io team

WebsiteDocumentationAPI Playground

About

A Model Context Protocol (MCP) server that provides comprehensive access to LinkedIn data and functionalities using the AnySite API, enabling not only data retrieval but also robust management of user accounts.

Resources

License

MIT, MIT licenses found

Licenses found

MIT
LICENSE
MIT
LICENSE.md

Stars

Watchers

Forks

Packages

No packages published