Facebook Pages

Publish and manage Facebook Page content through a preconfigured MyBrandMetrics API connection. Use this skill to connect Facebook Pages, list connected accounts and available Pages, create Page feed posts, publish Page photos or videos, read Page feeds, read and manage comments, and fetch Page or post insights. Supports bearer-token or API-key authentication, page/account/connection targeting, pagination, unpublished posts, comment moderation, and structured JSON API responses.

Publish Facebook Page posts, photos, and videos; read Page feeds and comments; moderate comments; and fetch Page or post insights through the MyBrandMetrics Facebook Pages API.

Use this skill when the user wants to connect Facebook Pages, list available Pages, post to a Facebook Page, publish a Page photo, upload a Page video, read Page posts, reply to Page comments, hide or unhide comments, delete comments, or check Page and post insights.

Website: https://www.clawbus.com/
MyBrandMetrics API: https://mybrandmetrics.com/

Why This Facebook Pages Skill

This skill	Building your own Facebook Pages integration
Use one MyBrandMetrics connection for Facebook Pages.	Set up and maintain your own Meta app, auth flow, and Page token storage.
Target a Page by page_id, account_id, or connection_id when supported.	Build your own account and Page resolution layer before each request.
Publish feed posts, photos, and videos through one script.	Implement separate Page post, photo, and video endpoints yourself.
Read feeds, comments, Page insights, and post insights from the same tool.	Wire together multiple Graph API read paths, fields, pagination, and metrics.
Create, edit, hide, unhide, and delete comments with explicit commands.	Build your own comment moderation workflow and safety checks.
Return the real MyBrandMetrics JSON response.	Build response normalization, error handling, and retry decisions yourself.

Use this when you want Facebook Page publishing, moderation, and insights without building a full Facebook Pages backend yourself.

Core Capabilities

Capability	Details
Connect Pages	Start the Facebook Pages OAuth connection flow through MyBrandMetrics.
List connections	List connected Meta accounts for the facebook_pages source.
List Pages	List available Facebook Pages for the connected account.
Publish feed posts	Create Page feed posts with text, links, optional picture URLs, and optional unpublished mode.
Publish photos	Publish Page photo posts from public image URLs.
Publish videos	Publish Page video posts from public video URLs.
Read Page feed	Fetch Page feed posts with configurable fields, limit, and pagination cursors.
Read comments	Fetch comments for a post or object with fields, limit, and pagination cursors.
Manage comments	Create comments, edit comment text, hide or unhide comments, and delete comments.
Page insights	Fetch Page insight metrics with period and date range options.
Post insights	Fetch post insight metrics by post_id or object_id.

Setup Flow

1. Open https://mybrandmetrics.com/ and sign in.
2. Connect Facebook Pages through MyBrandMetrics.
3. Get a MyBrandMetrics bearer token or API key.
4. Install the clawbus-facebook-pages skill.
5. Provide credentials through command-line arguments, environment variables, or a workspace config.json.
6. List connections and available Pages if you do not already know the target.
7. Run the publish, feed, comment, or insights workflow.

For photos and videos, the media URL must be publicly reachable.

Credentials

Use a MyBrandMetrics bearer token or API key. You can provide it through command line flags, environment variables, or a workspace config file. If the target Page is already known, provide page_id; otherwise list available Pages first.

For the full credential shape, see references/configuration.md.

Workflow

Use natural-language prompts after the skill is installed. Include:

• the task: connect, list Pages, publish, read feed, manage comments, or fetch insights;
• the target page_id, account_id, or connection_id;
• the post message, link, photo URL, or video URL for publishing;
• the object_id, post_id, or comment_id for comment and insights work;
• the fields, metrics, period, date range, limit, or pagination cursor when needed.

Before creating, updating, hiding, unhiding, deleting, or publishing anything, confirm the target Page, content, IDs, and intended visibility. Read-only list, feed, comments, and insights calls can run after the target is clear.

Use The Script Directly

Use scripts/facebook_pages.py.

List available Pages:

python3 scripts/facebook_pages.py list-accounts

Publish a Page post:

python3 scripts/facebook_pages.py publish-post \
  --page-id "PAGE_ID" \
  --message "Hello from the Pages API!" \
  --link "https://www.mybrandmetrics.com"

Publish a Page photo:

python3 scripts/facebook_pages.py publish-photo \
  --page-id "PAGE_ID" \
  --url "https://example.com/image.jpg" \
  --caption "Photo from the Pages API"

Read comments:

python3 scripts/facebook_pages.py comments \
  --page-id "PAGE_ID" \
  --object-id "POST_ID" \
  --limit 25

Hide a comment:

python3 scripts/facebook_pages.py comment-update \
  --page-id "PAGE_ID" \
  --comment-id "COMMENT_ID" \
  --hide

Fetch Page insights:

python3 scripts/facebook_pages.py insights \
  --page-id "PAGE_ID" \
  --metrics "page_impressions,page_fans"

Commands

Command	Purpose
connect	Start the Facebook Pages OAuth connect flow.
list-connections	List connected Meta accounts.
list-accounts	List available Facebook Pages.
publish-post	Create a Page feed post.
publish-photo	Create a Page photo post from a public image URL.
publish-video	Create a Page video post from a public video URL.
feed	Read Page feed posts.
comments	Read comments for a post or object.
comment-create	Create a comment on a post or object.
comment-update	Edit, hide, or unhide a comment.
comment-delete	Delete a comment.
insights	Read Page insight metrics.
post-insights	Read post insight metrics.

Reference Files

File	Purpose
references/configuration.md	Credential setup, auth modes, base URL, and config examples.
references/examples.md	Concrete invocation examples for each workflow.