TopYappers - Creators & Viral Content Skills

Other

TopYappers — social media intelligence for AI agents. Discover viral TikTok content, search 30M+ creators across TikTok/Instagram/YouTube, and track trending song charts. Use when the user asks about influencers, creators, viral content, trending songs, or social media data.

Install

openclaw skills install topyappers

TopYappers MCP

Social media intelligence for AI agents. Access viral content discovery, influencer search across TikTok, Instagram & YouTube, and trending song charts — all through a single MCP connection.

Setup

MCP Endpoint: https://mcp.topyappers.com Transport: HTTP Auth: Bearer token in the Authorization header

Get an API key at topyappers.com/profile.

Claude Code

claude mcp add --transport http topyappers https://mcp.topyappers.com \
  --header "Authorization: Bearer YOUR_API_KEY"

.mcp.json / Cursor / Claude Desktop

{
  "mcpServers": {
    "topyappers": {
      "type": "http",
      "url": "https://mcp.topyappers.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Available Skills

This package includes 4 specialized skills for each API domain:

find-creators — Search 30M+ creators with 20+ filters (category, niche, followers, engagement, country, platform). Free search + paid profiles.
find-viral-content — Discover viral TikTok posts by category, country, virality score, date range, music, and hooks.
search-videos — Find videos by engagement metrics, hashtags, text search, and sort by views/likes/shares.
trending-songs — Chart rankings, new entries, song search, history tracking, and week-over-week comparisons across 44 countries.

11 MCP Tools

Tool	Description	Cost
`search_creators`	Search influencers with 20+ filters	Free
`get_creator_profiles`	Full profiles — followers, engagement, email, bio, niches	1 credit/creator
`search_viral_content`	Viral TikTok posts by category, country, virality score	1 credit/result
`search_videos`	Videos by engagement, hashtags, text	1 credit/video
`get_song_rankings`	Country or global chart rankings	10 credits
`get_new_song_entries`	Newly charting songs	10 credits
`search_songs`	Search by title/artist	10 credits
`get_song_history`	Song chart performance over time	10 credits
`compare_song_rankings`	Compare charts between two weeks	10 credits
`get_song_countries`	Available countries for song data	10 credits
`get_song_weeks`	Available weeks for a country	10 credits

Quick Reference

Country format matters

Creators & viral content → full names: "United States", "France"
Song tools → country codes: "US", "FR", "GB"

nichesToPromote is the primary creator discovery tool

The most powerful filter. It uses AI-analyzed niche data that is very granular — specific products (calorie counter, standing desk), use cases (meal prep, budget travel), audiences (new moms, small business owners), and tools (ChatGPT, Notion). Be specific and creative.

Run 5+ niche searches per query

nichesToPromote, promotedProducts, and hashtags use AND logic when comma-separated — never pass multiple values. Instead, run at least 5 searches with different keywords from different angles, then merge and deduplicate. Since search is free, there's no cost.

Credit-efficient creator workflow

search_creators (free) with nichesToPromote → run 5+ searches with different keywords
Deduplicate all userIds across searches
get_creator_profiles (1 credit each) → only for the ones you need

Virality score

Views ÷ followers, normalized 0–1. Use 0.3+ for quality, 0.5+ for highly viral, 0.7+ for breakout content.

Song week format

ISO format: YYYY-Www (e.g. "2026-W04"). Use get_song_weeks to discover available weeks.

Rate Limits

60 requests per minute per API key. HTTP 429 responses include retryAfter in seconds.