MCPcopy Index your code
hub / github.com/anysiteio/anysite-mcp-server

github.com/anysiteio/anysite-mcp-server @v0.7.1

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.7.1 ↗ · + Follow
125 symbols 196 edges 3 files 0 documented · 0%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

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🐦 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:
  4. Name: AnySite MCP
  5. OAuth URL: https://api.anysite.io/mcp/sse
  6. 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) ├─

Extension points exported contracts — how you extend this code

Core symbols most depended-on inside this repo

Shape

Interface 63
Function 62

Languages

TypeScript100%

Modules by API surface

src/types.ts110 symbols
src/server.ts9 symbols
src/index.ts6 symbols

For agents

$ claude mcp add anysite-mcp-server \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page