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_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

ตัวอย่างการเรียกใช้:

{ "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 เพจ โพสต์ วิดีโอ รีล และอัลบั้มรูปภาพ

การดำเนินการอินพุตที่จำเป็นอินพุตที่ไม่บังคับเครดิต
detailslinkexact_followers_count1 (5 เมื่อใช้ exact_followers_count=true)
idlink—1
postslinklimit, end_cursor, after_time, before_time, timezone1 ต่อโพสต์ที่ส่งคืน 3 รายการ (ขั้นต่ำ 1)
videoslink หรือ profile_idlimit, end_cursor1
reelslinkend_cursor1
albumsprofile_id (จาก id)limit (8-16), end_cursor1
album_itemsalbum_id (จาก albums)end_cursor1

facebook_group

กลุ่ม Facebook สาธารณะ: รายละเอียด ID กลุ่ม โพสต์ วิดีโอ และอัลบั้มรูปภาพ

การดำเนินการอินพุตที่จำเป็นอินพุตที่ไม่บังคับเครดิต
detailslink—1
idlink—1
postslinklimit, end_cursor, after_time, before_time, timezone1 ต่อโพสต์ที่ส่งคืน 3 รายการ (ขั้นต่ำ 1)
videoslinkend_cursor1
albumsgroup_id (จาก id)limit (8-16)1
album_itemsalbum_id (จาก albums)end_cursor1

facebook_post

โพสต์ วิดีโอ และความคิดเห็นบน Facebook: รายละเอียดโพสต์ ไฟล์แนบ ความคิดเห็น และการตอบกลับ

การดำเนินการอินพุตที่จำเป็นอินพุตที่ไม่บังคับเครดิต
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

ค้นหา Facebook ด้วยคำสำคัญ: เพจ ผู้คน โพสต์ วิดีโอ และสถานที่

การดำเนินการอินพุตที่จำเป็นอินพุตที่ไม่บังคับเครดิต
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: ค้นหาโฆษณา ค้นหาผู้ลงโฆษณาด้วยคำสำคัญ ดูรายละเอียดเพจผู้ลงโฆษณา รายละเอียดโฆษณารายการเดียว และประเทศที่รองรับ

การดำเนินการอินพุตที่จำเป็นอินพุตที่ไม่บังคับเครดิต
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: ค้นหารายการสินค้า ยานพาหนะ และที่พักให้เช่า ดูรายละเอียดรายการสินค้าและผู้ขาย หมวดหมู่ และพิกัดเมือง

การดำเนินการอินพุตที่จำเป็นอินพุตที่ไม่บังคับเครดิต
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

ดาวน์โหลดสื่อจาก Facebook (รูปภาพ วิดีโอ เสียง) จาก URL

การดำเนินการอินพุตที่จำเป็นอินพุตที่ไม่บังคับเครดิต
downloadurl—1

instagram_profile

โปรไฟล์ Instagram: รายละเอียด ID ผู้ใช้ โพสต์ รีล ไฮไลต์ และสตอรี่ไฮไลต์

การดำเนินการอินพุตที่จำเป็นอินพุตที่ไม่บังคับเครดิต
detailsusernamelink1
id—link, username1
posts—username, user_id, end_cursor1
reelsuser_idend_cursor1
highlightsuser_id—1
highlight_detailshighlight_id—1

instagram_post

โพสต์ Instagram: รายละเอียดโพสต์ทั้งหมด หรือ shortcode จาก URL ของโพสต์

การดำเนินการอินพุตที่จำเป็นอินพุตที่ไม่บังคับเครดิต
detailsshortcode—1
idlink—1

instagram_reels

Instagram Reels: ฟีดที่กำลังเป็นกระแส หรือรีลที่ใช้แทร็กเสียงที่ระบุ

การดำเนินการอินพุตที่จำเป็นอินพุตที่ไม่บังคับเครดิต
feed—clips_media_id1
by_audioaudio_idmax_id1

instagram_search

ค้นหา Instagram ด้วยคำสำคัญ เพื่อหาผู้ใช้ แฮชแท็ก และสถานที่ยอดนิยม

การดำเนินการอินพุตที่จำเป็นอินพุตที่ไม่บังคับเครดิต
searchkeywordend_cursor1

instagram_location

สถานที่บน Instagram: โพสต์ที่แท็กสถานที่ และสถานที่ใกล้เคียง

การดำเนินการอินพุตที่จำเป็นอินพุตที่ไม่บังคับเครดิต
postslocation_idtab, end_cursor1
nearbylocation_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