Facebook MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on Facebook: 43 typed functions through one MCP server. No Facebook API key needed.
- Site
- facebook.com
- Functions
- 43
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Facebook alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/facebookOne MCP server for Facebook and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
browseMarketplaceBrowse a city's Marketplace front page (optionally one category) logged out.Arguments
Name Type Required citystringFacebook's own slug, often region-suffixed: "nyc", "montreal", "trois-rivieres-qc", "kingston-ca".Yes categorystringNo Returns
FacebookMarketplaceListing[]interface FacebookMarketplaceListing { id: string; title: string; price?: string; url?: string; location?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/browseMarketplaceCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.browseMarketplace({ city: "nyc" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.browseMarketplace({"city": "nyc"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/browseMarketplace \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"city":"nyc"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.browseMarketplace({ city: "nyc" });getBusinessDetailsRead a local business Page's contact-card intro, logged out.Arguments
Name Type Required handlestringYes Returns
FacebookBusinessDetailsinterface FacebookBusinessDetails { name?: string; url: string; category?: string; phone?: string; email?: string; website?: string; address?: string; hours?: string; services?: string; // the site's own labels, read the values off a result, never guess one from prose priceRange?: string; rating?: { recommendPercent?: number; reviewCount?: number }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/getBusinessDetailsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.getBusinessDetails({ handle: "katzsdeli" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.getBusinessDetails({"handle": "katzsdeli"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/getBusinessDetails \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"handle":"katzsdeli"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.getBusinessDetails({ handle: "katzsdeli" });getConversationRead messages in a private conversation thread with another user or group.Arguments
Name Type Required conversationIdstringYes Returns
FacebookMessage[]interface FacebookMessage { id: string; senderName: string; text: string; timestamp?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/getConversationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.getConversation({ conversationId: "t.123456789" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.getConversation({"conversationId": "t.123456789"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/getConversation \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"conversationId":"t.123456789"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.getConversation({ conversationId: "t.123456789" });getEventDetailsRead a public Event's details.Arguments
Name Type Required eventIdstringYes Returns
FacebookEventDetailsinterface FacebookEventDetails { id: string; name: string; url: string; startTime?: string; location?: string; description?: string; responderCount?: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/getEventDetailsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.getEventDetails({ eventId: "298448234317243" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.getEventDetails({"eventId": "298448234317243"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/getEventDetails \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"eventId":"298448234317243"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.getEventDetails({ eventId: "298448234317243" });getGroupInfoRead a Group's details, name, description, member count, profile photo.Arguments
Name Type Required groupIdstringYes Returns
FacebookGroupInfointerface FacebookGroupInfo { id: string; name: string; url: string; description?: string; memberCount?: number; profilePhotoUrl?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/getGroupInfoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.getGroupInfo({ groupId: "reactjs" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.getGroupInfo({"groupId": "reactjs"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/getGroupInfo \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"groupId":"reactjs"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.getGroupInfo({ groupId: "reactjs" });getGroupPostsList posts in a Group, newest first.Arguments
Name Type Required groupIdstringYes Returns
FacebookGroupPost[]interface FacebookGroupPost { id: string; text?: string; timestamp?: string; likeCount?: number; commentCount?: number; url?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/getGroupPostsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.getGroupPosts({ groupId: "reactjs" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.getGroupPosts({"groupId": "reactjs"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/getGroupPosts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"groupId":"reactjs"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.getGroupPosts({ groupId: "reactjs" });getMarketplaceListingDetailsRead a public Marketplace listing's details.Arguments
Name Type Required listingIdstringYes Returns
FacebookMarketplaceListingDetailsinterface FacebookMarketplaceListingDetails { id: string; title: string; price?: string; description?: string; location?: string; sellerName?: string; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/getMarketplaceListingDetailsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.getMarketplaceListingDetails({ listingId: "994916413658805" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.getMarketplaceListingDetails({"listingId": "994916413658805"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/getMarketplaceListingDetails \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"listingId":"994916413658805"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.getMarketplaceListingDetails({ listingId: "994916413658805" });getMarketplaceListingsSearch Facebook Marketplace listings by keyword.Arguments
Name Type Required querystringYes citystringA Marketplace city slug, same as browseMarketplace's.No Returns
FacebookMarketplaceListing[]interface FacebookMarketplaceListing { id: string; title: string; price?: string; url?: string; location?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/getMarketplaceListingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.getMarketplaceListings({ query: "bicycle" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.getMarketplaceListings({"query": "bicycle"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/getMarketplaceListings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"bicycle"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.getMarketplaceListings({ query: "bicycle" });getPageInfoRead a Page's details, name, about section, follower count, category, profile and cover photos, logged out.Arguments
Name Type Required handlestringYes Returns
FacebookPageInfointerface FacebookPageInfo { id: string; name: string; url: string; category?: string; about?: string; likeCount?: number; profilePhotoUrl?: string; coverPhotoUrl?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/getPageInfoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.getPageInfo({ handle: "nike" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.getPageInfo({"handle": "nike"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/getPageInfo \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"handle":"nike"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.getPageInfo({ handle: "nike" });getPagePostsList a Page's newest public posts, logged out.Arguments
Name Type Required handlestringYes Returns
FacebookPagePost[]interface FacebookPagePost { id: string; text?: string; timestamp?: string; likeCount?: number; commentCount?: number; url?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/getPagePostsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.getPagePosts({ handle: "nike" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.getPagePosts({"handle": "nike"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/getPagePosts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"handle":"nike"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.getPagePosts({ handle: "nike" });getPageReviewsRead the reviews people left on a business Page, logged out.Arguments
Name Type Required handlestringYes Returns
FacebookPageReview[]interface FacebookPageReview { id: string; // the review story's post id author: string; recommends: boolean; text?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/getPageReviewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.getPageReviews({ handle: "katzsdeli" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.getPageReviews({"handle": "katzsdeli"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/getPageReviews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"handle":"katzsdeli"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.getPageReviews({ handle: "katzsdeli" });getPersonProfileRead a person's public profile.Arguments
Name Type Required handlestringYes Returns
FacebookProfileinterface FacebookProfile { id: string; name: string; url: string; profilePhotoUrl?: string; bio?: string; friendCount?: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/getPersonProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.getPersonProfile({ handle: "zuck" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.getPersonProfile({"handle": "zuck"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/getPersonProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"handle":"zuck"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.getPersonProfile({ handle: "zuck" });getPhotoAlbumRead a photo album's details.Arguments
Name Type Required albumIdstringYes Returns
FacebookPhotoAlbuminterface FacebookPhoto { id: string; url?: string; caption?: string; timestamp?: string; } interface FacebookPhotoAlbum { id: string; title?: string; photoCount?: number; createdAt?: string; url: string; photos: FacebookPhoto[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/getPhotoAlbumCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.getPhotoAlbum({ albumId: "a.10150123456789" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.getPhotoAlbum({"albumId": "a.10150123456789"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/getPhotoAlbum \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"albumId":"a.10150123456789"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.getPhotoAlbum({ albumId: "a.10150123456789" });getPostRead one public post from its link logged out.Arguments
Name Type Required urlstringYes Returns
FacebookPostinterface FacebookPost { id: string; url: string; author?: string; text?: string; reactionCount?: number; shareCount?: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/getPostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.getPost({ url: "<url>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.getPost({"url": "<url>"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/getPost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"url":"<url>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.getPost({ url: "<url>" });getPostCommentsRead the top comments under one public post from its link logged out.Arguments
Name Type Required urlstringYes Returns
FacebookPostComment[]interface FacebookPostComment { id: string; author?: string; text: string; timestamp?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/getPostCommentsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.getPostComments({ url: "<url>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.getPostComments({"url": "<url>"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/getPostComments \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"url":"<url>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.getPostComments({ url: "<url>" });getPrivacySettingsRead the caller's privacy settings as rendered on Facebook's own Privacy settings page.Arguments
None.
Returns
FacebookPrivacySetting[]interface FacebookPrivacySetting { id: string; label: string; value: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/getPrivacySettingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.getPrivacySettings({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.getPrivacySettings({}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/getPrivacySettings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.getPrivacySettings({});getVideoRead a public video's details.Arguments
Name Type Required videoIdstringYes Returns
FacebookVideointerface FacebookVideo { id: string; title?: string; description?: string; viewCount?: number; commentCount?: number; timestamp?: string; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/getVideoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.getVideo({ videoId: "2166091230582141" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.getVideo({"videoId": "2166091230582141"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/getVideo \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"videoId":"2166091230582141"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.getVideo({ videoId: "2166091230582141" });listConversationsList the caller's private message threads and people they can message.Arguments
None.
Returns
FacebookConversation[]interface FacebookConversation { id: string; participantName: string; lastMessagePreview?: string; unread: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/listConversationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.listConversations({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.listConversations({}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/listConversations \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.listConversations({});listEventsList upcoming events the caller is invited to or interested in.Arguments
None.
Returns
FacebookEventSummary[]interface FacebookEventSummary { id: string; name: string; url: string; startTime?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/listEventsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.listEvents({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.listEvents({}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/listEvents \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.listEvents({});listFriendsList the caller's friends or a person's visible friend list.Arguments
None.
Returns
FacebookFriend[]interface FacebookFriend { id: string; name: string; url?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/listFriendsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.listFriends({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.listFriends({}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/listFriends \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.listFriends({});listNotificationsList the caller's recent notifications.Arguments
None.
Returns
FacebookNotification[]interface FacebookNotification { id: string; text?: string; timestamp?: string; unread: boolean; url?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/listNotificationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.listNotifications({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.listNotifications({}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/listNotifications \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.listNotifications({});listPageAdsOne advertiser's Meta ads, logged out.Arguments
Name Type Required pageIdstringOR pageUrl.No pageUrlstringNo countrystringDefault "US"; "ALL" for every country.No status"active" | "inactive" | "all"Which ads to list; both counts come back regardless.No mediaType"all" | "image" | "video" | "meme" | "none"No limitnumber1-200, default 30.No cursorstringNo Returns
FacebookPageAdsinterface FacebookAd { adArchiveId: string; adUrl: string; // facebook.com/ads/library/?id=<adArchiveId> pageId: string; pageName: string; pageUrl: string | null; startDate: string | null; // YYYY-MM-DD (Pacific), when it started running endDate: string | null; // YYYY-MM-DD; null while still running isActive: boolean; body: string | null; headline: string | null; linkUrl: string | null; linkDescription: string | null; caption: string | null; // display domain under the creative ctaText: string | null; // e.g. "Install now", "Sign up" displayFormat: string | null; // Facebook's label: IMAGE, VIDEO, DCO, DPA, CAROUSEL … mediaType: "image" | "video" | "multiple" | "text"; images: { url: string; resizedUrl: string | null }[]; videos: { hdUrl: string | null; sdUrl: string | null; previewImageUrl: string | null }[]; cards: { body: string | null; headline: string | null; linkUrl: string | null; ctaText: string | null; imageUrl: string | null; videoHdUrl: string | null; videoSdUrl: string | null; videoPreviewImageUrl: string | null }[]; platforms: string[]; // "FACEBOOK" | "INSTAGRAM" | "MESSENGER" | "AUDIENCE_NETWORK" | "WHATSAPP" | "THREADS" countries: string[]; // empty when Facebook lists none (most commercial ads outside the EU) collationId: string | null; // versions of one creative share it collationCount: number | null; } interface FacebookPageAds { pageId: string; pageName: string | null; totalAds: number | null; // every ad of this Page in the library for the country, active and inactive activeAds: number | null; // running now ads: FacebookAd[]; totalCount: number | null; // the count for the status listed totalCountIsCapped: boolean; nextCursor: string | null; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/listPageAdsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.listPageAds({ pageId: "170321063037656" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.listPageAds({"pageId": "170321063037656"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/listPageAds \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"pageId":"170321063037656"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.listPageAds({ pageId: "170321063037656" });listPageEventsList a public Page's own events logged out.Arguments
Name Type Required handlestringYes Returns
FacebookPageEvent[]interface FacebookPageEvent { id: string; name: string; url: string; startTime?: string; location?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/listPageEventsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.listPageEvents({ handle: "nike" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.listPageEvents({"handle": "nike"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/listPageEvents \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"handle":"nike"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.listPageEvents({ handle: "nike" });listPageReelsList a public Page's latest reels, logged out.Arguments
Name Type Required handlestringYes Returns
FacebookReel[]interface FacebookReel { id: string; url: string; // /reel/<id>, read details with getVideo({ videoId: id }) }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/listPageReelsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.listPageReels({ handle: "nike" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.listPageReels({"handle": "nike"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/listPageReels \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"handle":"nike"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.listPageReels({ handle: "nike" });listPhotosList photos posted by a Page or person, newest first, logged out.Arguments
Name Type Required handlestringYes Returns
FacebookPhoto[]interface FacebookPhoto { id: string; url?: string; caption?: string; timestamp?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/listPhotosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.listPhotos({ handle: "nike" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.listPhotos({"handle": "nike"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/listPhotos \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"handle":"nike"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.listPhotos({ handle: "nike" });searchAdLibrarySearch Meta's public Ad Library, logged out.Arguments
Name Type Required querystringKeyword or advertiser name, e.g. "hinge".No pageIdstringA Page's numeric id, e.g. "170321063037656" (the pageId on any ad).No pageUrlstring"https://www.facebook.com/<handle>", or an Ad Library link with view_all_page_id.No countrystringTwo-letter code the ads ran in, default "US"; "ALL" for every country.No status"active" | "inactive" | "all"Default "all".No mediaType"all" | "image" | "video" | "meme" | "none"Default "all".No limitnumber1-200, default 30.No cursorstringNextCursor from an earlier call with the same filters.No Returns
FacebookAdLibrarySearchinterface FacebookAd { adArchiveId: string; adUrl: string; // facebook.com/ads/library/?id=<adArchiveId> pageId: string; pageName: string; pageUrl: string | null; startDate: string | null; // YYYY-MM-DD (Pacific), when it started running endDate: string | null; // YYYY-MM-DD; null while still running isActive: boolean; body: string | null; headline: string | null; linkUrl: string | null; linkDescription: string | null; caption: string | null; // display domain under the creative ctaText: string | null; // e.g. "Install now", "Sign up" displayFormat: string | null; // Facebook's label: IMAGE, VIDEO, DCO, DPA, CAROUSEL … mediaType: "image" | "video" | "multiple" | "text"; images: { url: string; resizedUrl: string | null }[]; videos: { hdUrl: string | null; sdUrl: string | null; previewImageUrl: string | null }[]; cards: { body: string | null; headline: string | null; linkUrl: string | null; ctaText: string | null; imageUrl: string | null; videoHdUrl: string | null; videoSdUrl: string | null; videoPreviewImageUrl: string | null }[]; platforms: string[]; // "FACEBOOK" | "INSTAGRAM" | "MESSENGER" | "AUDIENCE_NETWORK" | "WHATSAPP" | "THREADS" countries: string[]; // empty when Facebook lists none (most commercial ads outside the EU) collationId: string | null; // versions of one creative share it collationCount: number | null; } interface FacebookAdLibrarySearch { ads: FacebookAd[]; totalCount: number | null; // Facebook's own "~N results" for these filters totalCountIsCapped: boolean; // true when that is Facebook's 50,000+ ceiling nextCursor: string | null; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/searchAdLibraryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.searchAdLibrary({ query: "hinge", country: "US", status: "all" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.searchAdLibrary({"query": "hinge", "country": "US", "status": "all"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/searchAdLibrary \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"hinge","country":"US","status":"all"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.searchAdLibrary({ query: "hinge", country: "US", status: "all" });searchGroupsSearch for Groups by name or topic.Arguments
Name Type Required querystringYes Returns
FacebookGroupSearchResult[]interface FacebookGroupSearchResult { id: string; name: string; url?: string; memberCount?: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/searchGroupsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.searchGroups({ query: "reactjs" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.searchGroups({"query": "reactjs"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/searchGroups \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"reactjs"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.searchGroups({ query: "reactjs" });searchPagesSearch for Pages by name or category.Arguments
Name Type Required querystringYes Returns
FacebookPageSearchResult[]interface FacebookPageSearchResult { id: string; name: string; url?: string; category?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/searchPagesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.searchPages({ query: "NASA" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.searchPages({"query": "NASA"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/searchPages \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"NASA"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.searchPages({ query: "NASA" });searchPeopleSearch for Facebook users by name.Arguments
Name Type Required querystringYes Returns
FacebookPerson[]interface FacebookPerson { id: string; name: string; url?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/searchPeopleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.searchPeople({ query: "Alice" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.searchPeople({"query": "Alice"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/searchPeople \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"Alice"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.searchPeople({ query: "Alice" });
commentOnPostLeave a comment on a post, by its permalink URL.Arguments
Name Type Required postUrlstringYes textstringYes Returns
FacebookCommentinterface FacebookComment { id: string; postUrl: string; text: string; posted: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/commentOnPostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.commentOnPost({ postUrl: "<postUrl>", text: "<text>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.commentOnPost({"postUrl": "<postUrl>", "text": "<text>"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/commentOnPost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"postUrl":"<postUrl>","text":"<text>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.commentOnPost({ postUrl: "<postUrl>", text: "<text>" });followPageFollow or unfollow a Page by its handle.Arguments
Name Type Required handlestringYes followbooleanNo Returns
FacebookPageFollowinterface FacebookPageFollow { id: string; handle: string; following: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/followPageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.followPage({ handle: "<handle>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.followPage({"handle": "<handle>"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/followPage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"handle":"<handle>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.followPage({ handle: "<handle>" });joinGroupRequest to join a Group by its id or url slug.Arguments
Name Type Required groupIdstringYes Returns
FacebookGroupJoininterface FacebookGroupJoin { id: string; groupId: string; joined: boolean; pending?: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/joinGroupCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.joinGroup({ groupId: "<groupId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.joinGroup({"groupId": "<groupId>"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/joinGroup \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"groupId":"<groupId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.joinGroup({ groupId: "<groupId>" });likePhotoLike or unlike a photo.Arguments
Name Type Required photoUrlstringYes likebooleanNo Returns
FacebookPhotoLikeinterface FacebookPhotoLike { id: string; photoUrl: string; liked: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/likePhotoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.likePhoto({ photoUrl: "<photoUrl>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.likePhoto({"photoUrl": "<photoUrl>"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/likePhoto \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"photoUrl":"<photoUrl>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.likePhoto({ photoUrl: "<photoUrl>" });postToGroupPost to a Group the caller is a member of.Arguments
Name Type Required groupIdstringYes textstringYes Returns
FacebookGroupPostResultinterface FacebookGroupPostResult { id: string; groupId: string; text: string; posted: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/postToGroupCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.postToGroup({ groupId: "<groupId>", text: "<text>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.postToGroup({"groupId": "<groupId>", "text": "<text>"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/postToGroup \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"groupId":"<groupId>","text":"<text>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.postToGroup({ groupId: "<groupId>", text: "<text>" });postToPagePost to a Page the caller owns or administrates.Arguments
Name Type Required handlestringYes textstringYes Returns
FacebookPagePostResultinterface FacebookPagePostResult { id: string; handle: string; text: string; posted: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/postToPageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.postToPage({ handle: "<handle>", text: "<text>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.postToPage({"handle": "<handle>", "text": "<text>"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/postToPage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"handle":"<handle>","text":"<text>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.postToPage({ handle: "<handle>", text: "<text>" });postToTimelineWrite a text post to the caller's own timeline.Arguments
Name Type Required textstringYes Returns
FacebookTimelinePostinterface FacebookTimelinePost { id: string; text: string; posted: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/postToTimelineCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.postToTimeline({ text: "<text>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.postToTimeline({"text": "<text>"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/postToTimeline \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"text":"<text>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.postToTimeline({ text: "<text>" });reactToPostReact to a post with like, love, haha, wow, sad or angry, by its permalink URL.Arguments
Name Type Required postUrlstringYes reactionFacebookReactionKindYes Returns
FacebookReactiontype FacebookReactionKind = "like" | "love" | "haha" | "wow" | "sad" | "angry"; interface FacebookReaction { id: string; postUrl: string; reaction: FacebookReactionKind; reacted: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/reactToPostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.reactToPost({ postUrl: "<postUrl>", reaction: "<reaction>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.reactToPost({"postUrl": "<postUrl>", "reaction": "<reaction>"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/reactToPost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"postUrl":"<postUrl>","reaction":"<reaction>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.reactToPost({ postUrl: "<postUrl>", reaction: "<reaction>" });replyToCommentReply to a comment on a post, by the comment's own permalink URL.Arguments
Name Type Required commentUrlstringYes textstringYes Returns
FacebookCommentReplyinterface FacebookCommentReply { id: string; commentUrl: string; text: string; posted: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/replyToCommentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.replyToComment({ commentUrl: "<commentUrl>", text: "<text>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.replyToComment({"commentUrl": "<commentUrl>", "text": "<text>"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/replyToComment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"commentUrl":"<commentUrl>","text":"<text>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.replyToComment({ commentUrl: "<commentUrl>", text: "<text>" });savePostSave (bookmark) a post for later or add to a saved collection.Arguments
Name Type Required postUrlstringYes Returns
FacebookSavedPostinterface FacebookSavedPost { id: string; postUrl: string; saved: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/savePostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.savePost({ postUrl: "<postUrl>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.savePost({"postUrl": "<postUrl>"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/savePost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"postUrl":"<postUrl>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.savePost({ postUrl: "<postUrl>" });sendMessageSend a direct message in an existing conversation thread.Arguments
Name Type Required conversationIdstringYes textstringYes Returns
FacebookSentMessageinterface FacebookSentMessage { id: string; conversationId: string; text: string; sent: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/sendMessageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.sendMessage({ conversationId: "<conversationId>", text: "<text>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.sendMessage({"conversationId": "<conversationId>", "text": "<text>"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/sendMessage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"conversationId":"<conversationId>","text":"<text>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.sendMessage({ conversationId: "<conversationId>", text: "<text>" });updatePrivacySettingsChange the caller's "Who can see your future posts?" audience setting.Arguments
Name Type Required setting"futurePostsAudience"Yes valueFacebookPrivacySettingAudienceYes Returns
FacebookPrivacySettingUpdateinterface FacebookPrivacySettingUpdate { id: string; setting: string; value: string; updated: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/updatePrivacySettingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.updatePrivacySettings({ setting: "futurePostsAudience", value: "<value>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.updatePrivacySettings({"setting": "futurePostsAudience", "value": "<value>"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/updatePrivacySettings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"setting":"futurePostsAudience","value":"<value>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.updatePrivacySettings({ setting: "futurePostsAudience", value: "<value>" });updateProfileEdit the caller's own profile bio.Arguments
Name Type Required biostringYes Returns
FacebookProfileUpdateinterface FacebookProfileUpdate { id: string; bio: string; updated: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/facebook/updateProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.facebook.updateProfile({ bio: "<bio>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.facebook.updateProfile({"bio": "<bio>"}))curl -X POST https://api.bowmark.ai/v1/sites/facebook/updateProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"bio":"<bio>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.facebook.updateProfile({ bio: "<bio>" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/facebook/<function> - OpenAPI
/v1/sites/facebook/openapi.json