Get the identity of the authenticated Facebook user.

Resolved from the imported browser-cookie session (c_user / xs). Useful to confirm whose session is configured and whether it is still valid.

Returns: Dict with the user's id, name, and username.

Check the current cookie-session status and active Page.

Returns: Dict with valid (bool), cookie_source, me (id/name), and active_page_id / active_page_name.

Persist the active Facebook Page for display/context purposes.

Note: cookie scraping operates as the account whose cookies are imported (c_user). This tool records a Page for agent bookkeeping and for Page-mode sessions (m_page_voice cookie present). It does not switch the acting identity on its own.

List all stored Facebook identities (cookie sets).

Each stored identity has its own cookies (c_user/xs); the active one is what every tool acts as. Use switch_active_account to change it.

Returns: Dict with accounts (id, name, username, identity_type, is_active, last_used), total_accounts, and active_account.

Discover every identity the logged-in session can switch to.

Reads Facebook's account switcher — the Pages you administer, linked profiles, and the user profile itself. This is the discovery source an agent uses to learn which identities exist for this session.

Returns: Dict with accounts (id, name, typename, is_current) and total.

Store a new Facebook identity's cookie set for agent use.

The cookies dict must contain at least c_user and xs (a logged-in facebook.com session). After adding, all tools act as this identity when set_as_active is True (default).

Remove a stored Facebook identity's cookie set.

Switch which stored identity all tools act as.

Subsequent tool calls load the selected identity's cookie set, so reads and writes happen as that identity.

Get information about the currently active Facebook identity.

Returns: Active account metadata or a message when none is set.

Update cookies for an existing stored Facebook identity.

Useful for refreshing an expired session without re-adding the account.

Import a Facebook identity's cookies directly from a browser.

Uses the native cookie import machinery (the same as --login). The browser must be logged into that identity. Example: a Page whose session is open in your browser profile.

Check a stored identity's posting limits and history.

Get Facebook Page/profile details by username.

Fetches the public (or logged-in) profile page and parses name, id, bio, and follower counts from the embedded page data.

Get recent posts from a Facebook Page's timeline.

Search for public Facebook Pages by name.

Get recent posts from a user's or Page's timeline.

Get details for a single post by its URL.

Search public posts by keyword.

Publish a text post as the active (or specified) Facebook identity.

Validates the text, checks the identity's posting limits, and publishes through the web composer. If Facebook has decommissioned cookie-based writing for the account, returns a clear error rather than a false success.

Upload a photo and publish it as the active (or specified) identity.

The image is validated and normalized (resized to Facebook's feed spec) before the upload attempt. Best-effort: modern Facebook may reject cookie-based uploads; failures surface as clear errors.

Upload a video and publish it as the active (or specified) identity.

The video file is validated before the upload attempt. Best-effort: modern Facebook has largely decommissioned cookie-based video uploads; failures surface as clear, honest errors.

Upload multiple photos and publish them as one carousel post.

Each image is validated and normalized before the upload attempt. Best-effort: modern Facebook may reject cookie-based carousels; failures surface as clear, honest errors.

Delete one of the active (or specified) identity's own posts.

Checks the identity's posting limits, records the attempt, and deletes through the delete.php confirm flow. Fails honestly if the post is not available (already deleted) or deletion is decommissioned.

Save/bookmark a post to the active (or specified) identity's Saved.

Best-effort: the legacy save endpoint submits the mutation but cannot always confirm it synchronously — the result tells you to verify in the Saved collection.

Remove a post from the active (or specified) identity's Saved.

Best-effort: the legacy save endpoint submits the mutation but cannot always confirm it synchronously — the result tells you to verify in the Saved collection.

Fetch comments on a post.

Comment on a post as the active (or specified) Facebook identity.

Validates the text, checks the identity's posting limits, records the attempt, and comments through the web composer. Fails honestly if cookie-based commenting is decommissioned for the account.

Search for people by name.

Useful to find a person before messaging them (pair with get_conversations / send_message).

List Messenger conversations for the authenticated account.

Read messages from a Messenger conversation.

Send a Messenger text message as the active (or specified) identity.

Validates the text, checks the identity's posting limits, records the attempt, and sends via the legacy Mercury endpoint. Fails honestly if sending is decommissioned for the account.

Delete (unsend) a Messenger message as the active (or specified) identity.

Validates the ids, checks the identity's posting limits, records the attempt, and deletes via the legacy Mercury endpoint. Fails honestly if deletion is decommissioned for the account.

Mark a Messenger conversation as seen (clears the unread badge).

Send a typing indicator to a conversation (typing_on / typing_off).

Get Facebook group details.

Get recent posts from a group feed.

List members of a Facebook group.

Best-effort: served from the legacy browser-list endpoint, which may return an error for private groups or migrated surfaces — the result then explains the limitation honestly.

Search for Facebook groups by name.

List the authenticated identity's recent Facebook notifications.

Includes message alerts, tags, follows, and page activity. Useful for an agent to know what needs attention before deciding to act.

List upcoming events relevant to the authenticated identity.

Returns embedded event rows (id, name, start_date_time, url) from the events hub. Event details that load client-side are not available via cookie scraping.

Close all active API clients and clean up resources.