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