Skill: lucasye378/douyin-tiktok-trends (version 1.0.0)

--- name: douyin-tiktok-trends description: Fetch and analyze current trending topics, hashtags, songs, and creators on Douyin/TikTok. Triggered when the user wants to know "what's trending on TikTok/Douyin right now", "hot topics", "trending hashtags", "content trends", or asks for TikTok trend analysis. Uses TikTok's official Creative Center as the primary data source. --- # Douyin & TikTok Trend Fetcher ## Primary Data Source **TikTok Creative Center** — the official advertiser-facing trend dashboard: - Base URL: `https://ads.tiktok.com/business/creativecenter/` - No login required for most pages - Provides: Hashtags, Songs, Creators, Videos ## Available Pages ### Trending Hashtags ``` https://ads.tiktok.com/business/creativecenter/inspiration/popular/hashtag/pc/en ``` → Returns Top 20 trending hashtags with post counts. Data format: `#hashtag · NMPosts` ### Trending Songs / Sounds ``` https://ads.tiktok.com/business/creativecenter/trends/home/pc/en ``` → Returns top 5 trending songs with artist names and commercial-use badges. ### Individual Hashtag Details ``` https://ads.tiktok.com/business/creativecenter/hashtag/{hashtag-name}/pc/en ``` → Returns: post counts, trend chart, audience demographics, related hashtags, regional popularity. ### Trending Creators ``` https://ads.tiktok.com/business/creativecenter/inspiration/popular/creator/pc/en ``` ### Videos Inspiration ``` https://ads.tiktok.com/business/creativecenter/inspiration/popular/pc/en ``` ## Execution Workflow ### Step 1: Fetch Trending Hashtags Always start here — it gives the broadest view of what's hot: ``` web_fetch(url="https://ads.tiktok.com/business/creativecenter/inspiration/popular/hashtag/pc/en", maxChars=10000) ``` ### Step 2: Fetch Home/Overview Page ``` web_fetch(url="https://ads.tiktok.com/business/creativecenter/trends/home/pc/en", maxChars=10000) ``` ### Step 3: Fetch 2-3 Individual Hashtag Detail Pages Pick the top hashtags from Step 1 for deeper insights: ``` web_fetch(url="https://ads.tiktok.com/business/creativecenter/hashtag/{name}/pc/en", maxChars=5000) ``` ### Step 4: Parse and Output Extract from raw HTML and format as: ``` ## TikTok Trending — [Date] ### Top Hashtags | Rank | Hashtag | Posts | Category | |------|---------|-------|----------| | 1 | #eidmubarak | 1M | Celebration | ... ### Trending Songs | Rank | Song | Artist | Commercial? | |------|------|--------|------------| | 1 | Pyre (STEM synth) | Altitude Music / BMGPM | ✅ | ### Trending Creators | Creator | Followers | Likes | |---------|-----------|-------| | Fernanda | 9M | 668M | ### Top Hashtag Deep Dives **#[name]** - Posts: N (last 7 days) / M (overall) - Top regions: Country1, Country2, ... - Audience: [age range] - Related interests: [categories] ``` ## Output Format (Simple — Topic · Heat · Trend) When user asks for simple format, output as: ``` Topic: [hashtag/song/topic name] Heat: [post count or engagement number] Trend: [↑ rising / → stable / 🆕 new entry] ``` Example: ``` #eidmubarak · 1M Posts · ↑ Rising (Ramadan season) #marchmadness · 54K Posts · → Stable (Sports event) #spiderman · 184K Posts · 🆕 New Entry (Movie release) ``` ## Notes - **Login-gated pages**: Songs detail, Videos inspiration, Creator highlights — these require login. Fall back to home page + hashtag data if login pages return empty. - **Emoji indicator**: 🆕 marks hashtags newly entering Top 100, ↑ marks rising trends - **No browser needed**: `web_fetch` works fine on TikTok Creative Center (unlike the main TikTok.com which requires JS rendering) - **All regions default**: The pages above use global/"All regions" filter. For China-specific Douyin data, this skill has limited coverage — Douyin blocks most automated access. - **Time**: Always record the fetch timestamp — trends change daily


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)