tiktok-stats

Fetch TikTok per-post engagement metrics and export weekly snapshot JSON files.

4|2|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/michaellady/claude-social-media-skills --skill tiktok-stats
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tiktok-stats
Source: https://github.com/michaellady/claude-social-media-skills/tree/main/tiktok-stats
Command: npx skills add https://github.com/michaellady/claude-social-media-skills --skill tiktok-stats

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

TikTok analytics don’t provide a convenient, closed-loop view of per-post engagement for your account, which prevents attributing performance back to how each post was generated.

Core Features & Use Cases

  • Per-post engagement reporting: Fetches view_count, like_count, comment_count, and share_count for recent videos from TikTok’s Display API once OAuth is configured.
  • Closed-loop tag attribution: Extracts instrumented tags from captions (e.g., [opus:<id>]) so analytics can map engagement back to the originating scheduler/format.
  • Weekly snapshot caching: Writes standardized snapshot JSON into cache/snapshot-<date>.json for downstream rollups and recommendations, with delta fields vs a prior snapshot.

Quick Start

Run /tiktok-stats after completing Phase 0 (Auth Setup) to generate your weekly TikTok engagement snapshot and recent-post report.

Frequently Asked Questions about tiktok-stats

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get per-post TikTok engagement analytics for my own account?

You can retrieve per-post TikTok engagement analytics by configuring TikTok Developer OAuth credentials to call the Display API, fetching view, like, comment, and share counts for recent videos, and exporting the results as a weekly snapshot.

How does closed-loop attribution work for TikTok video performance?

Closed-loop attribution works by extracting instrumented tags from video captions using a configurable regex, allowing you to map TikTok engagement metrics back to the originating scheduler or format for downstream analysis.

Do I need TikTok OAuth credentials to fetch video engagement stats?

Yes, you must complete TikTok Developer OAuth authentication first, because the Skill calls TikTok Display API endpoints to list profile videos and extract per-post engagement metrics securely.

How do I track weekly TikTok engagement deltas for recent videos?

You can track weekly engagement deltas by running the snapshot generation process, which persists results to cache/snapshot-<date>.json and automatically calculates delta fields comparing current metrics against a prior snapshot.

Can I aggregate TikTok per-post stats with cross-skill analytics workflows?

Yes, the Skill writes standardized snapshot JSON files with extracted caption tags and delta fields specifically to support downstream rollups and cross-skill analytics aggregation workflows.