- name
- facebook-analytics
- description
- Track Facebook Page performance and analytics. Use when the user says 'Facebook analytics', 'Facebook page metrics', 'how is my Facebook doing', 'Facebook engagement', 'Facebook post performance', or wants to see reach, engagement, video views, and post metrics for their Facebook Page.
- version
- 1.0.0
- metadata
- openclaw
- emoji
- 📊
- homepage
- https://boring-doc.aiagent-me.com/getting-started/mcp.html
- requires
- config
Facebook Analytics
Track your Facebook Page performance — reach, engagement, video views, and post-level metrics. Powered by Boring.
Security & Data Handling
- MCP link is a credential: Your MCP Server URL (
https://boring.aiagent-me.com/mcp/t/xxxxx...) contains an embedded authentication token. Treat it like a password — do not share it publicly. - Token scope: The embedded token is read-only for analytics. It can only fetch performance metrics and account metadata. It cannot publish, delete, or modify any content on your social media accounts.
- Token storage: The token is stored server-side in Boring's database (MongoDB on DigitalOcean). It is never written to your local filesystem. You can regenerate or revoke it anytime at boring.aiagent-me.com/settings.
- Data flow: Analytics queries are sent from Boring's server (Google Cloud, us-central1) to the platform's API on your behalf. Only performance metrics are retrieved — no content is uploaded or modified.
- No local credentials: No local API keys, environment variables, or secrets are needed. All auth is embedded in the MCP link.
- Third-party service: This skill relies on Boring, an open-source social media management tool. Source code: github.com/snoopyrain.
Prerequisites
- Sign up at boring.aiagent-me.com with Google
- Connect Facebook — requires admin access to a Facebook Page
- Get your MCP link: Go to Settings → copy your MCP Server URL (contains your auth token — treat it like a password)
- Add to Claude: Paste the MCP link as a Connector — no install, no API key needed
Available Tools
| Tool | Data Source | Best For |
|---|---|---|
boring_get_performance | Real-time platform API | Page-level overview (reach, engagement, video views) |
boring_get_video_analytics | Real-time platform API | Per-post metrics (views, likes, comments, shares) |
boring_get_posts_performance | Daily snapshots (collected at 2 AM) | Historical post performance over date ranges |
boring_get_publish_history | Boring database | Publishing history and status tracking |
Workflow
Step 1: List Accounts
Call boring_list_accounts and filter for facebook platform. Show the user their connected Pages.
Step 2: Determine What the User Wants
| User Request | Tool to Use |
|---|---|
| "How is my Facebook doing?" | boring_get_performance |
| "Show my best Facebook posts" | boring_get_video_analytics |
| "Facebook performance over the last month" | boring_get_posts_performance |
| "What did I post on Facebook?" | boring_get_publish_history |
Step 3: Fetch Data
Page-Level Performance
boring_get_performance(
account_id="<account_id>",
platform="facebook",
period="week" // "day", "week", or "month"
)Per-Post Analytics (Real-Time)
boring_get_video_analytics(
account_id="<account_id>",
platform="facebook",
limit=20 // max 100
)Historical Post Performance (Snapshots)
boring_get_posts_performance(
account_id="<account_id>",
since="2025-12-01",
until="2025-12-31",
limit=20
)Step 4: Present Results
Format the data clearly:
- Page overview: Show key metrics in a summary table
- Post analytics: Rank posts by engagement, highlight top performers
- Historical: Show trends over time
Facebook Metrics
| Metric | Description |
|---|---|
page_media_view | Total video views |
page_post_engagements | Likes, comments, shares |
page_total_actions | Total page actions |
Error Handling
| Error | Solution |
|---|---|
InvalidApiKey | MCP link may be invalid — regenerate it at boring.aiagent-me.com Settings |
InvalidAccountId | Run boring_list_accounts to get valid IDs |
TokenExpired | Reconnect account at boring.aiagent-me.com |
| No data returned | Account may be newly connected — data collection runs daily at 2 AM |
Documentation
Full API docs: boring-doc.aiagent-me.com