socialscrape

Name: socialscrape
Author: socialscrape.dev

远程服务

socialscrape.dev社交媒体01 天前更新

代码仓库访问官网

关于 socialscrape

socialscrape 是面向 Agent 和 MCP 客户端的社交媒体数据 MCP 服务，提供多个平台的个人资料、帖子、搜索和转录内容。它将端点工具归类为常用任务和平台专属访问。

主要功能

01跨平台查询个人资料和帖子
02搜索及获取评论
03获取转录内容
04平台专属端点工具
05批量调用与异步任务跟踪

适用场景

01跨平台研究个人资料和帖子
02获取评论或转录内容以供分析
03批量请求社交数据端点

MCP 相关

向 MCP 客户端提供社交媒体数据工具，包括搜索、个人资料、帖子、评论和转录内容。支持托管式 Streamable HTTP 和本地 stdio 模式。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://api.socialscrape.dev/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http dev-socialscrape-socialscrape https://api.socialscrape.dev/mcp

Cursor.cursor/mcp.json{"mcpServers":{"dev-socialscrape-socialscrape":{"type":"http","url":"https://api.socialscrape.dev/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"dev-socialscrape-socialscrape":{"type":"http","url":"https://api.socialscrape.dev/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"dev-socialscrape-socialscrape":{"type":"http","url":"https://api.socialscrape.dev/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"dev-socialscrape-socialscrape":{"serverUrl":"https://api.socialscrape.dev/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

安装包

pypisocialscrape-mcp0.1.3stdio

工具

参数	类型	必填	说明
url	string	是	视频或帖子的链接：YouTube、TikTok、Instagram、X、Facebook、LinkedIn、Reddit、Twitch 或 Kick 片段、Rumble。
offset	integer	否	继续获取较长文字记录时使用的字符偏移量（使用上一次响应中的 next_offset）。继续请求可从缓存免费获取。
language	string	否	首选语言代码，例如 en。可选。
max_chars	integer	否	单次响应中返回的文本片段长度上限。
include_timestamps	boolean	否	同时返回带有开始时间的片段。响应大小会翻倍；除非需要时间信息，否则请勿启用。
allow_long_transcription	boolean	否	使用 AI 转录超过 2 分钟的音频，按整段视频每开始 1 分钟收取 5 个积分（10 分钟 = 50）。如果不启用此选项，且视频超过该时长又没有字幕，则免费返回 transcript_unavailable。对较长视频启用此选项前，请先征求确认。

详细介绍

socialscrape-mcp

SocialScrape MCP 服务：为 Claude、ChatGPT、Cursor 及任何其他 MCP 客户端提供社交媒体数据（个人资料、帖子、评论、搜索、广告、转录文本）。SocialScrape 在 https://api.socialscrape.dev/mcp 托管此服务；此软件包是可在自己的机器上运行的同一服务。

此服务根据 SocialScrape 的端点注册表生成，并按组整理，让 Agent 看到数量适中的可用工具，而不是每个端点对应一个工具：

工具	用途
`get_transcript`、`search`、`get_profile`、`get_post`、`get_comments`	Agent 在各平台最常执行的任务。平台作为参数传入。
每个平台一个工具（`github`、`facebook`、`twitter` 等）	`resource` 选择数据（`user`、`profile.posts` 等）；参数依此设置。
`describe`	精确参数、允许的值、价格和示例参数。免费，不调用 API。
`call_endpoint`、`batch`、`get_job`、`monitors`、`get_credits`	按 ID 调用任意端点、一次调用最多发送 100 个请求、异步任务、Webhook、余额。

只有已构建的端点才会显示为工具。某个平台的端点构建完成后，该平台会在下个版本中显示。

每个结果都以 ok | credits charged: 1 | credits remaining: 4999 开头（结构化副本也会将这些数字作为字段提供）。失败不收费，并会以 isError 返回，同时包含 API 的错误代码、retryable 标志以及后续操作说明。

使用方法

托管版（主要方式）。 SocialScrape 在 https://api.socialscrape.dev/mcp（可流式传输的 HTTP）运行此服务。登录有两种方式。

登录，无需复制密钥。将 URL 添加为连接器，然后使用 SocialScrape 账号登录并批准连接。
- Claude：Settings、Connectors、Add custom connector，粘贴 URL。
- ChatGPT：使用该 URL 添加连接器，并选择 OAuth。
- Cursor：使用该 URL 添加服务，并在提示时登录。
- Claude Code：运行 claude mcp add --transport http socialscrape https://api.socialscrape.dev/mcp，然后运行 /mcp 登录。
在标头中使用 API 密钥：x-api-key: ss_live_...。
- Claude Code：claude mcp add --transport http socialscrape https://api.socialscrape.dev/mcp --header "x-api-key: ss_live_..."
- Cursor，在 ~/.cursor/mcp.json 中：

{ "mcpServers": { "socialscrape": {
    "url": "https://api.socialscrape.dev/mcp",
    "headers": { "x-api-key": "ss_live_..." } } } }

每个已登录的连接都会在控制面板中显示为名为 "MCP connector" 的密钥。调用费用会像使用任何密钥一样计入团队；撤销该密钥会断开相应连接器。工具与此软件包中的工具相同。向 URL 添加 ?platforms=github,threads 或 ?toolsets=core 可缩小列表范围。

本地版（此软件包）。 对于离线客户端，或希望在自己的机器上运行服务的情况，MCP 客户端会通过 stdio 将其作为子进程启动：

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

可在 https://socialscrape.dev/sign-up?utm_source=github&utm_medium=repo&utm_campaign=socialscrape-mcp 获取密钥。无需密钥即可发现工具；不带密钥调用工具时，会说明如何添加密钥。

减少工具数量。 某些客户端会限制工具数量（Cursor 超过 40 个时会发出警告）。可在 env 区块中缩小列表范围：

	设置
仅包含部分平台	`SOCIALSCRAPE_PLATFORMS=github,threads`
仅包含跨平台工具和账号工具	`SOCIALSCRAPE_TOOLSETS=core`
仅包含平台工具	`SOCIALSCRAPE_TOOLSETS=platforms`

即使只使用 core，Agent 仍可通过 describe 和 call_endpoint 访问所有端点。

自行通过 HTTP 提供服务。 若要在自己控制的主机上运行托管服务的自有副本，请安装额外组件：pip install 'socialscrape-mcp[http]'，然后运行 socialscrape-mcp http --host 127.0.0.1 --port 8080。每个请求都要在 x-api-key 标头（或 Authorization: Bearer ...）中携带自己的密钥；?platforms= 和 ?toolsets= 可缩小工具范围。此副本由你运行并负责安全。

设置（环境）

变量	默认值
`SOCIALSCRAPE_API_KEY`	none	仅适用于 stdio；HTTP 模式会读取每个请求的密钥
`SOCIALSCRAPE_API_URL`	`https://api.socialscrape.dev`
`SOCIALSCRAPE_MCP_TRIM`	`1`	请求 `trim=true`（不含 null 字段和 `extra`），除非某个调用另有说明；可节省上下文
`SOCIALSCRAPE_MCP_MAX_CHARS`	`100000`	答案的最长字符数；较长的列表会截断至完整条目，文字稿会按窗口返回（`offset`）
`SOCIALSCRAPE_MCP_TIMEOUT`	`70`	等待 API 的秒数
`SOCIALSCRAPE_MCP_ALLOWED_ORIGINS`	any	仅适用于 HTTP 模式；以逗号分隔的列表，设置后可拒绝来自其他来源的浏览器调用
`SOCIALSCRAPE_PLATFORMS`、`SOCIALSCRAPE_TOOLSETS`	all	见上文