SocialAPIs — Facebook & Instagram Data
ทางการข้อมูล Facebook และ Instagram สำหรับ AI agents — เพจ โพสต์ กลุ่ม Ads Library Marketplace โปรไฟล์ และรีลส์ เครื่องมือแบบอ่านอย่างเดียว 47 รายการ ผลลัพธ์แบบมีโครงสร้าง ฟรี 200 ครั้ง/เดือน
คุณทำอะไรได้บ้างด้วย SocialAPIs — Facebook & Instagram Data MCP?
- ข้อมูลเพจและกลุ่ม Facebook — ดึงรายละเอียดเพจหรือกลุ่ม โพสต์ วิดีโอ รีล และอัลบั้มรูปภาพได้จากลิงก์หรือ ID
- ค้นหาโพสต์และความคิดเห็นบน Facebook — ดึงรายละเอียดโพสต์ ไฟล์แนบ ความคิดเห็น และการตอบกลับความคิดเห็นจากลิงก์โพสต์
- ค้นหาในคลังโฆษณา Meta — ค้นหาโฆษณาด้วยคีย์เวิร์ดหรือผู้ลงโฆษณา ดูรายละเอียดเพจของผู้ลงโฆษณา และดูรายชื่อประเทศที่รองรับ
- ข้อมูลโปรไฟล์และโพสต์ Instagram — ดึงรายละเอียดโปรไฟล์ โพสต์ รีล ไฮไลต์ และรายละเอียดโพสต์ฉบับเต็มได้จากชื่อผู้ใช้หรือ shortcode
- ค้นหาและสถานที่บน Instagram — ค้นหาผู้ใช้ แฮชแท็ก และสถานที่ด้วยคีย์เวิร์ด หรือดูรายชื่อโพสต์ที่แท็กสถานที่
- ค้นหา Facebook Marketplace — ค้นหาประกาศขาย ยานพาหนะ และที่พักให้เช่าพร้อมตัวกรอง รวมถึงดูรายละเอียดประกาศหรือผู้ขาย
เซิร์ฟเวอร์ MCP แบบโฮสต์
npx add-mcp 'https://mcp.socialapis.io/mcp'ติดตั้งลง Claude Code, Codex, Cursor และอื่นๆ
เอกสาร
ให้ผู้ช่วย AI เข้าถึงข้อมูลสาธารณะของ Facebook และ Instagram ได้โดยตรงด้วยเซิร์ฟเวอร์ Model Context Protocol (MCP) ของ SocialAPIs
เซิร์ฟเวอร์นี้มีเครื่องมือแบบอ่านอย่างเดียว 12 รายการ ครอบคลุม 50 การดำเนินการ ได้แก่ เพจ โพสต์ ความคิดเห็น กลุ่ม Meta Ads Library, Marketplace, โปรไฟล์ Instagram โพสต์ รีล และสถานที่ เครื่องมือแต่ละรายการครอบคลุมทรัพยากรหนึ่งรายการและรับอาร์กิวเมนต์ action ทุกครั้งที่เรียกใช้จะส่งคืนผลลัพธ์แบบมีโครงสร้าง ซึ่งรวมถึงเครดิตที่ใช้และเครดิตคงเหลือ
1. รับคีย์ API
สมัครที่ socialapis.io แล้วคัดลอกคีย์จาก แดชบอร์ด แพ็กเกจฟรีมีเครดิต 200 หน่วยต่อเดือน โดยไม่ต้องใช้บัตรเครดิต
2. เชื่อมต่อไคลเอ็นต์ของคุณ
เชื่อมต่อได้สองวิธี
ปลายทางแบบโฮสต์ (แนะนำ)
ไม่ต้องติดตั้งอะไร กำหนดให้ไคลเอ็นต์ใดก็ได้ที่รองรับเซิร์ฟเวอร์ MCP ระยะไกลเชื่อมต่อที่:
https://mcp.socialapis.io/mcp
ส่งคีย์ของคุณในส่วนหัว:
Authorization: Bearer YOUR_API_KEY
ใช้ x-api-token: YOUR_API_KEY ได้เช่นกัน ห้ามใส่คีย์ไว้ใน URL
เซิร์ฟเวอร์ภายในเครื่อง (npx)
สำหรับไคลเอ็นต์ที่เรียกใช้ได้เฉพาะเซิร์ฟเวอร์ภายในเครื่อง เช่น Claude Desktop ต้องใช้ Node.js เวอร์ชัน 18 ขึ้นไป
{
"mcpServers": {
"socialapis": {
"command": "npx",
"args": ["-y", "@socialapis/mcp"],
"env": {
"SOCIALAPIS_API_KEY": "YOUR_API_KEY"
}
}
}
}
การตั้งค่าไคลเอ็นต์
Claude Code
claude mcp add --transport http socialapis https://mcp.socialapis.io/mcp \
--header "Authorization: Bearer YOUR_API_KEY"
VS Code
เพิ่มลงใน .vscode/mcp.json เมื่อเซิร์ฟเวอร์เริ่มทำงาน VS Code จะขอคีย์ จึงไม่มีการจัดเก็บคีย์ไว้ในไฟล์:
{
"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
ใน MCP Servers → Configure ให้เพิ่มลงใน cline_mcp_settings.json:
{
"mcpServers": {
"socialapis": {
"type": "streamableHttp",
"url": "https://mcp.socialapis.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Windsurf
เพิ่มลงใน ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"socialapis": {
"serverUrl": "https://mcp.socialapis.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
เครื่องมือที่มีให้ใช้งาน
เวอร์ชันปัจจุบัน: 2.0.2 เซิร์ฟเวอร์มีเครื่องมือแบบอ่านอย่างเดียว 12 รายการ แต่ละรายการครอบคลุมทรัพยากรหนึ่งรายการและรับอาร์กิวเมนต์ action พร้อมอินพุตของการดำเนินการนั้น:
| เครื่องมือ | การดำเนินการ |
|---|---|
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 |
ตัวอย่างการเรียกใช้:
{ "name": "facebook_post", "arguments": { "action": "comments", "link": "https://www.facebook.com/nike/posts/POST_ID", "limit": 20 } }
หากไม่มี action หรืออินพุตที่จำเป็น ระบบจะแสดงข้อผิดพลาดก่อนใช้เครดิต คำอธิบายของเครื่องมือแต่ละรายการในไคลเอ็นต์จะแสดงอินพุตเดียวกันสำหรับแต่ละการดำเนินการ
อัปเกรดจาก 1.x ใช่ไหม? ชื่อเครื่องมือแบบแยกตามปลายทางเดิม (เช่น facebook_get_page_details) ยังคงใช้งานได้เมื่อเรียกใช้โดยตรง ดังนั้นสคริปต์ที่มีอยู่จะยังทำงานต่อไป หากไคลเอ็นต์ของคุณอนุมัติเครื่องมือโดยอัตโนมัติหรือกำหนดรายการอนุญาตตามชื่อ ให้เพิ่มชื่อใหม่ด้านบน
อินพุตตามการดำเนินการ
คิดเครดิตต่อการเรียกใช้ เว้นแต่จะระบุไว้เป็นอย่างอื่น การแบ่งหน้า: ส่ง end_cursor จากการตอบกลับเพื่อรับหน้าถัดไป
facebook_page
เพจ Facebook: รายละเอียดโปรไฟล์ ID เพจ โพสต์ วิดีโอ รีล และอัลบั้มรูปภาพ
| การดำเนินการ | อินพุตที่จำเป็น | อินพุตที่ไม่บังคับ | เครดิต |
|---|---|---|---|
details | link | exact_followers_count | 1 (5 เมื่อใช้ exact_followers_count=true) |
id | link | — | 1 |
posts | link | limit, end_cursor, after_time, before_time, timezone | 1 ต่อโพสต์ที่ส่งคืน 3 รายการ (ขั้นต่ำ 1) |
videos | link หรือ profile_id | limit, end_cursor | 1 |
reels | link | end_cursor | 1 |
albums | profile_id (จาก id) | limit (8-16), end_cursor | 1 |
album_items | album_id (จาก albums) | end_cursor | 1 |
facebook_group
กลุ่ม Facebook สาธารณะ: รายละเอียด ID กลุ่ม โพสต์ วิดีโอ และอัลบั้มรูปภาพ
| การดำเนินการ | อินพุตที่จำเป็น | อินพุตที่ไม่บังคับ | เครดิต |
|---|---|---|---|
details | link | — | 1 |
id | link | — | 1 |
posts | link | limit, end_cursor, after_time, before_time, timezone | 1 ต่อโพสต์ที่ส่งคืน 3 รายการ (ขั้นต่ำ 1) |
videos | link | end_cursor | 1 |
albums | group_id (จาก id) | limit (8-16) | 1 |
album_items | album_id (จาก albums) | end_cursor | 1 |
facebook_post
โพสต์ วิดีโอ และความคิดเห็นบน Facebook: รายละเอียดโพสต์ ไฟล์แนบ ความคิดเห็น และการตอบกลับ
| การดำเนินการ | อินพุตที่จำเป็น | อินพุตที่ไม่บังคับ | เครดิต |
|---|---|---|---|
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
ค้นหา Facebook ด้วยคำสำคัญ: เพจ ผู้คน โพสต์ วิดีโอ และสถานที่
| การดำเนินการ | อินพุตที่จำเป็น | อินพุตที่ไม่บังคับ | เครดิต |
|---|---|---|---|
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: ค้นหาโฆษณา ค้นหาผู้ลงโฆษณาด้วยคำสำคัญ ดูรายละเอียดเพจผู้ลงโฆษณา รายละเอียดโฆษณารายการเดียว และประเทศที่รองรับ
| การดำเนินการ | อินพุตที่จำเป็น | อินพุตที่ไม่บังคับ | เครดิต |
|---|---|---|---|
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: ค้นหารายการสินค้า ยานพาหนะ และที่พักให้เช่า ดูรายละเอียดรายการสินค้าและผู้ขาย หมวดหมู่ และพิกัดเมือง
| การดำเนินการ | อินพุตที่จำเป็น | อินพุตที่ไม่บังคับ | เครดิต |
|---|---|---|---|
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
ดาวน์โหลดสื่อจาก Facebook (รูปภาพ วิดีโอ เสียง) จาก URL
| การดำเนินการ | อินพุตที่จำเป็น | อินพุตที่ไม่บังคับ | เครดิต |
|---|---|---|---|
download | url | — | 1 |
instagram_profile
โปรไฟล์ Instagram: รายละเอียด ID ผู้ใช้ โพสต์ รีล ไฮไลต์ และสตอรี่ไฮไลต์
| การดำเนินการ | อินพุตที่จำเป็น | อินพุตที่ไม่บังคับ | เครดิต |
|---|---|---|---|
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
โพสต์ Instagram: รายละเอียดโพสต์ทั้งหมด หรือ shortcode จาก URL ของโพสต์
| การดำเนินการ | อินพุตที่จำเป็น | อินพุตที่ไม่บังคับ | เครดิต |
|---|---|---|---|
details | shortcode | — | 1 |
id | link | — | 1 |
instagram_reels
Instagram Reels: ฟีดที่กำลังเป็นกระแส หรือรีลที่ใช้แทร็กเสียงที่ระบุ
| การดำเนินการ | อินพุตที่จำเป็น | อินพุตที่ไม่บังคับ | เครดิต |
|---|---|---|---|
feed | — | clips_media_id | 1 |
by_audio | audio_id | max_id | 1 |
instagram_search
ค้นหา Instagram ด้วยคำสำคัญ เพื่อหาผู้ใช้ แฮชแท็ก และสถานที่ยอดนิยม
| การดำเนินการ | อินพุตที่จำเป็น | อินพุตที่ไม่บังคับ | เครดิต |
|---|---|---|---|
search | keyword | end_cursor | 1 |
instagram_location
สถานที่บน Instagram: โพสต์ที่แท็กสถานที่ และสถานที่ใกล้เคียง
| การดำเนินการ | อินพุตที่จำเป็น | อินพุตที่ไม่บังคับ | เครดิต |
|---|---|---|---|
posts | location_id | tab, end_cursor | 1 |
nearby | location_id | — | 1 |
ตัวอย่างพรอมป์ต์
"ดูรายละเอียดเพจ Facebook ของ Nike และสรุปโพสต์ 10 รายการล่าสุด"
"เปรียบเทียบจำนวนผู้ติดตามของ Adidas และ Nike บน Instagram"
"ค้นหาโฆษณาที่ยังใช้งานอยู่ใน Meta Ads Library ซึ่งกล่าวถึง 'running shoes' ในสหรัฐอเมริกา"
การแก้ไขปัญหา
| อาการ | วิธีแก้ |
|---|---|
Missing SocialAPIs API key | เพิ่มส่วนหัว Authorization: Bearer <key> (แบบโฮสต์) หรือ SOCIALAPIS_API_KEY (npx) |
| ผลลัพธ์แสดง HTTP 401 หรือ 403 | คัดลอกคีย์จากแดชบอร์ดอีกครั้ง |
Insufficient credits | อัปเกรดหรือเติมเครดิตที่ socialapis.io/pricing |
| ไม่มีรายการเครื่องมือ | รีสตาร์ตไคลเอ็นต์หลังแก้ไขการตั้งค่า และตรวจสอบว่า https://mcp.socialapis.io/health ตอบสนอง (เปิดในเบราว์เซอร์) |
ติดต่อเรา
เซิร์ฟเวอร์นี้อยู่ใน official MCP Registry ในชื่อ io.github.SocialAPIsHub/social-media-api และยังอยู่บน Smithery, Glama, cursor.directory, LobeHub, mcp.so และ mcpservers.org ดูลิงก์ได้ที่ socialapis.io/integrations
ซอร์สโค้ด: github.com/SocialAPIsHub/mcp-server หากมีคำถาม: support@socialapis.io