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 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
- Open https://mybrandmetrics.com/ and sign in.
- Connect Facebook Pages through MyBrandMetrics.
- Get a MyBrandMetrics bearer token or API key.
- Install the
clawbus-facebook-pagesskill. - Provide credentials through command-line arguments, environment variables, or
a workspace
config.json. - List connections and available Pages if you do not already know the target.
- 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, orconnection_id; - the post message, link, photo URL, or video URL for publishing;
- the
object_id,post_id, orcomment_idfor 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. |