FastSocial Instagram Data

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

Máy chủ MCP Dữ liệu Instagram

Kết nối trợ lý AI của bạn với API Dữ liệu Instagram của FastSocial, và nó có thể tra cứu hồ sơ Instagram công khai, bài đăng, reel, story, highlight, bình luận, hashtag, địa điểm và âm thanh. Chỉ đọc: nó không bao giờ đăng, theo dõi, thích hoặc gửi tin nhắn.

Máy chủ là từ xa. Không có gì để cài đặt hoặc chạy: trợ lý của bạn giao tiếp với

https://data.fastsocial.co/mcp

qua Streamable HTTP. Lần đầu tiên nó kết nối, một trang fastsocial.co mở trong trình duyệt của bạn, nơi bạn đăng nhập và nhấp vào Cho phép.

Kho lưu trữ này chứa các tệp kê khai plugin (plugin.json, mcp.json và bản sao Cursor đọc trong .cursor-plugin/), server.json liệt kê máy chủ trong Sổ đăng ký MCP chính thức với tên io.github.FastSocialCo/instagram-data-mcp, và một tệp kê khai LobeHub. Nó không chứa mã nào chạy trên máy của bạn. Mã của máy chủ không có ở đây.

Cài đặt

Cursor

Cài plugin từ cursor.directory, hoặc thêm máy chủ vào .cursor/mcp.json (một dự án) hoặc ~/.cursor/mcp.json (tất cả các dự án):

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

Mở Cài đặt, sau đó MCP, và kết nối. Cursor mở trang đăng nhập FastSocial.

Claude Code

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

Sau đó chạy /mcp bên trong Claude Code, chọn instagram-data và đăng nhập.

Ứng dụng Claude (web và máy tính để bàn)

1. Mở Cài đặt, sau đó Trình kết nối, và thêm trình kết nối tùy chỉnh.
2. Dán https://data.fastsocial.co/mcp làm URL máy chủ.
3. Để trống ID máy khách OAuth và bí mật.
4. Kết nối, và đăng nhập trên trang FastSocial mở ra.

VS Code và các máy khách khác

Bất kỳ máy khách nào nói MCP qua Streamable HTTP đều có thể kết nối với URL máy chủ. Trong VS Code, thêm cái này vào .vscode/mcp.json và nhấn Bắt đầu:

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

Plugin này làm gì và dữ liệu nó gửi

Bản thân plugin

Plugin là hai tệp JSON cho máy khách của bạn biết địa chỉ của máy chủ. Nó không chạy mã, không có tập lệnh cài đặt và không lưu trữ gì. Máy khách của bạn tự thực hiện mọi yêu cầu, trực tiếp đến https://data.fastsocial.co/mcp qua HTTPS.

Những gì máy khách của bạn gửi

• Bắt tay MCP: tên và phiên bản của máy khách của bạn, và phiên bản giao thức nó nói.
• Mỗi lần gọi công cụ: tên của công cụ và các đối số của nó, là những thứ bạn hỏi về: một tên người dùng hoặc ID người dùng Instagram, một liên kết bài đăng hoặc reel, một hashtag, từ khóa tìm kiếm, một địa điểm, ID âm thanh hoặc highlight, và một con trỏ phân trang. Danh sách đầy đủ ở bảng dưới đây.
• Mã thông báo đăng nhập hoặc khóa API của bạn, trong một tiêu đề yêu cầu. Không bao giờ trong URL.
• Các chi tiết thông thường của bất kỳ yêu cầu web nào, chẳng hạn như địa chỉ IP của bạn và tác nhân người dùng của máy khách của bạn.

Không có gì khác được gửi. Máy chủ không bao giờ thấy tệp của bạn, trình soạn thảo của bạn hoặc cuộc trò chuyện của bạn, chỉ thấy các đối số mà trợ lý của bạn đưa vào một lần gọi công cụ.

Những gì trả về

Dữ liệu Instagram công khai dưới dạng JSON, cộng với meta.credits_remaining. Ảnh và video trả về dưới dạng liên kết, không phải tệp. Tài khoản riêng tư trả về lỗi private_account. Chủ sở hữu tài khoản Instagram có thể chọn không tham gia; sau đó API trả về 451 opted_out cho tài khoản của họ.

Chỉ đọc

Mọi công cụ đều đọc. Không có gì thay đổi trên Instagram. Điều duy nhất một lần gọi thay đổi là số dư tín dụng của chính bạn cho tháng. Máy chủ đánh dấu mọi công cụ readOnlyHint: true và openWorldHint: true trong tools/list. Không có công cụ nào ghi hoặc xóa.

Đăng nhập

Lần đầu tiên máy khách của bạn kết nối, máy chủ trả lời rằng nó cần đăng nhập và cho biết nơi để tìm hiểu cách. Máy khách của bạn sau đó mở một trang trên fastsocial.co trong trình duyệt của bạn. Ở đó bạn:

1. nhập email của bạn và mã FastSocial gửi qua email cho bạn,
2. xem ứng dụng nào đang yêu cầu, và nhấp vào Cho phép (hoặc Từ chối).

Nếu bạn chưa có gói, một gói Miễn phí được tạo cho bạn khi bạn nhấp vào Cho phép. Bạn không bao giờ gõ mật khẩu vào trợ lý của bạn, và plugin không bao giờ thấy hoặc lưu trữ thông tin đăng nhập của bạn. Máy khách của bạn giữ các mã thông báo nó nhận được. Một mã thông báo truy cập kéo dài một giờ, và máy khách của bạn gia hạn nó bằng một mã thông báo làm mới kéo dài 30 ngày và thay đổi mỗi lần nó được sử dụng.

Để cắt quyền truy cập của mọi ứng dụng bạn đã kết nối, đăng nhập tại https://fastsocial.co/cart/api/account và nhấn Khóa mới. Các lần đăng nhập liên kết với khóa cũ ngừng hoạt động ngay lập tức.

Dành cho nhà phát triển máy khách: khám phá bắt đầu tại https://data.fastsocial.co/.well-known/oauth-protected-resource/mcp. Máy chủ ủy quyền hỗ trợ OAuth 2.1 với PKCE (chỉ S256), đăng ký máy khách động và thu hồi mã thông báo, cho máy khách công khai.

Sử dụng khóa API thay thế

Nếu máy khách của bạn có thể đặt một tiêu đề nhưng không thể đăng nhập, hãy lấy một khóa tại https://fastsocial.co/instagram-api?ref=github và gửi nó trên mỗi yêu cầu dưới dạng X-API-Key: YOUR_KEY (hoặc Authorization: Bearer YOUR_KEY). Cho Claude Code:

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

Giữ khóa ngoài các tệp bạn cam kết.

Chính sách

• Chính sách quyền riêng tư: https://fastsocial.co/privacy
• Điều khoản: https://fastsocial.co/terms
• Chính sách sử dụng dữ liệu (chỉ dữ liệu công khai, không theo dõi hoặc quấy rối mọi người, không có gì về trẻ vị thành niên): https://fastsocial.co/instagram-api/docs?ref=github
• Báo cáo sự cố bảo mật: SECURITY.md

28 công cụ

Mỗi lần gọi tốn tín dụng từ hạn mức hàng tháng của bạn. Các lần gọi thất bại không tốn gì. Mọi công cụ đều chỉ đọc.

Công cụ	Chức năng	Đối số	Tín dụng
instagram_profile	Lấy hồ sơ Instagram	username hoặc user_id	1
instagram_user_id	Tên người dùng Instagram sang ID người dùng	username hoặc user_id	1
instagram_username	ID người dùng Instagram sang tên người dùng	user_id	2
instagram_check	Kiểm tra xem một tay cầm Instagram có tồn tại và công khai không	username	1
instagram_posts	Lấy các bài đăng Instagram gần đây	username hoặc user_id, cursor	1
instagram_reels	Lấy reel Instagram của một tài khoản	username hoặc user_id, cursor	1
instagram_tagged	Lấy các bài đăng mà một tài khoản được gắn thẻ	username hoặc user_id, cursor	1
instagram_post	Lấy một bài đăng hoặc reel Instagram	url hoặc shortcode	1
instagram_media	URL tải xuống cho một bài đăng, reel hoặc carousel	url hoặc shortcode	1
instagram_comments	Lấy bình luận trên một bài đăng Instagram	url hoặc shortcode	3
instagram_comment_replies	Lấy phản hồi cho một bình luận Instagram	url hoặc shortcode, comment_id, cursor	3
instagram_likers	Lấy các tài khoản đã thích một bài đăng Instagram	url hoặc shortcode	3
instagram_insights	Máy tính tỷ lệ tương tác Instagram	username hoặc user_id	2
instagram_followers	Lấy người theo dõi của một tài khoản	username hoặc user_id, cursor	3
instagram_following	Lấy các tài khoản mà một tài khoản theo dõi	username hoặc user_id, cursor	3
instagram_similar	Tìm các tài khoản Instagram tương tự	username hoặc user_id	1
instagram_stories	Xem story Instagram ẩn danh	username hoặc user_id	3
instagram_highlights	Lấy highlight story Instagram	username hoặc user_id	3
instagram_highlight	Lấy các mục trong một highlight	id	3
instagram_search	Tìm kiếm tài khoản, hashtag và địa điểm Instagram	q	1
instagram_hashtag	Lấy bài đăng cho một hashtag Instagram	tag, cursor	1
instagram_place	Lấy một địa điểm Instagram	id	3
instagram_place_posts	Lấy bài đăng được gắn thẻ tại một địa điểm Instagram	id, cursor	1
instagram_audio	Lấy một bản nhạc audio Instagram và các reel sử dụng nó	id	1
instagram_audio_search	Tìm kiếm nhạc và âm thanh Instagram	q	3
instagram_reels_search	Tìm kiếm reel Instagram theo từ khóa	q, cursor	3
instagram_top_accounts	Xếp hạng hàng ngày của 2.000 tài khoản được theo dõi nhiều nhất	sort, limit	0
instagram_usage	Tín dụng bạn đã dùng và còn lại trong tháng này	không có	0

Tài liệu tham khảo đầy đủ: https://fastsocial.co/instagram-api/docs?ref=github

Những điều để hỏi nó

• "So sánh tỷ lệ tương tác của @nasa và @spacex."
• "Tải xuống mọi slide của carousel này: https://www.instagram.com/p/..."
• "Hiển thị cho tôi story hiện tại của @natgeo và tóm tắt chúng."
• "Tìm 10 tài khoản tương tự @humansofny."

Phiên bản cục bộ

Nếu máy khách của bạn chỉ chạy máy chủ cục bộ (stdio), các công cụ tương tự có trên PyPI với tên instagram-data-mcp. Nó không phải là một phần của plugin này. Mã nguồn của nó là FastSocialCo/instagram-data-mcp-python.

Liên kết

• API Dữ liệu Instagram: https://fastsocial.co/instagram-api?ref=github
• Tài liệu: https://fastsocial.co/instagram-api/docs?ref=github
• Đặc tả OpenAPI: https://fastsocial.co/instagram-api/openapi.json
• Mục nhập Sổ đăng ký MCP: io.github.FastSocialCo/instagram-data-mcp

Giấy phép

MIT. Xem LICENSE.