Social Fetch

Social Fetch MCP

让你的编码 Agent 在构建时获取真实的社交媒体和网络数据。

文档 | API 参考 | 额度与账单

服务 URL： https://api.socialfetch.dev/mcp

这是什么？

Social Fetch MCP 将 Cursor、VS Code、Claude、Windsurf 和其他 MCP 客户端连接到 Social Fetch API。安装后，你的 Agent 可以在编辑器中查找创作者、获取帖子、搜索平台、阅读网页、查看余额，以及阅读 Social Fetch 文档。

当你希望 Agent 回答以下问题时，可以使用它：

• “找到这位 TikTok 创作者，并将他们最新的视频添加到我的应用中。”
• “获取这段 YouTube 视频的文字稿，并总结其中的赞助内容。”
• “获取这篇 Instagram 帖子，检查响应结构，并将其接入我的后端。”
• “阅读 Social Fetch 文档，并为 Reddit 搜索选择合适的端点。”

MCP 服务由 Social Fetch 托管：

https://api.socialfetch.dev/mcp

无需从此仓库克隆、构建或运行本地服务。客户端通过托管的 Streamable HTTP 端点连接，并在浏览器中使用 OAuth 进行身份验证。

为什么要使用它？

当 Agent 能使用与你的应用相同的 API 时，效果会更好。它们可以直接通过经过身份验证的途径访问 Social Fetch，无需你在文档、控制面板、脚本和粘贴的 JSON 之间来回切换。

• 减少设置工作： 直接从 Agent 调用 Social Fetch 工具。
• 获得更好的回答： Agent 可以先搜索并阅读实时文档，再选择端点。
• 让真实数据参与其中： 在编辑器中使用 TikTok、Instagram、YouTube、X/Twitter、Reddit、Spotify、网络等平台进行测试。
• 无需在编辑器配置中填写 API 密钥： 只需使用 OAuth 登录一次。
• 到处使用相同的 API： MCP 工具映射到公共 REST API、SDK 和文档。

可获取的数据

Social Fetch MCP 提供以下端点工具：

• TikTok、Instagram、YouTube、X/Twitter、Telegram、Facebook、Threads、LinkedIn、Reddit 和 Spotify 数据。
• 个人资料、帖子、视频、评论、文字稿、搜索结果及平台专属元数据。
• 网页 Markdown 生成和 AI 辅助网页提问。
• 账户身份信息和额度余额。
• 通过 docs_search 和 docs_read 获取 Social Fetch 文档。

端点工具按 REST API 的方式计量。文档工具、auth_whoami 和 billing_balance_get 不会消耗查询额度。

要求

• 一个 Social Fetch 账户。
• 用于按量计费 API 路由的额度。
• 支持远程 Streamable HTTP 和 OAuth 的 MCP 客户端，例如 Cursor、VS Code、Claude Code、Claude Desktop 或 MCP Inspector。

一键安装

• 在 Cursor 中安装
• 在 VS Code 中安装
• 在 Windsurf 中安装
• 打开托管的安装页面

安装后，请完成浏览器中的 OAuth 流程。如果一键链接没有反应——编辑器未安装、阻止了自定义 URL 方案，或没有对应的处理程序——请使用下面的手动设置。

手动设置

Cursor

将以下内容添加到 ~/.cursor/mcp.json 或项目的 .cursor/mcp.json：

{
  "mcpServers": {
    "socialfetch": {
      "url": "https://api.socialfetch.dev/mcp"
    }
  }
}

重启 Cursor，打开 MCP 设置，并在出现提示时完成浏览器中的 OAuth 流程。

VS Code

将以下内容添加到 settings.json：

{
  "mcp": {
    "servers": {
      "socialfetch": {
        "url": "https://api.socialfetch.dev/mcp"
      }
    }
  }
}

Claude Code

claude mcp add --transport http socialfetch https://api.socialfetch.dev/mcp

然后运行 /mcp 并验证 Social Fetch，以完成 OAuth 流程。

Claude Desktop

添加自定义远程 MCP 连接器，并使用以下 URL：

https://api.socialfetch.dev/mcp

Claude 提示时，请授权 Social Fetch。

仅支持 stdio 的客户端

如果你的客户端仅支持 stdio MCP 服务，请使用 mcp-remote 桥接到托管服务：

npx mcp-remote https://api.socialfetch.dev/mcp

将客户端指向该命令启动的 stdio 进程。

身份验证

Social Fetch MCP 使用 OAuth 2.1。MCP 客户端会处理此流程：

1. 客户端会在浏览器中打开 Social Fetch 登录页面。
2. 登录或创建帐户并批准访问。
3. 客户端会收到访问令牌，并在每次 MCP 请求中携带该令牌。

请勿将 Social Fetch API 密钥粘贴到 MCP 配置中。费用会计入已登录的帐户，与 REST API 请求一样。

工具

tools/list 会公开端点工具和文档工具。

端点工具名称与 API 操作 ID 相同，只是将点替换为下划线：

工具名称	API 操作
tiktok_profile_get	tiktok.profile.get
instagram_post_get	instagram.post.get
web_markdown_generate	web.markdown.generate
auth_whoami	auth.whoami
billing_balance_get	billing.balance.get

每个端点工具的参数都与对应 API 路由参数一致。完整的端点目录、参数架构、响应结构和定价，请参阅 API 参考。

此外还提供两个文档工具：

工具名称	用途
docs_search	搜索 Social Fetch 文档，涵盖 API、SDK、身份验证、错误、额度和集成。
docs_read	按路径名以 Markdown 格式读取完整文档页面，例如 /docs/sdk。

推荐的 Agent 提示词：

使用 Social Fetch MCP 文档，通过 TypeScript SDK 为此应用添加 TikTok 个人资料查询功能。

示例：TikTok 个人资料

在 Cursor、MCP Inspector 或其他 MCP 客户端中，调用 tiktok_profile_get 并传入：

{ "handle": "nike" }

结果包含与 REST API 返回内容相同的 data 和 meta 封装。对于按量计费的调用，请检查 meta.creditsCharged 和 meta.requestId。

故障排查

症状	检查内容
每次调用都返回 401	重新连接服务并再次完成 OAuth。你的令牌可能缺失或已过期。
OAuth 重定向循环	在 Social Fetch 完成登录，然后批准访问以返回客户端。
返回 402	你的账户在此按量计费的路由上额度不足。请在额度与账单中充值。
未列出任何工具	重新连接服务。如果问题仍然存在，请重启 MCP 客户端。
客户端仅支持 stdio	使用 npx mcp-remote https://api.socialfetch.dev/mcp。

仓库内容

• server.json - 托管远程服务的 MCP Registry 元数据。
• examples/ - 可直接复制粘贴的 MCP 客户端配置片段。
• assets/socialfetch-mark.svg - Social Fetch 标志的本地副本（也通过 https://api.socialfetch.dev/mcp/icon.svg 提供）。

实现位于 Social Fetch 的私有 API 服务中，不在此公开列表仓库中。

相关链接

• Social Fetch MCP 文档
• Social Fetch API 参考
• TypeScript SDK
• n8n 社区节点

许可证

MIT (c) Social Freak Ltd