🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Tiktok Analytics

by @snoopyrain

Track TikTok performance and analytics. Use when the user says 'TikTok analytics', 'TikTok metrics', 'how are my TikToks doing', 'TikTok video views', 'TikTo...

Versionv1.0.1
Downloads707
TERMINAL
clawhub install tiktok-analytics

πŸ“– About This Skill


name: tiktok-analytics description: "Track TikTok performance and analytics. Use when the user says 'TikTok analytics', 'TikTok metrics', 'how are my TikToks doing', 'TikTok video views', 'TikTok engagement', 'TikTok performance', or wants to see video views, likes, comments, shares, and account-level metrics for their TikTok account." version: 1.0.0 metadata: openclaw: emoji: "πŸ“Š" homepage: https://boring-doc.aiagent-me.com/getting-started/mcp.html requires: config: - MCP Connector link from boring.aiagent-me.com (contains embedded auth token)

TikTok Analytics

Track your TikTok performance β€” video views, likes, comments, shares, and account-level engagement. 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

    1. Sign up at 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="",
      platform="tiktok",
      period="week"       // "day", "week", or "month"
    )
    

    #### Per-Video Analytics (Real-Time)

    boring_get_video_analytics(
      account_id="",
      platform="tiktok",
      limit=20             // max 100
    )
    

    #### Historical Video Performance (Snapshots)

    boring_get_posts_performance(
      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

    βš™οΈ Configuration

    1. Sign up at 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