SocialAPIs — Facebook & Instagram Data

chính thức

Dữ liệu Facebook & Instagram cho các tác nhân AI — trang, bài đăng, nhóm, Thư viện quảng cáo, Marketplace, hồ sơ và reel. 47 công cụ chỉ đọc, đầu ra có cấu trúc. Gói miễn phí: 200 lượt gọi/tháng.

Bạn có thể làm gì với SocialAPIs — Facebook & Instagram Data MCP?

  • Dữ liệu trang và nhóm Facebook — Lấy thông tin chi tiết về trang hoặc nhóm, bài viết, video, thước phim và album ảnh bằng liên kết hoặc ID.
  • Tra cứu bài viết và bình luận trên Facebook — Lấy thông tin chi tiết về bài viết, tệp đính kèm, bình luận và câu trả lời cho bình luận từ liên kết bài viết.
  • Tìm kiếm Thư viện quảng cáo Meta — Tìm quảng cáo theo từ khóa hoặc nhà quảng cáo, lấy thông tin chi tiết về trang của nhà quảng cáo và liệt kê các quốc gia được hỗ trợ.
  • Dữ liệu hồ sơ và bài viết trên Instagram — Lấy thông tin chi tiết về hồ sơ, bài viết, thước phim, tin nổi bật và thông tin đầy đủ về bài viết bằng tên người dùng hoặc shortcode.
  • Tìm kiếm và địa điểm trên Instagram — Tìm người dùng, hashtag và địa điểm theo từ khóa hoặc liệt kê bài viết được gắn thẻ tại một địa điểm.
  • Tìm kiếm Facebook Marketplace — Tìm tin đăng, xe cộ và nhà cho thuê bằng bộ lọc, đồng thời lấy thông tin chi tiết về tin đăng hoặc người bán.

Máy chủ MCP được lưu trữ

npx add-mcp 'https://mcp.socialapis.io/mcp'

Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác

Tài liệu

Cung cấp cho trợ lý AI quyền truy cập trực tiếp vào dữ liệu Facebook và Instagram công khai bằng máy chủ Model Context Protocol (MCP) của SocialAPIs.

Máy chủ cung cấp 12 công cụ chỉ đọc, bao quát 50 hành động: trang, bài viết, bình luận, nhóm, Meta Ads Library, Marketplace, hồ sơ Instagram, bài viết, reels và địa điểm. Mỗi công cụ bao quát một tài nguyên và nhận một đối số action. Mỗi lần gọi đều trả về đầu ra có cấu trúc, bao gồm số credit đã tính phí và số credit còn lại.

1. Lấy khóa API

Đăng ký tại socialapis.io và sao chép khóa từ bảng điều khiển. Gói miễn phí bao gồm 200 credit mỗi tháng, không cần thẻ tín dụng.

2. Kết nối ứng dụng khách

Có hai cách kết nối.

Điểm cuối được lưu trữ (khuyên dùng)

Không cần cài đặt. Trỏ mọi ứng dụng khách hỗ trợ máy chủ MCP từ xa đến:

https://mcp.socialapis.io/mcp

Gửi khóa trong một header:

Authorization: Bearer YOUR_API_KEY

x-api-token: YOUR_API_KEY cũng hoạt động. Không bao giờ đưa khóa vào URL.

Máy chủ cục bộ (npx)

Dành cho các ứng dụng khách chỉ chạy máy chủ cục bộ, chẳng hạn như Claude Desktop. Cần Node.js phiên bản 18 trở lên.

{
  "mcpServers": {
    "socialapis": {
      "command": "npx",
      "args": ["-y", "@socialapis/mcp"],
      "env": {
        "SOCIALAPIS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Thiết lập ứng dụng khách

Claude Code

claude mcp add --transport http socialapis https://mcp.socialapis.io/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

VS Code

Thêm vào .vscode/mcp.json. VS Code yêu cầu khóa khi máy chủ khởi động, vì vậy khóa không được lưu trong tệp:

{
  "servers": {
    "socialapis": {
      "type": "http",
      "url": "https://mcp.socialapis.io/mcp",
      "headers": {
        "Authorization": "Bearer ${input:socialapis-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "socialapis-key",
      "description": "SocialAPIs API key",
      "password": true
    }
  ]
}

Cline

Trong MCP Servers → Configure, thêm vào cline_mcp_settings.json:

{
  "mcpServers": {
    "socialapis": {
      "type": "streamableHttp",
      "url": "https://mcp.socialapis.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Windsurf

Thêm vào ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "socialapis": {
      "serverUrl": "https://mcp.socialapis.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Công cụ hiện có

Phiên bản hiện tại: 2.0.2. Máy chủ có 12 công cụ chỉ đọc. Mỗi công cụ bao quát một tài nguyên và nhận một đối số action, cùng với các đầu vào của hành động đó:

Công cụHành động
facebook_pagedetails, id, posts, videos, reels, albums, album_items
facebook_groupdetails, id, posts, videos, albums, album_items
facebook_postdetails, details_extended, id, attachments, video, comments, comment_replies
facebook_searchpages, people, posts, videos, locations
facebook_adssearch, keywords, page_details, archive_details, countries
facebook_marketplacesearch, vehicles, rentals, listing, seller, categories, city_coordinates
facebook_media_downloaddownload
instagram_profiledetails, id, posts, reels, highlights, highlight_details
instagram_postdetails, id
instagram_reelsfeed, by_audio
instagram_searchsearch
instagram_locationposts, nearby

Ví dụ lệnh gọi:

{ "name": "facebook_post", "arguments": { "action": "comments", "link": "https://www.facebook.com/nike/posts/POST_ID", "limit": 20 } }

Thiếu action hoặc đầu vào bắt buộc sẽ trả về lỗi trước khi tiêu tốn credit. Mô tả của từng công cụ trong ứng dụng khách liệt kê các đầu vào tương tự cho từng hành động.

Nâng cấp từ 1.x? Các tên công cụ cũ theo từng điểm cuối (chẳng hạn như facebook_get_page_details) vẫn hoạt động khi được gọi trực tiếp, vì vậy các tập lệnh hiện có vẫn chạy. Nếu ứng dụng khách tự động phê duyệt hoặc đưa công cụ vào danh sách cho phép theo tên, hãy thêm các tên mới ở trên.

Đầu vào theo hành động

Credit được tính cho mỗi lần gọi, trừ khi có ghi chú khác. Phân trang: truyền end_cursor từ phản hồi để lấy trang tiếp theo.

facebook_page

Trang Facebook: thông tin hồ sơ, ID trang, bài viết, video, reels và album ảnh.

Hành độngĐầu vào bắt buộcĐầu vào tùy chọnCredit
detailslinkexact_followers_count1 (5 với exact_followers_count=true)
idlink—1
postslinklimit, end_cursor, after_time, before_time, timezone1 cho mỗi 3 bài viết trả về (tối thiểu 1)
videoslink hoặc profile_idlimit, end_cursor1
reelslinkend_cursor1
albumsprofile_id (từ id)limit (8-16), end_cursor1
album_itemsalbum_id (từ albums)end_cursor1

facebook_group

Nhóm Facebook công khai: thông tin chi tiết, ID nhóm, bài viết, video và album ảnh.

Hành độngĐầu vào bắt buộcĐầu vào tùy chọnCredit
detailslink—1
idlink—1
postslinklimit, end_cursor, after_time, before_time, timezone1 cho mỗi 3 bài viết trả về (tối thiểu 1)
videoslinkend_cursor1
albumsgroup_id (từ id)limit (8-16)1
album_itemsalbum_id (từ albums)end_cursor1

facebook_post

Bài viết, video và bình luận trên Facebook: thông tin chi tiết về bài viết, tệp đính kèm, bình luận và câu trả lời.

Hành độngĐầu vào bắt buộcĐầu vào tùy chọnCredit
detailslink—1
details_extendedlink—1
idlink—1
attachmentspost_id—5
videovideo_id—1
commentslinklimit, end_cursor, include_reply_info1
comment_repliescomment_feedback_id, expansion_token—1

facebook_search

Tìm kiếm trên Facebook theo từ khóa: trang, người, bài viết, video và địa điểm.

Hành độngĐầu vào bắt buộcĐầu vào tùy chọnCredit
pagesquerylocation_uid, end_cursor1
peoplequerylocation_uid, end_cursor1
postsquerylocation_uid, start_time, end_time, recent_posts, end_cursor1
videosquerymost_recent, videos_live, fields, end_cursor1
locationsquery—1

facebook_ads

Meta Ads Library: tìm kiếm quảng cáo, tìm nhà quảng cáo theo từ khóa, thông tin chi tiết trang nhà quảng cáo, thông tin chi tiết một quảng cáo và các quốc gia được hỗ trợ.

Hành độngĐầu vào bắt buộcĐầu vào tùy chọnCredit
search—query, ad_page_id, country, activeStatus, after_time, before_time, sort_data, end_cursor1
keywordsquerycountry1
page_detailspage_id—1
archive_detailsad_archive_idpage_id, country, is_ad_non_political, is_ad_not_aaa_eligible1
countries——1

facebook_marketplace

Facebook Marketplace: tìm kiếm tin đăng, xe và nhà cho thuê, thông tin chi tiết tin đăng và người bán, danh mục và tọa độ thành phố.

Hành độngĐầu vào bắt buộcĐầu vào tùy chọnCredit
search—query, category_url, commerce_search_sort_by, commerce_search_and_rp_condition, filter_location_latitude, filter_location_longitude, filter_price_lower_bound, filter_price_upper_bound, filter_radius_km, posted_today, exact_match, limit, end_cursor1
vehicles—sort_by, filter_location_latitude, filter_location_longitude, filter_price_lower_bound, filter_price_upper_bound, filter_radius_km, is_c2c_listing_only, end_cursor1
rentals—sort_by, filter_location_latitude, filter_location_longitude, filter_price_lower_bound, filter_price_upper_bound, filter_radius_km, filter_bedrooms_min, filter_bedrooms_max, filter_bathrooms_min, filter_bathrooms_max, end_cursor1
listinglisting_id—1
sellerseller_id—1
categories——1
city_coordinatescitycountry, exactly_one1

facebook_media_download

Tải xuống nội dung đa phương tiện Facebook (hình ảnh, video, âm thanh) từ một URL.

Hành độngĐầu vào bắt buộcĐầu vào tùy chọnCredit
downloadurl—1

instagram_profile

Hồ sơ Instagram: thông tin chi tiết, ID người dùng, bài viết, reels, tin nổi bật và tin trong mục nổi bật.

Hành độngĐầu vào bắt buộcĐầu vào tùy chọnCredit
detailsusernamelink1
id—link, username1
posts—username, user_id, end_cursor1
reelsuser_idend_cursor1
highlightsuser_id—1
highlight_detailshighlight_id—1

instagram_post

Bài viết Instagram: thông tin đầy đủ về bài viết hoặc shortcode từ URL bài viết.

Hành độngĐầu vào bắt buộcĐầu vào tùy chọnCredit
detailsshortcode—1
idlink—1

instagram_reels

Instagram Reels: bảng tin thịnh hành hoặc reels sử dụng một bản nhạc cụ thể.

Hành độngĐầu vào bắt buộcĐầu vào tùy chọnCredit
feed—clips_media_id1
by_audioaudio_idmax_id1

instagram_search

Tìm kiếm trên Instagram theo từ khóa để tìm người dùng, hashtag và địa điểm phổ biến.

Hành độngĐầu vào bắt buộcĐầu vào tùy chọnCredit
searchkeywordend_cursor1

instagram_location

Địa điểm Instagram: bài viết được gắn thẻ tại một địa điểm và các địa điểm lân cận.

Hành độngĐầu vào bắt buộcĐầu vào tùy chọnCredit
postslocation_idtab, end_cursor1
nearbylocation_id—1

Prompt mẫu

"Lấy thông tin chi tiết trang Facebook của Nike và tóm tắt 10 bài viết gần đây nhất."

"So sánh số người theo dõi Adidas và Nike trên Instagram."

"Tìm quảng cáo đang hoạt động trong Meta Ads Library có nhắc đến 'giày chạy bộ' tại Hoa Kỳ."

Khắc phục sự cố

Triệu chứngCách khắc phục
Missing SocialAPIs API keyThêm header Authorization: Bearer <key> (máy chủ lưu trữ) hoặc SOCIALAPIS_API_KEY (npx).
HTTP 401 hoặc 403 trong kết quảSao chép lại khóa từ bảng điều khiển.
Insufficient creditsNâng cấp hoặc nạp thêm tại socialapis.io/pricing.
Không có công cụ nào được liệt kêKhởi động lại ứng dụng khách sau khi chỉnh sửa cấu hình và kiểm tra xem https://mcp.socialapis.io/health có phản hồi không (mở trong trình duyệt).

Tìm chúng tôi ở đâu

Máy chủ được liệt kê trong Official MCP Registry với tên io.github.SocialAPIsHub/social-media-api, và trên Smithery, Glama, cursor.directory, LobeHub, mcp.so và mcpservers.org. Xem socialapis.io/integrations để biết các liên kết.

Mã nguồn: github.com/SocialAPIsHub/mcp-server. Câu hỏi: support@socialapis.io.