Communitygithub.com

benjaminb10/viewlify-mcp

TikTok-Daten für Claude und KI-Agenten: MCP-Server (Videos, die die üblichen Aufrufe ihres Erstellers übertreffen, Trends, Hashtags, Sounds), Claude-Code-Plugin mit 3 Fähigkeiten und die viewlify-CLI.

Was ist viewlify-mcp?

Viewlify MCP ist ein MCP-Server (Model Context Protocol), der KI-Agenten wie Claude, Claude Code, Cursor und anderen MCP-Clients Zugriff auf öffentliche TikTok-Daten bietet. Der Server identifiziert Videos, die echt in einer Nische durchstarten, indem er jedes Video mit den üblichen Aufrufen seines Erstellers vergleicht – dies wird als „Multiplikator“ bezeichnet. Der Dienst wird von Viewlify gehostet; es muss nichts lokal ausgeführt werden. Es gibt ein optionales API-Konto mit einem kostenlosen Vorschaumodus (5 Ergebnisse pro Aufruf, 20 Aufrufe pro Tag und IP) und kostenpflichtigen Stufen für vollständige Ergebnisse, die Suche über die gesamte Videobasis und historische Daten. Das Repository enthält auch ein Claude-Code-Plugin mit drei vorgefertigten Fähigkeiten (Erforschung von Ausreißern, Videoideen, Trendbeobachtung) und die Open-Source-CLI `viewlify`.

Funktioniert mit✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/benjaminb10/viewlify-mcp/tree/main

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Viewlify MCP: TikTok-Daten für Claude und KI-Agenten

Fragen Sie Claude, welche TikTok-Videos in einer Nische wirklich durchstarten und warum. Viewlify verfolgt öffentliche TikTok-Videos und vergleicht jedes mit den üblichen Aufrufen seines Erstellers: Ein Video mit 50.000 Aufrufen ist ein Flop für einen Account, der normalerweise 500.000 Aufrufe erhält, und ein Durchbruch für einen, der normalerweise 2.000 bekommt. Dieses Verhältnis, der Multiplikator, wird von diesem Server zurückgegeben, zusammen mit den Videos, Hashtags und Sounds, die in einer Nische am schnellsten Aufrufe gewinnen.

Dieses Repository enthält alles, was Sie benötigen, um Viewlify mit Claude Code, Claude, Cursor oder einem anderen MCP-Client zu nutzen:

  • die Konfiguration des Remote-MCP-Servers (https://viewlify.app/api/mcp),
  • ein Claude-Code-Plugin mit drei darauf aufbauenden Fähigkeiten,
  • den Quellcode des viewlify-Befehlszeilentools, das auf npm veröffentlicht ist.

Der Server selbst wird von Viewlify gehostet; es muss nichts lokal ausgeführt werden.

Schnellstart

Claude Code, als Plugin (MCP-Server und die drei Fähigkeiten):

/plugin marketplace add benjaminb10/viewlify-mcp
/plugin install viewlify@viewlify

Bei der Installation fragt Claude Code nach Ihrem Viewlify-API-Schlüssel. Dieser ist optional (siehe unten): Lassen Sie ihn für die kostenlose Vorschau leer.

Claude Code, nur der MCP-Server:

claude mcp add --transport http viewlify https://viewlify.app/api/mcp --header "Authorization: Bearer vf_live_YOUR_KEY"

Claude (claude.ai oder Desktop): Einstellungen > Connectors > Benutzerdefinierten Connector hinzufügen, URL https://viewlify.app/api/mcp.

Cursor und andere Clients: Ein Streamable-HTTP-Server unter https://viewlify.app/api/mcp, mit dem Header Authorization: Bearer vf_live_YOUR_KEY.

Terminal: npx viewlify login, dann npx viewlify search "Hautpflege" --sort outlier --limit 5. npx viewlify mcp gibt den claude mcp add-Befehl mit Ihrem Schlüssel aus.

API-Schlüssel und Preis

Der Schlüssel ist optional. Ohne ihn antworten die öffentlichen Tools mit einer 5-Ergebnisse-Vorschau (20 Aufrufe pro Tag und IP).

Mit einem Schlüssel erhalten Sie vollständige Ergebnisse, den Ausreißer-Multiplikator, Shares pro 1.000 Aufrufe, den von Viewlify aufgezeichneten Ansichtsverlauf und die Suche über alle Videos in der Datenbank. Jeder Viewlify-Account kann einen Schlüssel in Einstellungen > API & MCP erstellen, kostenloser Tarif inklusive, mit 1 $ kostenlosem Guthaben. Danach kostet es 0,005 $ pro Aufruf von einem Prepaid-Guthaben (Aufladungen von 5 bis 100 USD) oder ist in den Pro- und Agentur-Tarifen enthalten. Preise: viewlify.app/tiktok-data-api.

Tools

ToolSchlüsselRückgabe
get_trendingoptionalVideos, Hashtags und Sounds, die gerade jetzt in einer Nische durchstarten
get_outliersoptionalVideos, die die üblichen Aufrufe ihres Erstellers am stärksten übertreffen, nach Nische oder Suche
get_trending_hashtagsoptionalHashtags, die bei Durchbrüchen wiederkehrend auftauchen, nach Nische
get_creatoroptionalEin Ersteller: Follower, übliche Aufrufe, Engagement, bester Durchbruch, bester Veröffentlichungstag, Top-Hashtags und -Sounds und deren Videos mit dem Multiplikator
search_trending_videoserforderlichDurchsuchen der gesamten Datenbank nach Stichwort, @Ersteller oder #Hashtag; sortieren nach Trend, Ausreißer, Aufrufe, aktuell, Engagement oder Shares
get_balance, top_uperforderlichAPI-Guthaben und ein Zahlungslink zum Aufladen
list_my_accounts, get_account_growth, get_account_videos, get_my_niche_watch, get_my_video_checksPro oder AgenturIhre eigenen verfolgten Accounts, deren Wachstum und Videos, Ihre Nischenbeobachtung und KI-Videoprüfungen

Nischen: beauty, gaming, food, fitness, fashion, comedy, dance, pets, football, sports, music, travel, tech, cars, money, learning, home, art, motivation, anime. Nur lesend: Der Server veröffentlicht oder ändert niemals etwas.

Fähigkeiten (Skills)

FähigkeitVerwendung
tiktok-outlier-researchFinden, was in einer Nische wirklich durchstartet und die Muster dahinter
tiktok-video-ideas5 Videoideen mit Hooks erhalten, die jeweils auf einem echten Durchbruch basieren
tiktok-trend-watchEin einseitiger wöchentlicher Überblick über aufkommende Formate, Hashtags und Sounds

Fähigkeiten funktionieren auch auf claude.ai: Laden Sie einen Fähigkeiten-Ordner herunter und fügen Sie ihn unter Einstellungen > Fähigkeiten > Skills hinzu.

Beispielaufforderungen

  • "Was startet diesen Monat im Bereich Fitness auf TikTok durch und was haben diese Videos gemeinsam?"
  • "Gib mir 5 Videoideen für einen Koch-Account, der zu Hause filmt, basierend auf dem, was gerade funktioniert."
  • "Wöchentlicher Trendbericht für Beauty und Fashion."
  • "Suche auf TikTok nach Videos über Proteinriegel, sortiert nach Ausreißer, letzte 30 Tage."

Daten

Nur öffentliche TikTok-Daten: Videos, Bildunterschriften, Hashtags, Sounds und öffentliche Zähler, täglich aktualisiert. Viewlify ist nicht mit TikTok verbunden.

Repository-Aufbau

.claude-plugin/   Plugin- und Marktplatz-Manifeste für Claude Code
.mcp.json         der MCP-Server, mit dem das Plugin verbunden wird (API-Schlüssel bei Installation abgefragt, optional)
server.json       Eintrag für das offizielle MCP-Register
skills/           die drei Fähigkeiten

Lizenz

MIT. Issues und Pull-Requests sind willkommen. Erstellt von Viewlify.

Verwandte Skills