Socialscrape

dev.socialscrape由 socialscrape.dev 发布v0.1.2更新于 Nov 7, 2026

Social media data for agents: profiles, posts, comments, search, ads, transcripts.

已验证STDIO仅桌面网页搜索与抓取数据与分析

概览

AI 生成的概览

本地 MCP 服务器，让助手通过 SocialScrape 获取社交媒体数据：跨平台的主页、帖子、评论、搜索、广告和转录文本。

可以做什么
  • 跨平台获取转录文本、搜索、主页、帖子和评论，平台作为参数传入
  • 按平台调用工具，并选择 user、profile.posts 等资源
  • 在不发起 API 调用的情况下查看任意端点的确切参数、允许值、价格和示例参数
  • 按 id 调用任意端点、一次批量最多 100 个请求、管理异步任务与监控、查询积分余额
适用场景
当助手需要通过一个付费 API 从多个平台获取社交媒体内容或账号数据，用于调研、监控或内容分析，而不想自行抓取各站点时适用。
运行要求
作为本地 stdio 进程由 MCP 客户端启动，从 socialscrape-mcp 的 PyPI 包安装（例如通过 uvx）。需要 SocialScrape 账号，并在 SOCIALSCRAPE_API_KEY 中提供 API 密钥；无密钥时仍可发现工具。可选设置可限定平台与工具集，并调整 API 地址、响应长度和超时。
安装前请注意
调用会消耗 SocialScrape 账户中的付费积分，批量调用一次最多可发出 100 个请求。API 密钥是放在环境变量中的机密。结果会发送到 SocialScrape 的 API。可选的自行托管 HTTP 模式需由你负责安全，包括允许来源和每请求密钥。

安装

在 SourceWeft 中

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

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

socialscrape-mcp

The SocialScrape MCP server: social media data (profiles, posts, comments, search, ads, transcripts) for Claude, Cursor and any other MCP client that starts a local server.

It is generated from SocialScrape's endpoint registry and grouped so an agent sees a usable number of tools instead of one per endpoint:

ToolsWhat
get_transcript, search, get_profile, get_post, get_commentsThe jobs agents do most, across platforms. The platform is an argument.
one per platform (github, facebook, twitter, ...)resource picks the data (user, profile.posts, ...); parameters follow.
describeExact parameters, allowed values, price, example arguments. Free, no API call.
call_endpoint, batch, get_job, monitors, get_creditsAny endpoint by id, up to 100 requests in one call, async jobs, webhooks, balance.

Only built endpoints appear as tools. A platform shows up in the next release after its endpoints are built.

Every result starts with ok | credits charged: 1 | credits remaining: 4999 (and the structured copy carries the numbers as fields). Failures are free and come back as isError with the API's error code, a retryable flag and what to do next.

Use it

The server runs on your own machine. Your MCP client (Claude Desktop, Claude Code, Cursor) starts it as a subprocess over stdio. SocialScrape does not run a hosted MCP server, so there is no MCP URL to connect to.

json
{ "mcpServers": { "socialscrape": {    "command": "uvx", "args": ["socialscrape-mcp"],    "env": { "SOCIALSCRAPE_API_KEY": "ss_live_..." } } } }

Get a key at https://socialscrape.dev/sign-up?utm_source=github&utm_medium=repo&utm_campaign=socialscrape-mcp. Tool discovery works without a key; a tool call without one explains how to add it.

Fewer tools. Some clients cap the number of tools (Cursor warns past 40). Narrow the list in the env block:

Setting
only some platformsSOCIALSCRAPE_PLATFORMS=github,threads
only the cross-platform and account toolsSOCIALSCRAPE_TOOLSETS=core
only the platform toolsSOCIALSCRAPE_TOOLSETS=platforms

With core alone an agent still reaches every endpoint through describe and call_endpoint.

Serve it over HTTP yourself. For a client that can only reach a URL, install the extra and run the server on a host you control: pip install 'socialscrape-mcp[http]', then socialscrape-mcp http --host 127.0.0.1 --port 8080. Each request carries its own key in the x-api-key header (or Authorization: Bearer ...), and ?platforms= and ?toolsets= narrow the tools. This is yours to run and secure; SocialScrape does not offer it as a service.

Settings (environment)

VariableDefault
SOCIALSCRAPE_API_KEYnonestdio only; the HTTP mode reads each request's key
SOCIALSCRAPE_API_URLhttps://api.socialscrape.dev
SOCIALSCRAPE_MCP_TRIM1ask for trim=true (no null fields, no extra) unless a call says otherwise; saves context
SOCIALSCRAPE_MCP_MAX_CHARS100000longest answer; longer lists are cut to whole items, transcripts come in windows (offset)
SOCIALSCRAPE_MCP_TIMEOUT70seconds to wait for the API
SOCIALSCRAPE_MCP_ALLOWED_ORIGINSanyHTTP mode only; comma list, set it to refuse browser calls from other origins
SOCIALSCRAPE_PLATFORMS, SOCIALSCRAPE_TOOLSETSallsee above

来源：README.md，提交 5c6fecd

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.2最新Nov 7, 2026

评分

已满足适用检查项的 50%

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

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分