TopYappers - Creators & Viral Content Skills

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.

Tadas Gedgaudas@tadasgedgaudas

Install

openclaw skills install @tadasgedgaudas/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

text

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

.mcp.json / Cursor / Claude Desktop

json

{
  "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.