FastSocial Instagram Data

npx add-mcp 'https://data.fastsocial.co/mcp'

Instagram Data MCP 伺服器

將您的 AI 助理連接到 FastSocial 的 Instagram Data API，即可查詢公開的 Instagram 個人檔案、貼文、Reels、限時動態、精選動態、留言、主題標籤、地點和音訊。此伺服器為唯讀：它絕不會發布貼文、追蹤、按讚或傳送訊息。

此伺服器為遠端伺服器。無需安裝或執行任何程式：您的助理透過 Streamable HTTP 與

https://data.fastsocial.co/mcp

通訊。首次連線時，您的瀏覽器會開啟 fastsocial.co 頁面，您需在該頁面登入並按一下「允許」。

此儲存庫包含外掛程式清單（plugin.json、mcp.json 以及 Cursor 在 .cursor-plugin/ 中讀取的副本）、在官方 MCP Registry 中將伺服器列為 io.github.FastSocialCo/instagram-data-mcp 的 server.json，以及一份 LobeHub 清單。其中不包含任何在您機器上執行的程式碼。伺服器的程式碼不在此處。

安裝

Cursor

從 cursor.directory 安裝外掛程式，或將伺服器新增至 .cursor/mcp.json（單一專案）或 ~/.cursor/mcp.json（所有專案）：

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

開啟「設定」，然後選取「MCP」並連線。Cursor 會開啟 FastSocial 登入頁面。

Claude Code

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

然後在 Claude Code 中執行 /mcp，選擇 instagram-data 並登入。

Claude 應用程式（網頁版和桌面版）

1. 開啟「設定」，然後選取「Connectors」，並新增自訂連接器。
2. 將 https://data.fastsocial.co/mcp 貼上作為伺服器 URL。
3. 將 OAuth 用戶端 ID 和密鑰留空。
4. 連線，並在開啟的 FastSocial 頁面上登入。

VS Code 和其他用戶端

任何支援透過 Streamable HTTP 使用 MCP 的用戶端都可以使用此伺服器 URL 連線。在 VS Code 中，將以下內容新增至 .vscode/mcp.json 並按下「開始」：

{
  "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 中。
• 任何網路請求的常見詳細資料，例如您的 IP 位址和用戶端的使用者代理程式。

除此之外不會傳送任何內容。伺服器永遠不會看到您的檔案、編輯器或對話內容，只會看到您的助理放入工具呼叫中的引數。

回傳的內容

公開的 Instagram 資料以 JSON 格式回傳，外加 meta.credits_remaining。照片和影片以連結而非檔案形式回傳。私人帳號會回傳 private_account 錯誤。Instagram 帳號擁有者可以選擇退出；之後 API 會對其帳號回傳 451 opted_out。

唯讀

每個工具都僅供讀取。沒有任何工具會變更 Instagram 上的任何內容。呼叫唯一會變更的是您當月的信用額度。伺服器在 tools/list 中將每個工具標記為 readOnlyHint: true 和 openWorldHint: true。沒有任何工具會寫入或刪除。

登入

您的用戶端首次連線時，伺服器會回覆需要登入，並說明如何進行。您的用戶端接著會在瀏覽器中開啟 fastsocial.co 上的頁面。在該頁面中，您需要：

1. 輸入您的電子郵件以及 FastSocial 透過電子郵件寄送的驗證碼，
2. 查看是哪個應用程式在要求存取權，然後按一下「允許」（或「拒絕」）。

如果您還沒有方案，當您按一下「允許」時，系統會為您建立免費方案。您絕不會在助理中輸入密碼，此外掛程式也永遠不會看到或儲存您的憑證。您的用戶端會保留它收到的權杖。存取權杖的有效期為一小時，您的用戶端會使用重新整理權杖來更新它，重新整理權杖的有效期為 30 天，並且每次使用時都會變更。

若要切斷所有已連線的應用程式，請在 https://fastsocial.co/cart/api/account 登入並按下「新增金鑰」。與舊金鑰關聯的登入作業會立即失效。

給用戶端開發人員的資訊：探索從 https://data.fastsocial.co/.well-known/oauth-protected-resource/mcp 開始。授權伺服器支援搭配 PKCE（僅限 S256）的 OAuth 2.1、動態用戶端註冊和權杖撤銷，適用於公開用戶端。

改用 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。