SocialAPIs — Facebook & Instagram Data
chính thứcDữ 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_page | details, id, posts, videos, reels, albums, album_items |
facebook_group | details, id, posts, videos, albums, album_items |
facebook_post | details, details_extended, id, attachments, video, comments, comment_replies |
facebook_search | pages, people, posts, videos, locations |
facebook_ads | search, keywords, page_details, archive_details, countries |
facebook_marketplace | search, vehicles, rentals, listing, seller, categories, city_coordinates |
facebook_media_download | download |
instagram_profile | details, id, posts, reels, highlights, highlight_details |
instagram_post | details, id |
instagram_reels | feed, by_audio |
instagram_search | search |
instagram_location | posts, 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ọn | Credit |
|---|---|---|---|
details | link | exact_followers_count | 1 (5 với exact_followers_count=true) |
id | link | — | 1 |
posts | link | limit, end_cursor, after_time, before_time, timezone | 1 cho mỗi 3 bài viết trả về (tối thiểu 1) |
videos | link hoặc profile_id | limit, end_cursor | 1 |
reels | link | end_cursor | 1 |
albums | profile_id (từ id) | limit (8-16), end_cursor | 1 |
album_items | album_id (từ albums) | end_cursor | 1 |
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ọn | Credit |
|---|---|---|---|
details | link | — | 1 |
id | link | — | 1 |
posts | link | limit, end_cursor, after_time, before_time, timezone | 1 cho mỗi 3 bài viết trả về (tối thiểu 1) |
videos | link | end_cursor | 1 |
albums | group_id (từ id) | limit (8-16) | 1 |
album_items | album_id (từ albums) | end_cursor | 1 |
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ọn | Credit |
|---|---|---|---|
details | link | — | 1 |
details_extended | link | — | 1 |
id | link | — | 1 |
attachments | post_id | — | 5 |
video | video_id | — | 1 |
comments | link | limit, end_cursor, include_reply_info | 1 |
comment_replies | comment_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ọn | Credit |
|---|---|---|---|
pages | query | location_uid, end_cursor | 1 |
people | query | location_uid, end_cursor | 1 |
posts | query | location_uid, start_time, end_time, recent_posts, end_cursor | 1 |
videos | query | most_recent, videos_live, fields, end_cursor | 1 |
locations | query | — | 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ọn | Credit |
|---|---|---|---|
search | — | query, ad_page_id, country, activeStatus, after_time, before_time, sort_data, end_cursor | 1 |
keywords | query | country | 1 |
page_details | page_id | — | 1 |
archive_details | ad_archive_id | page_id, country, is_ad_non_political, is_ad_not_aaa_eligible | 1 |
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ọn | Credit |
|---|---|---|---|
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_cursor | 1 |
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_cursor | 1 |
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_cursor | 1 |
listing | listing_id | — | 1 |
seller | seller_id | — | 1 |
categories | — | — | 1 |
city_coordinates | city | country, exactly_one | 1 |
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ọn | Credit |
|---|---|---|---|
download | url | — | 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ọn | Credit |
|---|---|---|---|
details | username | link | 1 |
id | — | link, username | 1 |
posts | — | username, user_id, end_cursor | 1 |
reels | user_id | end_cursor | 1 |
highlights | user_id | — | 1 |
highlight_details | highlight_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ọn | Credit |
|---|---|---|---|
details | shortcode | — | 1 |
id | link | — | 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ọn | Credit |
|---|---|---|---|
feed | — | clips_media_id | 1 |
by_audio | audio_id | max_id | 1 |
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ọn | Credit |
|---|---|---|---|
search | keyword | end_cursor | 1 |
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ọn | Credit |
|---|---|---|---|
posts | location_id | tab, end_cursor | 1 |
nearby | location_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ứng | Cách khắc phục |
|---|---|
Missing SocialAPIs API key | Thê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 credits | Nâ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.