Search / io.github.RidioDevelopment/socialcrawl
SocialCrawl
R0· no sign-inOne API for 65 platforms and 572 endpoints: social, commerce, retail, jobs, finance, web scraping.
v1.10.0 · active · repository · descriptor JSON · versions
Search / io.github.RidioDevelopment/socialcrawl
R0· no sign-inOne API for 65 platforms and 572 endpoints: social, commerce, retail, jobs, finance, web scraping.
v1.10.0 · active · repository · descriptor JSON · versions
{
"mcpServers": {
"socialcrawl": {
"type": "http",
"url": "https://mcp.socialcrawl.dev/mcp",
"headers": {
"Authorization": "Bearer ${SOCIALCRAWL_TOKEN}"
}
}
}
}claude mcp add --transport http socialcrawl https://mcp.socialcrawl.dev/mcp --header "Authorization: Bearer ${SOCIALCRAWL_TOKEN}"[mcp_servers.socialcrawl]
url = "https://mcp.socialcrawl.dev/mcp"
bearer_token_env_var = "SOCIALCRAWL_TOKEN"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"socialcrawl": {
"type": "remote",
"url": "https://mcp.socialcrawl.dev/mcp",
"enabled": true,
"headers": {
"Authorization": "Bearer {env:SOCIALCRAWL_TOKEN}"
}
}
}
}{
"mcpServers": {
"socialcrawl": {
"type": "http",
"url": "https://mcp.socialcrawl.dev/mcp",
"headers": {
"Authorization": "Bearer ${SOCIALCRAWL_TOKEN}"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=socialcrawl&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLnNvY2lhbGNyYXdsLmRldi9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJCZWFyZXIgJHtTT0NJQUxDUkFXTF9UT0tFTn0ifX0%3D"
}{
"servers": {
"socialcrawl": {
"type": "http",
"url": "https://mcp.socialcrawl.dev/mcp",
"headers": {
"Authorization": "Bearer ${SOCIALCRAWL_TOKEN}"
}
}
}
}{
"mcpServers": {
"socialcrawl": {
"httpUrl": "https://mcp.socialcrawl.dev/mcp",
"headers": {
"Authorization": "Bearer ${SOCIALCRAWL_TOKEN}"
}
}
}
}extensions:
"socialcrawl":
enabled: true
name: "socialcrawl"
type: streamable_http
uri: "https://mcp.socialcrawl.dev/mcp"
headers:
"Authorization": "Bearer ${SOCIALCRAWL_TOKEN}"
timeout: 300
Placeholders to fill from your own secret store: ${SOCIALCRAWL_TOKEN}. The registry never accepts secret values.
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28protocol.statelessonly applies to 2026-07-28 serversprotocol.transportstreamable HTTPprotocol.list_ttlonly applies to 2026-07-28 serversauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_lengthdescriptions are concisetools.schemasevery tool has an object input schematools.annotations7 of 7 tools declare readOnlyHint or destructiveHinttools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHinttools.token_costabout 2,558 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes30 tool changes in 30 daysstability.rug_pull1 tools kept their name but changed most of their description in 30 days; review before trusting themdeps.known_vulnsno known advisory in 98 resolved packagesdeps.mcp_sdk_version@modelcontextprotocol/sdk 1.30.1 has 1 known advisory (GHSA-6qxp-vccf-f47h); update @modelcontextprotocol/sdk to 1.31.0 or laterdeps.resolvable[email protected] resolved: 98 packagessocialcrawl_managechangeddescriptionStateful work by area + action: monitors (scheduled recipes, webhooks, alerts), cohorts (mention search over your own panel of accounts), web (scrape, search, crawl and agent jobs, change monitors, browser sessions) and jobs (Prism background jobs). A wrong field is refused free with the rules. Managing is free; scrapes, jobs, queries and monitor runs bill credits. dry_run: true validates and quotes a create/update and never creates it.
Stateful work by area + action: monitors (scheduled recipes, webhooks, alerts), cohorts (mention search over your own panel of accounts), web (scrape, search, crawl and agent jobs, change monitors, browser sessions) and jobs (Prism background jobs). A wrong field is refused free with the rules. Managing is free; scrapes, jobs, queries and monitor runs bill credits. dry_run: true validates and quotes a create/update and never creates it. rows_new alerts need track (id=monitors).
socialcrawl_findchangeddescriptionStart here: a task in plain words -> the best endpoints (3 by default) of 645, each with the params the task supplies (URLs and @handles resolved), the params still missing, the credit cost and the exact call. With no task it lists platforms, or one platform's endpoints. Free; no key needed.
Start here: a task in plain words -> the best endpoints (3 by default) of 646, each with the params the task supplies (URLs and @handles resolved), the params still missing, the credit cost and the exact call. With no task it lists platforms, or one platform's endpoints. Free; no key needed.
socialcrawl_managechangeddescription, input schemaStateful work by area + action: monitors (scheduled recipes, webhooks, alerts), cohorts (mention search over your own panel of accounts), web (scrape, search, crawl and agent jobs, change monitors, browser sessions) and jobs (Prism background jobs). A wrong field is refused free with the rules. Managing is free; scrapes, jobs, queries and monitor runs bill credits.
Stateful work by area + action: monitors (scheduled recipes, webhooks, alerts), cohorts (mention search over your own panel of accounts), web (scrape, search, crawl and agent jobs, change monitors, browser sessions) and jobs (Prism background jobs). A wrong field is refused free with the rules. Managing is free; scrapes, jobs, queries and monitor runs bill credits. dry_run: true validates and quotes a create/update and never creates it.
socialcrawl_accountchangedoutput schemasocialcrawl_collectchangeddescription, input schema, output schemaWalk a paged endpoint to `items` unique rows, the last page or max_credits in one call: cursors supplied, duplicates dropped, stops on a 402, refused free when one page exceeds max_credits. Returns a summary and a link to every row (JSONL, JSON or CSV). Spends credits.
Walk a paged endpoint (id, platform+resource or path) to `items` unique rows, the last page or max_credits: cursors supplied, duplicates dropped, stops on a 402, refused free when one page exceeds max_credits. Small results come back whole. result_id (+offset, limit, format) reads a stored result, free. Spends credits.
socialcrawl_requestchangeddescription, input schema, output schemaCall one endpoint. structuredContent: rows, credits (used, remaining), paging (has_more, next_cursor). Validated locally first (a bad call is free), quoted, refused above max_credits and confirmed above the threshold. A large page is cut at row boundaries with a link to the full body. Spends credits; needs SOCIALCRAWL_API_KEY.
Call one endpoint (platform+resource, or id, or path). Validated locally first (a bad call is free), quoted, refused above max_credits and confirmed above the threshold. A large page is cut at row boundaries; socialcrawl_collect result_id reads the rest. Spends credits; needs SOCIALCRAWL_API_KEY.
socialcrawl_estimatechangeddescription, input schema, output schemaExact credits before you spend: one call (id plus the params you will send; calls for a job total; items for a walk) or a plan of several calls. Uses the API's estimator when available, else the bundled pricing. A platform slug gives its price table; no id gives the pricing overview. Free.
Exact credits before you spend: one call (id, platform+resource or path, plus the params you will send; calls for a job total; items for a walk) or a plan of several calls. Uses the API's estimator when available, else the bundled pricing. A platform slug gives its price table; no id gives the pricing overview. Free.
socialcrawl_endpointchangeddescriptionRead before calling: one endpoint's purpose, params, where the rows are and up to 25 response fields, cost rule, paging, latency, timeout, next endpoints and a sample link. Also takes a platform slug (its endpoints) or a guide topic (errors, pricing, pagination, judgments). Free.
Read before calling: one endpoint's purpose, params, where the rows are and up to 25 response fields, cost rule, paging, latency, timeout, next endpoints and a sample link. id (or platform+resource, path), a platform slug (its endpoints) or a guide topic. Free.
socialcrawl_check_balanceremovedCheck the credit balance and the credit ledger for the authenticated SocialCrawl account. Default view calls GET /v1/credits/balance (balance + recent-deduction summary); `view: "transactions"` calls GET /v1/credits/transactions for dispute-grade itemised receipts — every deduction and refund with its amount, balance_after, endpoint, and request_id, which is how you confirm what a metered endpoint actually charged after its upfront hold was refunded down. Both cost 0 credits. Requires a valid SOCIALCRAWL_API_KEY.
socialcrawl_list_platformsremovedList all 67 platforms available through SocialCrawl (631 endpoints — social media, commerce, marketplaces & product reviews, retail (Amazon, Walmart, Target, Home Depot, eBay, Klarna, AliExpress, Etsy, Sephora, H&M, Kohl's, Wayfair, Gumtree, Google Shopping), app stores, places, travel & local (Tripadvisor, Yelp, Google Business), business & software reputation (Trustpilot, G2), jobs & salaries, markets & finance, US congressional trading, news, web research and full scraping/browser automation, on-page SEO audits, prediction markets, search trends, Korean search (Naver), Chinese social (Douyin, Xiaohongshu), Product Hunt, content analysis, and cross-platform Prism composites). Grouped by category, with each platform's endpoint count, credit range, and available data. No API key required.
Showing the latest 10. Full history: list_changes · trend: quality JSON.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +reachable +uptime-96% ~updated-41d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
[email protected] npm97 dependencies, resolved · MCP SDK @modelcontextprotocol/sdk 1.30.1 · advisories checked 2026-10-19
| advisory | severity | package | fixed in |
|---|---|---|---|
| GHSA-6qxp-vccf-f47hMCP TypeScript SDK: OAuth client could send credentials to an authorization server chosen by the MCP server | high | @modelcontextprotocol/[email protected]MCP SDK, direct | fixed in 1.31.0 |
Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://mcp.socialcrawl.dev/mcp streamable-http | none | yes | 96% | 391 ms | 2025-11-25 | 2026-10-19 |
| package | registry | version | runtime | secrets |
|---|---|---|---|---|
socialcrawl-mcp | npm | 1.10.0 | – | SOCIALCRAWL_API_KEY |
socialcrawl_accountread-only | Free checks: balance (with this session's spend), transactions (itemised ledger; the receipts for one request_id), status (platform health; read it before retrying a 502/503) and freshness (whether this server's bundled catalogue is behind the API). |
socialcrawl_collect | Walk a paged endpoint (id, platform+resource or path) to `items` unique rows, the last page or max_credits: cursors supplied, duplicates dropped, stops on a 402, refused free when one page exceeds max_credits. Small results come back whole. result_id (+offset, limit, format) reads a stored result, free. Spends credits. |
socialcrawl_endpointread-only | Read before calling: one endpoint's purpose, params, where the rows are and up to 25 response fields, cost rule, paging, latency, timeout, next endpoints and a sample link. id (or platform+resource, path), a platform slug (its endpoints) or a guide topic. Free. |
socialcrawl_estimateread-only | Exact credits before you spend: one call (id, platform+resource or path, plus the params you will send; calls for a job total; items for a walk) or a plan of several calls. Uses the API's estimator when available, else the bundled pricing. A platform slug gives its price table; no id gives the pricing overview. Free. |
socialcrawl_findread-only | Start here: a task in plain words -> the best endpoints (3 by default) of 646, each with the params the task supplies (URLs and @handles resolved), the params still missing, the credit cost and the exact call. With no task it lists platforms, or one platform's endpoints. Free; no key needed. |
socialcrawl_managedestructive | Stateful work by area + action: monitors (scheduled recipes, webhooks, alerts), cohorts (mention search over your own panel of accounts), web (scrape, search, crawl and agent jobs, change monitors, browser sessions) and jobs (Prism background jobs). A wrong field is refused free with the rules. Managing is free; scrapes, jobs, queries and monitor runs bill credits. dry_run: true validates and quotes a create/update and never creates it. rows_new alerts need track (id=monitors). |
socialcrawl_request | Call one endpoint (platform+resource, or id, or path). Validated locally first (a bad call is free), quoted, refused above max_credits and confirmed above the threshold. A large page is cut at row boundaries; socialcrawl_collect result_id reads the rest. Spends credits; needs SOCIALCRAWL_API_KEY. |
Schemas: list_tools.
{
"name": "io.github.RidioDevelopment/socialcrawl",
"title": "SocialCrawl",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://mcp.socialcrawl.dev/mcp",
"type": "streamable-http",
"headers": [
{
"name": "Authorization",
"isSecret": true,
"description": "Bearer <SOCIALCRAWL_API_KEY>. Optional — discovery tools work without it. Get a free key at socialcrawl.dev (100 credits, no credit card required)."
}
]
}
],
"version": "1.10.0",
"packages": [
{
"version": "1.10.0",
"transport": {
"type": "stdio"
},
"identifier": "socialcrawl-mcp",
"registryType": "npm",
"environmentVariables": [
{
"name": "SOCIALCRAWL_API_KEY",
"format": "string",
"isSecret": true,
"isRequired": true,
"description": "Your SocialCrawl API key. Get a free key at socialcrawl.dev (100 credits, no credit card required)."
}
]
}
],
"repository": {
"url": "https://github.com/RidioDevelopment/socialcrawl-mcp",
"source": "github"
},
"description": "One API for 65 platforms and 572 endpoints: social, commerce, retail, jobs, finance, web scraping."
}