← Back to Skills Marketplace
lucasye378

Douyin & TikTok Trend Fetcher

by lucasye378 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
1296
Downloads
2
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install 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/D...
README (SKILL.md)

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
Usage Guidance
This skill is internally consistent: it only scrapes public TikTok Creative Center pages and asks for no credentials. Before installing, consider: (1) scraping limitations — many TikTok pages require JS or login, so web_fetch may return incomplete/empty results and the skill's fallback behavior may limit data; (2) rate-limiting and TOS — frequent automated requests can trigger blocks or violate site terms; (3) privacy and credentials — do not supply TikTok/Douyin login credentials to the skill (it has none declared); (4) operational testing — try it in a controlled environment to confirm web_fetch returns the expected HTML and that parsing is reliable. If you need China/Douyin-specific trends, note the SKILL.md states it has limited coverage for Douyin.
Capability Analysis
Type: OpenClaw Skill Name: douyin-tiktok-trends Version: 1.0.0 The skill is designed to fetch and analyze trending topics from the official TikTok Creative Center. It uses the `web_fetch` tool to access public data on legitimate domains (ads.tiktok.com) and provides structured formatting for the user, with no evidence of malicious intent, data exfiltration, or prompt injection.
Capability Assessment
Purpose & Capability
The name and description say the skill fetches TikTok/Douyin trends; the SKILL.md only fetches public Creative Center URLs and parses HTML. No unrelated credentials, binaries, or installs are requested, which is coherent with the stated purpose.
Instruction Scope
Instructions are narrowly scoped to calling web_fetch on specific Creative Center URLs, selecting top hashtags, and parsing the returned HTML. Note: the SKILL.md claims 'No browser needed' — that may be brittle or inaccurate if pages require JavaScript rendering or are behind login gate; the instructions already acknowledge login-gated pages and suggest fallbacks.
Install Mechanism
No install spec or code files are present (instruction-only). Nothing is written to disk or downloaded at install time, which is the lowest-risk model.
Credentials
The skill requests no environment variables, credentials, or config paths. This is proportional for a scraper of public pages. There are no unexpected secret requests.
Persistence & Privilege
always is false and there are no special persistence or system-wide config changes. The skill can be invoked autonomously by the agent (default behavior), which is expected for skills.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install douyin-tiktok-trends
  3. After installation, invoke the skill by name or use /douyin-tiktok-trends
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Fetch TikTok trending hashtags, songs, creators from TikTok Creative Center. Supports hashtag deep-dive analytics with regional popularity and audience insights.
Metadata
Slug douyin-tiktok-trends
Version 1.0.0
License MIT-0
All-time Installs 3
Active Installs 3
Total Versions 1
Frequently Asked Questions

What is Douyin & TikTok Trend Fetcher?

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/D... It is an AI Agent Skill for Claude Code / OpenClaw, with 1296 downloads so far.

How do I install Douyin & TikTok Trend Fetcher?

Run "/install douyin-tiktok-trends" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Douyin & TikTok Trend Fetcher free?

Yes, Douyin & TikTok Trend Fetcher is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Douyin & TikTok Trend Fetcher support?

Douyin & TikTok Trend Fetcher is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Douyin & TikTok Trend Fetcher?

It is built and maintained by lucasye378 (@lucasye378); the current version is v1.0.0.

💬 Comments