tiktok-analytics

# TikTok Analytics Track your TikTok performance — video views, likes, comments, shares, and account-level engagement. 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 TikTok** 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, engagement) | | `boring_get_video_analytics` | Real-time platform API | Per-video metrics (views, likes, comments, shares) | | `boring_get_posts_performance` | Daily snapshots (collected at 2 AM) | Historical video 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 `tiktok` platform. ### Step 2: Determine What the User Wants | User Request | Tool to Use | |-------------|------------| | "How is my TikTok doing?" | `boring_get_performance` | | "Show my best TikToks" | `boring_get_video_analytics` | | "TikTok performance this month" | `boring_get_posts_performance` | | "What did I post on TikTok?" | `boring_get_publish_history` | ### Step 3: Fetch Data #### Account-Level Performance ``` boring_get_performance( account_id="<account_id>", platform="tiktok", period="week" // "day", "week", or "month" ) ``` #### Per-Video Analytics (Real-Time) ``` boring_get_video_analytics( account_id="<account_id>", platform="tiktok", limit=20 // max 100 ) ``` #### Historical Video 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 key metrics in a summary table - **Video analytics**: Rank videos by views or engagement, highlight viral hits - **Historical**: Show trends over time ## TikTok Metrics | Metric | Description | |--------|-------------| | Video views | Total views per video | | Likes | Video likes | | Comments | Video comments | | Shares | Video shares | | Account performance | Aggregated account-level metrics | ## 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)