FastSocial Instagram Data

Instagram Data MCP 服务

将 AI 助手连接到 FastSocial 的 Instagram Data API，即可查询公开的 Instagram 个人主页、帖子、Reels、快拍、精选动态、评论、话题标签、地点和音频。仅供读取：不会发布内容、关注、点赞或发送消息。

该服务是远程服务。无需安装或运行任何内容：助手通过 Streamable HTTP 与

https://data.fastsocial.co/mcp

通信。首次连接时，浏览器会打开 fastsocial.co 页面，你可以在其中登录并点击 Allow。

此代码库包含插件清单（plugin.json、mcp.json，以及 Cursor 在 .cursor-plugin/ 中读取的副本）、将此服务列入官方 MCP Registry 的 server.json，其名称为 io.github.FastSocialCo/instagram-data-mcp，以及 LobeHub 清单。它不包含任何在你的设备上运行的代码。服务端代码不在此处。

安装

Cursor

从 cursor.directory 安装插件，或将服务添加到 .cursor/mcp.json（仅限一个项目） 或 ~/.cursor/mcp.json（所有项目）：

{
  "mcpServers": {
    "instagram-data": {
      "url": "https://data.fastsocial.co/mcp"
    }
  }
}

打开 Settings，然后选择 MCP 并连接。Cursor 会打开 FastSocial 登录页面。

Claude Code

claude mcp add --transport http instagram-data https://data.fastsocial.co/mcp

然后在 Claude Code 中运行 /mcp，选择 instagram-data 并登录。

Claude 应用（网页和桌面端）

1. 打开 Settings，然后选择 Connectors，并添加自定义连接器。
2. 将 https://data.fastsocial.co/mcp 粘贴为服务 URL。
3. OAuth 客户端 ID 和密钥留空。
4. 连接，然后在打开的 FastSocial 页面上登录。

VS Code 和其他客户端

任何支持通过 Streamable HTTP 使用 MCP 的客户端都可以通过服务 URL 连接。在 VS Code 中，将以下内容添加到 .vscode/mcp.json 并按 Start：

{
  "servers": {
    "instagram-data": {
      "type": "http",
      "url": "https://data.fastsocial.co/mcp"
    }
  }
}

此插件的功能及其发送的数据

插件本身

插件由两个 JSON 文件组成，用于告知客户端服务地址。它不运行代码，没有安装脚本，也不存储任何内容。客户端会自行通过 HTTPS 直接向 https://data.fastsocial.co/mcp 发送每个请求。

客户端发送的内容

• **MCP 握手信息：**客户端的名称和版本，以及它使用的协议版本。
• **每次工具调用：**工具名称及其参数，也就是你要查询的内容：Instagram 用户名或用户 ID、帖子或 Reel 链接、话题标签、搜索词、地点、音频或精选动态 ID，以及分页游标。完整列表见下表。
• **登录令牌或 API 密钥，**置于请求标头中，绝不会放在 URL 里。
• 任何 Web 请求通常会包含的信息，例如你的 IP 地址和客户端的 user agent。

不会发送其他内容。服务端不会看到你的文件、编辑器或对话，只能看到助手放入工具调用中的参数。

返回内容

以 JSON 格式返回公开的 Instagram 数据，以及 meta.credits_remaining。照片和视频以链接形式返回，而不是文件。私密账户会返回 private_account 错误。Instagram 账户所有者可以选择退出；退出后，API 会针对其账户返回 451 opted_out。

只读

所有工具都只读取数据，不会更改 Instagram 上的任何内容。调用唯一会更改的是你当月的剩余额度。服务端会在 tools/list 中将每个工具标记为 readOnlyHint: true 和 openWorldHint: true。没有任何用于写入或删除的工具。

登录

客户端首次连接时，服务会回复需要登录，并说明如何了解详情。随后，客户端会在浏览器中打开 fastsocial.co 的页面。在那里，你可以：

1. 输入邮箱，以及 FastSocial 发给你的验证码，
2. 查看是哪个应用在请求访问，然后点击允许（或拒绝）。

如果你还没有套餐，点击允许时系统会为你创建一个 Free 套餐。你无需在助手中输入密码，插件也不会查看或存储你的凭据。客户端会保存收到的令牌。访问令牌有效期为 1 小时，客户端会使用有效期为 30 天、且每次使用后都会变更的刷新令牌来续期。

若要断开所有已连接的应用，请登录 https://fastsocial.co/cart/api/account，然后点击 New key。与旧密钥关联的登录会立即失效。

面向客户端开发者：发现流程从 https://data.fastsocial.co/.well-known/oauth-protected-resource/mcp 开始。授权服务器面向公共客户端支持 OAuth 2.1 和 PKCE（仅限 S256）、动态客户端注册及令牌撤销。

改用 API 密钥

如果客户端可以设置请求头但无法登录，请前往 https://fastsocial.co/instagram-api?ref=github 获取密钥，并在每个请求中通过 X-API-Key: YOUR_KEY（或 Authorization: Bearer YOUR_KEY）发送。对于 Claude Code：

claude mcp add --transport http instagram-data https://data.fastsocial.co/mcp --header "X-API-Key: YOUR_KEY"

不要将密钥放入要提交的文件中。

政策

• 隐私政策：https://fastsocial.co/privacy
• 条款：https://fastsocial.co/terms
• 数据使用政策（仅限公开数据，不得跟踪或骚扰他人，不得涉及未成年人）：https://fastsocial.co/instagram-api/docs?ref=github
• 报告安全问题：SECURITY.md

28 个工具

每次调用都会消耗月度额度中的积分。调用失败不消耗积分。所有工具均为只读。

工具	功能	参数	积分
instagram_profile	获取 Instagram 个人资料	username 或 user_id	1
instagram_user_id	将 Instagram 用户名转换为用户 ID	username 或 user_id	1
instagram_username	将 Instagram 用户 ID 转换为用户名	user_id	2
instagram_check	检查 Instagram 用户名是否存在且为公开账号	username	1
instagram_posts	获取 Instagram 最新帖子	username 或 user_id、cursor	1
instagram_reels	获取账号的 Instagram Reels	username 或 user_id、cursor	1
instagram_tagged	获取账号被标记的帖子	username 或 user_id、cursor	1
instagram_post	获取一条 Instagram 帖子或 Reel	url 或 shortcode	1
instagram_media	获取帖子、Reel 或轮播帖的下载 URL	url 或 shortcode	1
instagram_comments	获取 Instagram 帖子的评论	url 或 shortcode	3
instagram_comment_replies	获取 Instagram 评论的回复	url 或 shortcode、comment_id、cursor	3
instagram_likers	获取点赞 Instagram 帖子的账号	url 或 shortcode	3
instagram_insights	Instagram 互动率计算器	username 或 user_id	2
instagram_followers	获取账号的粉丝	username 或 user_id、cursor	3
instagram_following	获取账号关注的账号	username 或 user_id、cursor	3
instagram_similar	查找相似的 Instagram 账号	username 或 user_id	1
instagram_stories	匿名查看 Instagram 快拍	username 或 user_id	3
instagram_highlights	获取 Instagram 快拍精选	username 或 user_id	3
instagram_highlight	获取一个精选集中的内容	id	3
instagram_search	搜索 Instagram 账号、话题标签和地点	q	1
instagram_hashtag	获取某个 Instagram 话题标签下的帖子	tag、cursor	1
instagram_place	获取 Instagram 地点信息	id	3
instagram_place_posts	获取标记了某个 Instagram 地点的帖子	id、cursor	1
instagram_audio	获取 Instagram 音频及使用该音频的 Reels	id	1
instagram_audio_search	搜索 Instagram 音乐和音效	q	3
instagram_reels_search	按关键词搜索 Instagram Reels	q、cursor	3
instagram_top_accounts	按日排名的粉丝数最多的 2,000 个账号	sort、limit	0
instagram_usage	查看本月已用和剩余积分	无	0

完整参考文档：https://fastsocial.co/instagram-api/docs?ref=github

可以向它提问

• “比较 @nasa 和 @spacex 的互动率。”
• “下载这个轮播帖的每一张图片：https://www.instagram.com/p/...”
• “显示 @natgeo 当前的快拍并总结内容。”
• “查找 10 个与 @humansofny 相似的账号。”

本地版本

如果你的客户端只能运行本地（stdio）服务，可在 PyPI 上获取相同工具 instagram-data-mcp。它不属于此插件。其源代码位于 FastSocialCo/instagram-data-mcp-python。

链接

• Instagram Data API：https://fastsocial.co/instagram-api?ref=github
• 文档：https://fastsocial.co/instagram-api/docs?ref=github
• OpenAPI 规范：https://fastsocial.co/instagram-api/openapi.json
• MCP Registry 条目：io.github.FastSocialCo/instagram-data-mcp

许可证

MIT。请参阅 LICENSE。