threads-analytics

# Threads Analytics Track your Threads performance — views, likes, replies, reposts, quotes, and follower growth. Powered by [Boring](https://boring-doc.aiagent-me.com). ## 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](https://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](https://boring.aiagent-me.com), an open-source social media management tool. Source code: [github.com/snoopyrain](https://github.com/snoopyrain). ## Prerequisites 1. **Sign up** at [boring.aiagent-me.com](https://boring.aiagent-me.com) with Google 2. **Connect Threads** account via OAuth 3. **Get your MCP link**: Go to **Settings** → copy your MCP Server URL (contains your auth token — treat it like a password) 4. **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 | Account-level overview (views, followers) | | `boring_get_video_analytics` | Real-time platform API | Per-post metrics (views, likes, replies, reposts) | | `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 `threads` platform. ### Step 2: Determine What the User Wants | User Request | Tool to Use | |-------------|------------| | "How are my Threads doing?" | `boring_get_performance` | | "Show my best Threads posts" | `boring_get_video_analytics` | | "Threads performance this month" | `boring_get_posts_performance` | | "What did I post on Threads?" | `boring_get_publish_history` | ### Step 3: Fetch Data #### Account-Level Performance ``` boring_get_performance( account_id="<account_id>", platform="threads", period="week" // "day", "week", or "month" ) ``` #### Per-Post Analytics (Real-Time) ``` boring_get_video_analytics( account_id="<account_id>", platform="threads", 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: - **Account overview**: Show views, followers in a summary table - **Post analytics**: Rank posts by engagement (likes + replies + reposts) - **Historical**: Show trends over time ## Threads Metrics | Metric | Description | |--------|-------------| | `views` | Post views | | `likes` | Post likes | | `replies` | Post replies | | `reposts` | Post reposts | | `quotes` | Post quotes | | `followers_count` | Account followers | ## 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](https://boring-doc.aiagent-me.com)