Instagram

io.github.mcp-dir由 GitHub 帳號 mcp-dir 發布v0.1.0更新於 Oct 24, 2026

Instagram for AI agents: publish, read comments and DMs, insights, and engage from your account.

已驗證Streamable HTTP可網頁執行溝通與協作商業與電商媒體與設計

概覽

AI 產生的概覽

讓助理為已連結的 Instagram 帳號發佈內容、讀取留言與私訊,並取得數據洞察。

可以做什麼
連結一個 Instagram 帳號後,助理可透過官方 API 發佈照片、影片、輪播、Reels 和限時動態,讀取並回覆留言,處理私訊,並取得帳號與媒體的洞察資料(例如觸及人數和曝光次數)。另一組互動工具可以對貼文和留言按讚、追蹤與取消追蹤、列出和檢視限時動態,以及發起私訊對話。互動操作會排入佇列並回傳任務 id,可查詢執行狀態。
適用情境
適合讓助理經營單一 Instagram 帳號:發佈內容、回覆留言和私訊、查看互動數據,或以人工節奏進行少量互動。它不適合批次或高頻操作。
執行需求
透過 HTTP 連線的遠端 MCP 端點,不需要本機執行環境或安裝套件。需要連結一個 Instagram 帳號:官方 API 方案要求商業或創作者帳號,進階方案使用使用者名稱和密碼並支援兩步驟驗證。部分功能需要按已連結帳號計費的付費訂閱。
安裝前請注意
進階連線方式需要提供 Instagram 使用者名稱和密碼,屬於敏感憑證。相關工具會在已連結帳號上發佈內容、傳送訊息、回覆留言、按讚、追蹤和取消追蹤,這些操作對他人可見且難以撤回。工具回傳的資料會傳送給所使用的 LLM 服務方,說明中稱其為不受提供方控制的次級處理者。此伺服器為專有且託管運行。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Instagram,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.mcp-dir%2Finstagram-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "instagram": {
      "type": "http",
      "url": "https://api.mcp.ai/p_instagram"
    }
  }
}

README

該儲存庫沒有 README。

工具

33

instagram_actions_list_accounts

List the Instagram accounts connected to this install — id, username, label.

輸入參數account

instagram_actions_like

Like one or more Instagram posts, addressed by post URL or shortcode (NOT the numeric media id the official API returns). Returns a job_id; poll instagram_actions_get_job_status.

輸入參數posts必填account

instagram_actions_list_comments

List the comments on a post, addressed by URL or shortcode. Returns each comment_id in the form that instagram_actions_like_comment accepts. The official API returns a DIFFERENT id that is not accepted there. Returns a job_id; poll instagram_actions_get_job_status.

輸入參數posts必填account

instagram_actions_like_comment

Like one or more comments. Each comment_id MUST come from instagram_actions_list_comments. The id returned by the official instagram_get_ig_media_comments belongs to a different namespace and is rejected. Returns a job_id; poll instagram_actions_get_job_status.

輸入參數accountcomment_ids必填

instagram_actions_follow

Follow one or more Instagram users by @username. Returns a job_id.

輸入參數accounttargets必填

instagram_actions_unfollow

Unfollow one or more Instagram users by @username. Returns a job_id.

輸入參數accounttargets必填

instagram_actions_list_stories

List a specific user's currently available stories (read-only, does not mark as seen). Returns a job_id (or the result inline when wait=true).

輸入參數waittarget必填account

instagram_actions_view_story

Watch (mark as seen) the stories of one or more profiles. Omit `targets` to watch the home tray. Returns a job_id.

輸入參數accounttargets

instagram_actions_send_message

Send the FIRST direct message to someone who has never messaged this account (the official API cannot do this). One recipient per call, low daily cap. Returns a job_id.

輸入參數text必填target必填accountdry_run

instagram_actions_get_job_status

Get the status/progress/result of a previously started action by its job_id. Bulk support: accepts job_ids for batched execution.

輸入參數job_id必填accountjob_ids

instagram_actions_list_jobs

List recent action jobs for the connected account, optionally filtered by status.

輸入參數statusaccount

instagram_get_user_info

Get Instagram Business Account info including profile details and statistics. Use "me" to query your own authenticated account, or provide the numeric Business Account ID of an account you manage. NOTE: followers_count and follows_count are returned for your own profile (ig_user_id="me"). For other accounts, follower/… Bulk support: accepts ig_user_ids for batched execution.

輸入參數accountig_user_idig_user_idsgraph_api_version

instagram_get_ig_user_media

List account media. REST response: read result.result.data and result.result.paging (not result.data). Null engagement fields mean unavailable, not zero; use media insights for saved, shares and views. Bulk support: accepts ig_user_ids, auto_resolve_fb_page_ids for batched execution.

輸入參數afterlimitsinceuntilbeforefieldsaccountig_user_idig_user_idsgraph_api_versionauto_resolve_fb_page_idauto_resolve_fb_page_ids

instagram_get_ig_media

Get a published Instagram Media object (photo, video, story, reel, or carousel). Use when you need to retrieve detailed information about a specific Instagram post including engagement metrics, caption, media URLs, and metadata. NOTE: This action is for published media only. For unpublished container IDs (from INSTAGR… Bulk support: accepts ig_media_ids for batched execution.

輸入參數fieldsaccountig_media_id必填ig_media_idsgraph_api_version

instagram_get_ig_media_comments

Tool to retrieve comments on an Instagram media object. Use when you need to fetch comments from a specific Instagram post, photo, video, or carousel owned by the connected Business/Creator account. Supports cursor-based pagination for navigating through large comment lists. An empty data array in the response indicat… Bulk support: accepts ig_media_ids for batched execution.

輸入參數afterlimitbeforefieldsaccountig_media_id必填ig_media_idsgraph_api_version

instagram_get_ig_media_insights

Read media insights. REST response: read result.result.data. Request metric=[views,reach,saved,shares] for views, reach, saves and shares; availability depends on the media type and metric. Bulk support: accepts ig_media_ids for batched execution.

輸入參數metric必填periodaccountbreakdownig_media_id必填ig_media_idsgraph_api_version

instagram_get_user_insights

Read account insights at result.result.data in REST. An empty data array means insights are unavailable, not zero. It does not by itself establish a follower-count restriction. Bulk support: accepts ig_user_ids for batched execution.

輸入參數sinceuntilmetricperiodaccountbreakdowntimeframeig_user_idig_user_idsmetric_typegraph_api_version

instagram_post_ig_user_media

Tool to create a media container for Instagram posts. Use this to create a container for images, videos, Reels, or carousels. This is the first step in Instagram's two-step publishing process - after creating the container, use the media_publish endpoint to publish it. Bulk support: accepts ig_user_ids, location_ids for batched execution.

輸入參數accountcaptionalt_textchildrencover_urlimage_urluser_tagsvideo_urlaudio_nameig_user_idimage_filemedia_type另有 8 個

instagram_post_ig_user_media_publish

Tool to publish a media container to an Instagram Business account. This action automatically waits for the container to finish processing before publishing. Instagram enforces an account-specific content-publishing rate limit over a 24-hour moving window; the exact cap varies by account and should be read live via IN… Bulk support: accepts ig_user_ids, creation_ids for batched execution.

輸入參數accountig_user_idcreation_id必填ig_user_idscreation_idsmax_wait_secondsgraph_api_versionpoll_interval_seconds

instagram_post_ig_comment_replies

Tool to create a reply to an Instagram comment. Use when you need to reply to a specific comment on an Instagram post owned by a Business or Creator account. The reply must be 300 characters or less, contain at most 4 hashtags and 1 URL, and cannot consist entirely of capital letters. Bulk support: accepts ig_comment_ids for batched execution.

輸入參數accountmessage必填ig_comment_id必填ig_comment_idsgraph_api_version

instagram_send_text_message

Send a text message to an Instagram user via DM in an existing conversation. Cannot initiate new DM threads — a prior conversation must exist. Requires an Instagram Business or Creator account with messaging permissions. Fails with error_subcode 2534022 if outside the messaging window; do not retry these failures. Bulk support: accepts ig_user_ids, recipient_ids, reply_to_message_ids for batched execution.

輸入參數text必填accountig_user_idig_user_idsrecipient_id必填recipient_idsgraph_api_versionreply_to_message_idreply_to_message_ids

instagram_send_image

Send an image via Instagram DM to a specific user. Each send modifies inbox state; avoid bulk or automated sends without explicit user approval. Bulk support: accepts ig_user_ids, recipient_ids for batched execution.

輸入參數accountimage_url必填ig_user_idig_user_idsrecipient_id必填recipient_idsgraph_api_version

instagram_mark_seen

Mark Instagram DM messages as read/seen for a specific user. Sends a 'mark_seen' sender action to indicate messages from the specified recipient have been read. Marking as seen is visible to the other party and changes inbox read state — use with explicit user approval in automated or bulk flows. IMPORTANT LIMITATIONS… Bulk support: accepts ig_user_ids, recipient_ids for batched execution.

輸入參數accountig_user_idig_user_idsrecipient_id必填recipient_idsgraph_api_version

instagram_get_conversation

Get details about a specific Instagram DM conversation (participants, etc). Requires a Business or Creator account with Instagram messaging permissions; personal accounts will return permission errors. Newly sent/received messages may take a few seconds to appear in results. Bulk support: accepts conversation_ids for batched execution.

輸入參數accountconversation_id必填conversation_idsgraph_api_version

instagram_list_all_conversations

List all Instagram DM conversations for the authenticated user. Requires a Business/Creator account with messaging permissions; personal accounts return empty results. Response conversations are nested under `data.data` — accessing top-level `data` as the final list returns zero items. An empty `data` list is a valid … Bulk support: accepts user_ids, ig_user_ids for batched execution.

輸入參數afterlimitaccountuser_idplatformuser_idsig_user_idig_user_idsgraph_api_version

instagram_list_all_messages

List all messages from a specific Instagram DM conversation. Requires a Business or Creator account with messaging permissions; personal accounts return empty results. Response data is nested under data.data (double-wrapped); attachment-only messages may have empty text fields. Bulk support: accepts conversation_ids for batched execution.

輸入參數afterlimitaccountconversation_id必填conversation_idsgraph_api_version

show_version

Show Version

Show the current MCP platform and adapter versions.

無需輸入參數。

report_bug

Report Bug

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

輸入參數contextmessage必填conversation

connect

Connection Status

Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

無需輸入參數。

toolkit_info

Toolkit Info

Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

無需輸入參數。

marketplace

Marketplace

The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.

輸入參數limitqueryactionmcp_idmessagetool_idargumentsimmediatetier_slugprompt_bodyprompt_slugprompt_tool另有 11 個

authenticate

Authenticate

MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.

輸入參數token

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 75%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分

    請宣告包含 README 的 GitHub 儲存庫,或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。