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.