MCP Server

The official MCP (Model Context Protocol) server for ByCrawl — query 12 social media platforms directly from AI agents like Claude, Cursor, and Windsurf.

npm · 64 tools · 12 platforms

New to ByCrawl? Start with Getting Started to create an account and get your API key.

Setup

Create your account

Add the connector

Claude Desktop (Recommended)

The easiest way — no install, no API key needed:

Open Claude Desktop → Settings → Connectors
Click Add custom connector
Paste this URL:


https://mcp.bycrawl.com/mcp

Click Connect and authorize with your byCrawl account

That’s it! Claude will now have access to all byCrawl tools.

Claude Code


claude mcp add bycrawl -e BYCRAWL_API_KEY=sk_byc_xxx -- npx -y @bycrawl/mcp

Replace sk_byc_xxx with your API key from the API Keys page.

Cursor / Other

Add to your MCP config file:

Cursor: .cursor/mcp.json in your project root
Other MCP clients: check your client’s documentation for the config file location


{
  "mcpServers": {
    "bycrawl": {
      "command": "npx",
      "args": ["-y", "@bycrawl/mcp"],
      "env": {
        "BYCRAWL_API_KEY": "sk_byc_xxx"
      }
    }
  }
}

Start using it

Ask your AI agent to query social media data. For example:

“Search Threads for posts about AI agents”
“Get the LinkedIn profile for OpenAI”
“Find trending TikTok videos about cooking”
“What are the latest Reddit posts in r/webdev?”

Available Tools

The MCP server exposes 64 tools across 12 platforms:

Platform	Tools	Examples
Threads	8	Search posts, get user profile/replies, public feed
X / Twitter	4	Search tweets, get user timeline
Facebook	4	Get page, search posts, get post by URL
Reddit	5	Get subreddit, search posts, get user
LinkedIn	7	Get company, search jobs/users, get post
Xiaohongshu (RED)	9	Search notes, get comments, resolve share URL
TikTok	7	Get video, search, comments, subtitles, browse by category
Instagram	5	Search hashtags, get user/post, comments, user posts
YouTube	5	Get video/channel, search, comments, transcription
Dcard	6	Get post/forum, search posts, comments, persona
104 Job Bank	3	Search jobs, get company/job details
System	1	Health check

Environment Variables

Variable	Required	Default	Description
`BYCRAWL_API_KEY`	Yes	—	Your ByCrawl API key
`BYCRAWL_API_URL`	No	`https://api.bycrawl.com`	API base URL (for self-hosting)

Example Workflows

Competitive intelligence

“Use ByCrawl to find what people on Reddit and X are saying about [competitor]. Summarize the sentiment.”

Lead research

“Look up this person’s LinkedIn profile and their recent Threads posts. Draft a personalized outreach message.”

Content research

“Search YouTube and TikTok for trending videos about [topic]. What formats are performing best?”

Job market analysis

“Search 104 Job Bank and LinkedIn for senior frontend roles in Taipei. Compare salary ranges and requirements.”