Tools

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.

ToolWhat it doesCost
facebook_get_profileGet a Facebook pageFrom 1 credit
facebook_get_postsGet a page's postsFrom 1 credit
facebook_get_postGet a Facebook postFrom 1 credit
facebook_get_commentsGet a post's commentsFrom 1 credit
facebook_get_group_postsGet a group's postsFrom 1 credit
facebook_get_transcriptGet a video's transcriptFrom 1 credit

Get a Facebook page

Toolfacebook_get_profile

One Facebook page: its followers, its category, its address and its website.

Good for

Checking a business page is real and current, reading its category and contact details.

Not the tool for
What you get

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.

Cost

1 credit. Cached 24 hours.

Parameters

ParameterDefault and notes
handleThe account's handle, with or without the @.
urlThe 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.

Example input
{
  "url": "https://www.facebook.com/gymshark"
}

Get a page's posts

Toolfacebook_get_posts

The posts on one Facebook page, newest first.

Good for

Watching what a business page publishes, judging cadence and reactions.

Not the tool for
What you get

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.

Cost

1 credit per page. Cached 6 hours.

Parameters

ParameterDefault and notes
handleThe account's handle, with or without the @.
urlThe 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.

Example input
{
  "url": "https://www.facebook.com/gymshark"
}

Get a Facebook post

Toolfacebook_get_post

One Facebook post with its reactions, comments, shares and views.

Good for

A row is worth the detail, or you have a URL and nothing else.

Not the tool for
What you get

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.

Cost

1 credit. Cached 6 hours.

Parameters

ParameterDefault and notes
urlRequired. The full URL of a Facebook post or reel.

It also takes the common parameters max_credits and dry_run.

Example input
{
  "url": "https://www.facebook.com/reel/1535656380759655"
}

Get a post's comments

Toolfacebook_get_comments

The comments on one Facebook post.

Good for

Reading what people replied to a page or a group post.

Not the tool for
  • The post itself, use facebook_get_post.
  • Comments across many posts, which Facebook does not offer.
What you get

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.

Cost

1 credit per page. Cached 6 hours.

Parameters

ParameterDefault and notes
urlRequired. The full URL of a Facebook post or reel.

It also takes the common parameters cursor, max_credits and dry_run.

Example input
{
  "url": "https://www.facebook.com/reel/1535656380759655"
}

Get a group's posts

Toolfacebook_get_group_posts

The posts in one Facebook group, newest first.

Good for

Watching a community you sell into, the way reddit_get_new_posts watches a subreddit.

Not the tool for
  • 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.
What you get

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.

Cost

1 credit per page. Cached 6 hours.

Parameters

ParameterDefault and notes
handleThe account's handle, with or without the @.
urlThe full URL of a Facebook group.

Give the group's url.

It also takes the common parameters cursor, max_credits and dry_run.

Example input
{
  "url": "https://www.facebook.com/groups/742354120555345"
}

Get a video's transcript

Toolfacebook_get_transcript

What is said out loud in one Facebook video or reel, as text.

Good for

Reading a video without watching it, pulling the claims out of a page's ad or clip.

Not the tool for
What you get

One record with platform, url, language, text (the full transcript, uncut). NoData when the post carries no speech.

Cost

1 credit. Cached 30 days.

Parameters

ParameterDefault and notes
urlRequired. The full URL of a Facebook video or reel.
languageLanguage code of the transcript to prefer, when the platform has several.

It also takes the common parameters max_credits and dry_run.

Example input
{
  "url": "https://www.facebook.com/reel/1535656380759655"
}