Facebook tools
Read Facebook pages, posts, groups, comments and transcripts from your agent: each tool's parameters, what it returns and what it costs.
Read public Facebook pages, groups, posts and comments, and the transcripts of videos. A good place to start is a page with facebook_get_profile, then its posts with facebook_get_posts. To follow a community, read a group with facebook_get_group_posts.
Each call costs what the data provider charges for it, and each tool below gives its cost. If Facebook has no way to answer a question, such as comments across many posts at once, there is no tool for it.
To connect these tools to your agent, see the Facebook MCP page.
| Tool | What it does | Cost |
|---|---|---|
facebook_get_profile | Get a Facebook page | From 1 credit |
facebook_get_posts | Get a page's posts | From 1 credit |
facebook_get_post | Get a Facebook post | From 1 credit |
facebook_get_comments | Get a post's comments | From 1 credit |
facebook_get_group_posts | Get a group's posts | From 1 credit |
facebook_get_transcript | Get a video's transcript | From 1 credit |
Get a Facebook page
facebook_get_profileOne Facebook page: its followers, its category, its address and its website.
Checking a business page is real and current, reading its category and contact details.
- Its posts, use
facebook_get_posts. - Its ads, use
ads_get_advertiser_adswith platform facebook.
One record. The page's handle, name, bio, followers, likes, website, links, email and phone (its public contact details), running_ads (whether it is advertising now) and ad_library_id (what ads_get_advertiser_ads takes for it), with other profile fields where Facebook fills them. null or empty = the platform does not publish it. kind is company, because these are pages rather than people.
1 credit. Cached 24 hours.
Parameters
| Parameter | Default and notes |
|---|---|
handle | The account's handle, with or without the @. |
url | The full URL of a Facebook page. |
Give one of handle (a page name) or url.
It also takes the common parameters max_credits and dry_run.
{
"url": "https://www.facebook.com/gymshark"
}Get a page's posts
facebook_get_postsThe posts on one Facebook page, newest first.
Watching what a business page publishes, judging cadence and reactions.
- A group's posts, use
facebook_get_group_posts. - One post in full, use
facebook_get_post.
A list. Each row has posts with author and author_followers, created_at, text (cut at 2000 characters), likes, comments, shares, saves, views, media, duration_s, links, transcript and top_comments[]. top_comments are the comments Facebook shows under the post, with each commenter's profile URL. null or empty = the platform does not publish it. Facebook publishes no share count, so shares is null.
1 credit per page. Cached 6 hours.
Parameters
| Parameter | Default and notes |
|---|---|
handle | The account's handle, with or without the @. |
url | The full URL of a Facebook page. |
Give one of handle (a page name) or url.
It also takes the common parameters cursor, max_credits and dry_run.
{
"url": "https://www.facebook.com/gymshark"
}Get a Facebook post
facebook_get_postOne Facebook post with its reactions, comments, shares and views.
A row is worth the detail, or you have a URL and nothing else.
- The comments themselves, use
facebook_get_comments. - What is said in a video, use
facebook_get_transcript.
One record with Each row has the one post, with author and author_followers, created_at, text (cut at 2000 characters), likes, comments, shares, saves, views, media, duration_s, links, transcript and top_comments[]. null or empty = the platform does not publish it.
1 credit. Cached 6 hours.
Parameters
| Parameter | Default and notes |
|---|---|
url | Required. The full URL of a Facebook post or reel. |
It also takes the common parameters max_credits and dry_run.
{
"url": "https://www.facebook.com/reel/1535656380759655"
}Get a post's comments
facebook_get_commentsThe comments on one Facebook post.
Reading what people replied to a page or a group post.
- The post itself, use
facebook_get_post. - Comments across many posts, which Facebook does not offer.
A list. Each row has one comment each: author, created_at, text (cut at 2000 characters), likes, replies, and parent_id and depth for a reply.
1 credit per page. Cached 6 hours.
Parameters
| Parameter | Default and notes |
|---|---|
url | Required. The full URL of a Facebook post or reel. |
It also takes the common parameters cursor, max_credits and dry_run.
{
"url": "https://www.facebook.com/reel/1535656380759655"
}Get a group's posts
facebook_get_group_postsThe posts in one Facebook group, newest first.
Watching a community you sell into, the way reddit_get_new_posts watches a subreddit.
- A page's own posts, use
facebook_get_posts. - A complete window since a moment, which Facebook does not offer: page with the cursor and dedupe on id.
A list. Each row has posts with author and author_followers, created_at, text (cut at 2000 characters), likes, comments, shares, saves, views, media, duration_s, links, transcript and top_comments[]. top_comments are the comments Facebook shows under the post, with each commenter's profile URL. null or empty = the platform does not publish it.
1 credit per page. Cached 6 hours.
Parameters
| Parameter | Default and notes |
|---|---|
handle | The account's handle, with or without the @. |
url | The full URL of a Facebook group. |
Give the group's url.
It also takes the common parameters cursor, max_credits and dry_run.
{
"url": "https://www.facebook.com/groups/742354120555345"
}Get a video's transcript
facebook_get_transcriptWhat is said out loud in one Facebook video or reel, as text.
Reading a video without watching it, pulling the claims out of a page's ad or clip.
- The post's text, which
facebook_get_postalready returns.
One record with platform, url, language, text (the full transcript, uncut). NoData when the post carries no speech.
1 credit. Cached 30 days.
Parameters
| Parameter | Default and notes |
|---|---|
url | Required. The full URL of a Facebook video or reel. |
language | Language code of the transcript to prefer, when the platform has several. |
It also takes the common parameters max_credits and dry_run.
{
"url": "https://www.facebook.com/reel/1535656380759655"
}