SocialCrawl

io.github.RidioDevelopment由 GitHub 账号 RidioDevelopment 发布v1.10.0更新于 Oct 24, 2026

One API for 65 platforms and 572 endpoints: social, commerce, retail, jobs, finance, web scraping.

已验证Streamable HTTP可网页运行网页搜索与抓取沟通与协作数据与分析

概览

AI 生成的概览

SocialCrawl 让助手通过一个统一 API 发现并调用社交媒体、电商与网页抓取端点,并在消耗额度前估算费用。

可以做什么
  • 发现端点:把自然语言任务转成匹配的端点,附参数、缺失项与额度成本,或列出平台及其端点
  • 查看与计价:读取端点的参数、返回字段、分页与计费规则,并估算单次调用或多次调用方案的确切额度
  • 获取数据:调用单个端点获取主页、帖子、评论、搜索结果、热门内容与分析数据,调用前本地校验
  • 分页采集:按目标唯一行数或额度上限遍历分页端点,并通过结果 ID 读取已存结果
  • 查看账户:查看额度余额、交易明细、平台健康状态与目录新鲜度
  • 管理有状态任务:带 webhook 与告警的监控、账号群组、网页抓取/搜索/爬取任务与后台任务
适用场景
适合需要用一个凭证从多个平台获取社交媒体或网页数据的场景,例如查询主页、抓取帖子与评论、关键词搜索或趋势监控。免费的发现与估算工具可先确认可行性与成本,再决定是否消耗额度。
运行要求
可作为远程端点使用,也可作为本地 npm 包 socialcrawl-mcp 通过 stdio 运行,通常用 npx 启动。付费调用需要 SocialCrawl 账号与 API 密钥,通过 SOCIALCRAWL_API_KEY 环境变量或 Authorization bearer 头提供;发现类工具无需密钥。需要能访问 SocialCrawl API 的网络。
安装前请注意
socialcrawl_request 与 socialcrawl_collect 会消耗付费账户额度,应设置额度上限与确认阈值。API 密钥是可计费的机密,勿放入共享配置。管理类工具会创建和修改监控、webhook、后台任务等有状态资源。查询内容与目标网址会发送给第三方服务。

安装

在 SourceWeft 中

  1. 打开 控制台中的 SocialCrawl,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.RidioDevelopment%2Fsocialcrawl/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "socialcrawl": {
      "type": "http",
      "url": "https://mcp.socialcrawl.dev/mcp"
    }
  }
}

README

socialcrawl-mcp

[npm version] [License: MIT]

MCP server for SocialCrawl — access 21+ social media platforms through one unified API.

What it does

SocialCrawl MCP gives AI agents instant access to 21 social media platforms and 105 endpoints through a single, unified API. Retrieve profiles, posts, comments, search results, trending content, and analytics from TikTok, Instagram, YouTube, Twitter/X, LinkedIn, Reddit, and more — no per-platform authentication required. Agents discover available endpoints dynamically, so they always work with the latest capabilities without any hardcoded platform logic.

Quick Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Cursor

Add to .cursor/mcp.json in your project root or ~/.cursor/mcp.json globally:

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

VS Code (Claude Code)

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

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

Get Your API Key

  1. Sign up at socialcrawl.com — no credit card required
  2. Receive 100 free credits instantly upon registration
  3. Copy your API key from the dashboard and paste it into your config

Available Tools

ToolDescription
socialcrawl_list_platformsDiscover all 21 supported platforms with their slugs and endpoint counts
socialcrawl_list_endpointsSee all endpoints, required parameters, and credit costs for a specific platform
socialcrawl_requestMake any SocialCrawl API call — fetch profiles, posts, comments, search results, and more
socialcrawl_get_docsAccess detailed API documentation for a platform or specific endpoint

Example

User prompt: "Get the TikTok profile for charlidamelio"

Agent flow:

  1. Calls socialcrawl_list_endpoints with platform: "tiktok" to discover available endpoints
  2. Finds user/info endpoint — takes a username parameter, costs 1 credit
  3. Calls socialcrawl_request with platform: "tiktok", endpoint: "user/info", params: { username: "charlidamelio" }
  4. Returns profile data: follower count, bio, video count, verification status, and more

Supported Platforms

PlatformEndpoints
TikTok24
Instagram12
YouTube11
Facebook12
X (Twitter)6
LinkedIn6
Reddit7
Threads5
Pinterest4
Google4
Truth Social3
Twitch2
Snapchat1
Kick1
Amazon1
Linktree1
Linkbio1
Linkme1
Komi1
Pillar1
Utility1

Total: 105 endpoints across 21 platforms

Credit System

TierCostShare of Endpoints
Standard1 credit~90%
Advanced5 credits~8%
Premium10 credits~2%

New accounts receive 100 free credits — enough to make 100 standard requests or explore multiple platforms before committing to a paid plan.

License

MIT — see LICENSE for details.

来源:README.md,提交 0a6edbb

工具

7

socialcrawl_find

Find the Endpoint for a Task

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.

输入参数tasklimitplatform

socialcrawl_endpoint

Endpoint Contract

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.

输入参数id必填pagemethod

socialcrawl_estimate

Estimate Credit Cost

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.

输入参数idbodyplancallsitemsmethodparams

socialcrawl_request

Call an Endpoint

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.

输入参数bodyfieldsformatmethodparamsconfirmplatform必填resource必填max_itemsmax_creditsidempotencyKey

socialcrawl_collect

Collect Rows Across Pages

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.

输入参数iditemslimitfieldsformatoffsetparamsconfirmresult_idmax_credits

socialcrawl_account

Account and Service Status

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).

输入参数viewlimitcursorrequest_id

socialcrawl_manage

Manage Monitors, Cohorts, Web and Jobs

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).

输入参数idarea必填inputaction必填dry_runidempotencyKey

版本历史

1
  1. v1.10.0最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分