Facebook Pages

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

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

Core Capabilities

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

Reference Files