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#

This skillBuilding your own Facebook Pages integrationUse 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#

CapabilityDetailsConnect PagesStart the Facebook Pages OAuth connection flow through MyBrandMetrics.List connectionsList connected Meta accounts for the facebook_pages source.List PagesList available Facebook Pages for the connected account.Publish feed postsCreate Page feed posts with text, links, optional picture URLs, and optional unpublished mode.Publish photosPublish Page photo posts from public image URLs.Publish videosPublish Page video posts from public video URLs.Read Page feedFetch Page feed posts with configurable fields, limit, and pagination cursors.Read commentsFetch comments for a post or object with fields, limit, and pagination cursors.Manage commentsCreate comments, edit comment text, hide or unhide comments, and delete comments.Page insightsFetch Page insight metrics with period and date range options.Post insightsFetch 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:

bash

python3 scripts/facebook_pages.py list-accounts

Publish a Page post:

bash

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:

bash

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:

bash

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

Hide a comment:

bash

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

Fetch Page insights:

bash

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

Commands#

CommandPurposeconnectStart the Facebook Pages OAuth connect flow.list-connectionsList connected Meta accounts.list-accountsList available Facebook Pages.publish-postCreate a Page feed post.publish-photoCreate a Page photo post from a public image URL.publish-videoCreate a Page video post from a public video URL.feedRead Page feed posts.commentsRead comments for a post or object.comment-createCreate a comment on a post or object.comment-updateEdit, hide, or unhide a comment.comment-deleteDelete a comment.insightsRead Page insight metrics.post-insightsRead post insight metrics.

Reference Files#

FilePurposereferences/configuration.mdCredential setup, auth modes, base URL, and config examples.references/examples.mdConcrete invocation examples for each workflow.