Socialcrawl MCP

Single API key to access 21 + real time social media data

Give your AI agent access to 48 platforms and 381 endpoints — social media, commerce & product reviews, retail, app stores, places & travel, business reputation, news & finance, web research, full web scraping & browser automation, prediction markets, search trends, cross-platform Prism composites, and a universal meta-search — through a single API, with exact credit pricing for every endpoint

Overview|Installation|Setup|Usage|Tools|Platforms

socialcrawl-mcpis anMCP (Model Context Protocol)server that connects AI agents to theSocialCrawl API— a unified data API covering 48 platforms and 381 endpoints.

claude mcp add --scope user --transport http socialcrawl https://mcp.socialcrawl.dev/mcp \ --header "Authorization: Bearer sc_your_key_here"

{ "mcpServers": { "socialcrawl": { "type": "http", "url": "https://mcp.socialcrawl.dev/mcp", "headers": { "Authorization": "Bearer ${SOCIALCRAWL_API_KEY}" } } } }

Available onnpm. Most users don't need this — the MCP client configs below usenpxand auto-install on first run.

claude mcp add --scope user socialcrawl -- npx -y socialcrawl-mcp

claude mcp add-env socialcrawl SOCIALCRAWL_API_KEY sc_your_key_here

{ "mcpServers": { "socialcrawl": { "command": "npx", "args": ["-y", "socialcrawl-mcp"], "env": { "SOCIALCRAWL_API_KEY": "sc_your_key_here" } } } }

Add to.cursor/mcp.jsonin your project root or~/.cursor/mcp.jsonglobally:

{ "mcpServers": { "socialcrawl": { "command": "npx", "args": ["-y", "socialcrawl-mcp"], "env": { "SOCIALCRAWL_API_KEY": "sc_your_key_here" } } } }

Add to.vscode/mcp.jsonin your project or your user settings:

{ "servers": { "socialcrawl": { "type": "stdio", "command": "npx", "args": ["-y", "socialcrawl-mcp"], "env": { "SOCIALCRAWL_API_KEY": "sc_your_key_here" } } } }

{ "mcpServers": { "socialcrawl": { "command": "npx", "args": ["-y", "socialcrawl-mcp"], "env": { "SOCIALCRAWL_API_KEY": "sc_your_key_here" } } } }

Any MCP client that supports stdio transport can use this server. The general pattern is:

- Command:npx
- Args:["-y", "socialcrawl-mcp"]
- Environment:SOCIALCRAWL_API_KEYset to your API key

Restart your AI client after saving the configuration.

Sign up atsocialcrawl.devand grab your API key from the dashboard. Every account starts with100 free credits— no credit card required.

[!TIP] You can also setSOCIALCRAWL_API_KEYas a system environment variable instead of putting it in the MCP config. The discovery and documentation tools work even without a key — only actual API requests need one.

Ask your AI agent in natural language. The MCP server handles the rest.

Get the TikTok profile for @charlidamelio

The agent callssocialcrawl_requestwithplatform: "tiktok",resource: "profile",params: { handle: "charlidamelio" }and returns structured profile data including followers, bio, verification status, and engagement metrics.

Search YouTube for "machine learning tutorials"

Get the comments on this Instagram post: https://instagram.com/p/CwA1234abcd

Compare the follower counts of @mkbhd on TikTok, Instagram, YouTube, and Twitter

The agent makes 4 sequential API calls — one per platform — and compiles the results into a comparison.

Find the cheapest 65-inch OLED TV across Amazon, Walmart, Target, and eBay

What social media platforms can you access?

Which endpoints can give me video transcripts?

The last one is a cross-platformsocialcrawl_list_endpointssearch — no platform needed, it looks across all 381 endpoints.

Show me exactly how to call the Prism comments endpoint

Is this MCP server's endpoint list up to date?

All three hitsocialcrawl_discoverand cost nothing.

Check what something costs before running it

What would it cost to run a Prism brand-mentions report?

Show me everything I can call for 1 credit

Why did that last call charge me 7 credits instead of 2?

The first two hitsocialcrawl_pricing; the third reads the credit ledger viasocialcrawl_check_balancewithview: "transactions"and shows the deduction and refund rows for thatrequest_id.

How does the SocialCrawl credit system work?

Every response follows a unified envelope format:

{ "success": true, "platform": "tiktok", "endpoint": "/v1/tiktok/profile", "data": { "content": { "text": "...", "media_urls": ["..."] }, "author": { "username": "charlidamelio", "followers": 156000000 }, "engagement": { "likes": 5200, "engagement_rate": 0.045 }, "metadata": { "language": "en", "content_category": "entertainment" } }, "credits_used": 1, "credits_remaining": 99 }

[!NOTE] The same response structure is returned for every platform — no per-platform parsing logic needed.

Four of the nine tools work without an API key — they query local bundled data generated from the backend registry.socialcrawl_request,socialcrawl_check_balance,socialcrawl_monitors, andsocialcrawl_webrequire a key.socialcrawl_discoveruses a key when it has one and falls back to bundled data when it does not.

Discovery — the API describing itself, for free

socialcrawl_discoverdrives the/v1/utility/family: four endpoints that let any client learn the whole API from inside the API, at0 credits. They are served in-process from the endpoint registry — no upstream call, no network hop — so they can never drift from what is actually callable.

socialcrawl_discover action: "freshness"

action: "overview" → ladder, every free endpoint, every flat override, every metered band + rule, cache TTLs, full refund matrix action: "endpoint" → one endpoint's price, rule, price-driving params, paging cost, worst case action: "platform" → a whole platform's cost table action: "list" → rank/filter by cost — "everything I can call for 1 credit", "the 10 most expensive endpoints"

socialcrawl_monitorswraps any registry endpoint or Prism composite in a scheduled, stateful monitor (/v1/monitors/). It re-runs the recipe hourly/daily/weekly (or on a cron), delivers each result to an HMAC-signed webhook, raises alerts on metric thresholds or changes, and keeps a per-run time-series you can read back."Prism answers once; monitors watch it for you."Managing monitors costs 0 credits; each scheduled run bills the recipe's normal cost plus a 1-credit scheduling premium. Seesocialcrawl_get_docstopicmonitorsfor the full contract.

socialcrawl_webdrives the full web-scraping and browser-automation surface (thewebplatform,/v1/web/*) through a singleactionparameter:

- Sync reads—scrape(URL → markdown/HTML/screenshot/links),search(web search with page content),map(discover a site's URLs),extract(LLM structured data from a page).
- Async jobs—crawla whole site,batch_scrapemany URLs, oragent(autonomous multi-step web task); each returns a job you poll withjob_get/job_list, inspect withjob_errors(per-page failures), and stop withjob_cancel.crawl_previewdry-runs a crawl's parameters for free before you pay for it.
- Monitors—monitor_create/list/get/update/delete/checksre-check a URL on a cadence and deliver changes to a webhook.
- Sessions—session_create/get/list,session_execute(run code in the live page),session_close.

Most of the paid web surface is metered rather than flat: a crawl holdslimitcredits and refunds every page it did not crawl; a session holds againstttl_secondsand settles on close. Job, monitor, and session management is 0 credits. Seesocialcrawl_get_docstopicweb, orsocialcrawl_pricingwithplatform: "web".

Before making any API call,socialcrawl_requestmirrors the backend's own pre-billing validator against the bundled registry data: the platform and resource exist, required parameters andoneOfgroups are satisfied, enum values are legal, integers sit inside their declared range, parameter couplings hold (orderneedssort; Reddit'stimeframeneedssort=top), and CSV lists are within their entry limits. A malformed call fails instantly and for free instead of costing a round trip — and an agent gets told exactly what to fix rather than looping on a call that can never succeed.

Pass anidempotencyKeytosocialcrawl_request(UUIDv4 recommended) to make the call retry-safe. If the request is replayed within 24h, the server returns the original response and deducts0 credits(X-Idempotent-Replay: true).

Total: 381 endpoints across 48 platforms.

The MCP server handles errors gracefully and gives the agent actionable guidance:

- Get Your API Key— 100 free credits, no credit card required
- API Documentation— full endpoint reference, credits, and error codes
- SocialCrawl Website
- npm Package
- MCP Registry
- Getting Started Guide
- How It Works

Transforms any blog/article URL into ready-to-post social media content for Twitter/X, LinkedIn, Instagram, Facebook, and email. Hosted on Apify, zero setup, pay-per-event ($0.07).