MCP-Werkzeugübersicht (vereinfacht)

Dies ist die leicht verständliche Version der MCP-Tool-Liste.

• MCP-URL: https://app.winninghunter.com/mcp
• Vollständige Einrichtungsanleitung: MCP verbinden
• Die meisten Tools sind schreibgeschützt; Marke und track_store Elemente zu deinen Trackern hinzufügen
• Erfolgreich Tools/Anruf verbraucht 1 API-Guthabenpunkt

Schnellübersicht#

TikTok-Produkte suchen
TikTok-Shops suchen
TikTok-Creators suchen
TikTok-Videos suchen
TikTok-Objekte zählen
TikTok-Kategorien durchsuchen
Top-Kategorien auf TikTok auflisten
TikTok-Autovervollständigung
TikTok-Produkt abrufen
TikTok-Shop abrufen
get_tiktok_creator
get_tiktok_video
get_tiktok_trending_products
search_facebook_ads
find_winning_products
creative_inspiration_pack
brief_competitor
scan_ad
daily_radar
track_brand
analyze_tracked_brand
list_tracked_brands
track_store
Shopify-Shop-Filteroptionen auflisten
Shopify-Shops suchen
Shops suchen
Ähnliche Shops finden
Ähnliche Shops anhand eines Bildes finden
Trendthemen suchen
Trendthema-Details abrufen
Trendthemen automatisch vervollständigen
Guthaben prüfen

Wie man über die Werkzeuge nachdenkt#

1) Dinge finden#

Verwende zuerst diese:

• TikTok-Produkte suchen
• TikTok-Shops suchen
• TikTok-Creators suchen
• TikTok-Videos suchen
• Facebook-Anzeigen suchen
• Gewinnerprodukte finden
• Kreativ-Inspirationspaket
• kurze_Wettbewerber
• scan_ad
• Shopify-Shops suchen
• Geschäfte suchen
• Ähnliche Geschäfte finden
• Ähnliche Geschäfte anhand eines Bildes finden
• Suche nach aktuellen Themen

2) Details anzeigen#

Verwende eine ID aus den Suchergebnissen:

• get_tiktok_product
• get_tiktok_shop
• get_tiktok_creator
• get_tiktok_video
• get_exploding_topic_detail

3) Helfer#

• Anzahl der TikTok-Entitäten (Zahlen nach Unternehmen)
• TikTok-Kategorien durchsuchen (Kategoriebäume und Ansichten)
• Liste der beliebtesten TikTok-Kategorien (Top-Artikel in einer Kategorie)
• autocomplete_tiktok (Vorschläge bei der Eingabe)
• autocomplete_explodierende_Themen (Themenvorschläge)
• get_tiktok_trending_products ( trending TikTok Shop)
• daily_radar (Änderungen an der Markierung)
• Marke (Eine Meta-Seite zum Brand Tracker hinzufügen)
• analyze_tracked_brand (Einzelmarken-Tiefgang)
• track_store (Einen Shopify-Shop/eine Domain zum Store Tracker hinzufügen)
• list_shopify_store_filter_options (gültige Filterwerte für den Store Explorer, einschließlich dynamischer Themen/Apps/Taxonomie)
• Abspann (verbleibende API-Guthaben)

Die häufigsten Argumente#

Die meisten Suchmaschinen verwenden diese:

• Stichwort
• Land
• Seite
• Größe
• sort_by
• Sortierreihenfolge

Für Meta-Werbetools, Seite ist in MCP 1-basiert (1 = erste Seite), obwohl das Dashboard-Backend intern eine 0-basierte Indizierung verwendet.

Sortierreihenfolge ist asc oder Beschreibung (Standard Beschreibung) bei jedem Werkzeug, das dies unterstützt.

Die meisten Detailwerkzeuge verwenden:

• id
• Scheibe (welchen Teil du möchtest)

Zulässig sort_by pro Werkzeug#

Geben Sie eine beliebige Zeichenfolge aus der folgenden Tabelle ein. Gängige Aliase werden automatisch normalisiert (Groß-/Kleinschreibung wird nicht berücksichtigt). In allen anderen Fällen wird die Standardsortierung verwendet, und die Antwort enthält einen mcp_sorting Abschnitt, in dem beschrieben wird, was angewendet wurde.

Meta-Anzeigenbibliothek#

Aliasnamen: erstellt / Erstellt am / Datum / vor kurzem / neueste / aktuell → Datum gefunden; most_recent / mostrecent / ad_started / ad_creation → mostrecent; Anfang der letzten Anzeige → zuletzt gesehen; erste_Anzeige_gestartet / älteste / frühest → Datum gefunden (aufsteigend); aktive Anzeigen → pageactiveads; monatliche Besuche → monatliche Besuche. Für markeninterne Anzeigenrang („Top-Anzeige von [Marke]“), verwende Spitzenplatz oder Aliase Rang, Rangliste, Anzeigenrang, top_ad, am besten bewertet, best_ad, adrank, topad, …; Phrasen mit Leerzeichen wie Spitzenplatz / Anzeige oben auf ... normieren Spitzenplatz. Sortierreihenfolge wird ignoriert für Spitzenplatz (immer in aufsteigender Reihenfolge).

Suchbegriff (Gültigkeitsbereich für Stichwort (zu Meta-Tools): Alle (Standard), Ziel-URL, Seitenname, Anzeigentext, Produktname. Das ist nicht ein Nischen-/Kategorienfeld; Aliase wie Ziel-URL, Seitenname, ad_text, Produkt werden ebenfalls normalisiert. Wenn ein Agent versehentlich einen Nischen-/Kategoriebegriff als Suchbegriff ohne Stichwort / Nische (zum Beispiel Suchbegriff: „Mode“), stellt das MCP-Tool es als das passende Nische (CG) anstatt die Schemavalidierung nicht zu bestehen.

Für die vertikale Suche bzw. die Suche nach Kategorien bei Meta verwenden Sie Nische oder Nischen anstelle einer reinen Stichwortfilterung. Behandeln Sie Benutzerbegriffe wie „Kategorie“, „Nische“, „Branche“, „Markt“ oder „Produktkategorie“ als Anfrage für diesen Meta-Nischenfilter. Das MCP-Eingabeschema stellt die Nischencodes des Dashboards als Aufzählung bereit, sodass eine Mode-Abfrage wie folgt gesendet werden sollte: Nische=CG (Mode & Bekleidung). Nützliche Verfeinerungen bei Modeanzeigen sind WC = Damenbekleidung, MC = Herrenbekleidung, FW = Schuhe, BG = Taschen, JY = Schmuck, WT = Uhrenund SG = Sonnenbrillen. Die Laufzeitumgebung akzeptiert auch Dashboard-Namen wie Mode & Bekleidung; ungültige Werte führen zu zulässige Nischen anstatt weitergeleitet zu werden.

Rangwachstumsfilter wird zudem anhand der Dashboard-Optionen überprüft: durch Kommas getrennt steigend, stabil, abnehmend.

Andere Filter des Meta-Dashboards werden als MCP-Argumente bereitgestellt und vor dem Aufruf validiert /api/fb-ads: Länder / Länder ausschließen, Technologie / Technologien, Sprache / Sprachen / Sprachen ausschließen, Apps / exclude_apps, Thema / Themen, Skalierung, Medientyp, Seitentyp, Bewertung, geringe Impressionen, Bereichsfilter (min_* / max_* for duplicates, active ads, FB page likes, ad spend, reach, monthly visits, products on store, price, copy length, video length, days running), active-ads % growth (min_active_ads_growth / max_active_ads_growth + active_ads_growth_period — human percent, periods 1w | 1m | 3m nur; dashboard 14d/2m and EU reach % growth are omitted from MCP), and date ranges (ad_created_*, zuletzt_gesehen_*, product_created_*, page_created_*). Themennamen müssen genau den Werten der Dashboard-Themen entsprechen; Apps akzeptieren Dashboard-App-IDs oder App-Namen. Für Datumsbereiche sind beide Angaben erforderlich *_von und *_zu in JJJJ-MM-TT.

TikTok Shop#

Alle Suchfunktionen im TikTok Shop sind standardmäßig auf sort_by=Umsatz. Die zulässigen Werte entsprechen den sortierbaren Spalten des Dashboards.

Für Liste der beliebtesten TikTok-Kategorien, get_tiktok_product (Urheber / Videos Scheiben), get_tiktok_shop (Produkte / Videos / Urheber Scheiben), get_tiktok_creator (Geschäfte / Produkte / Videos Scheiben) und get_tiktok_video (ähnlich Scheibe), die Sortierfeld arg verwendet die oben angegebene Zulassungsliste der entsprechenden Entität.

Aliase werden in allen TikTok Shop-Tools automatisch normalisiert: verkaufte Einheiten / Einheiten / Umsatz / verkauft → Anzahl der verkauften Artikel; gmv → Umsatz; gmv_30d / Umsatz_30d → Umsatz_30_Tage; Wachstum / Umsatzwachstum / gmv_Wachstumsrate → Umsatzwachstumsrate; Umsatzwachstum → Umsatzwachstumsrate; Preis / Durchschnittspreis → Durchschnittspreis; Bewertung → Shop-Bewertung; Bewertungen → Anzahl der Produktbewertungen; Anzahl der Follower → Follower; Aufrufe → Aufrufe_in_den_letzten_30_Tagen; Likes → Likes in den letzten 30 Tagen; roas → geschätzter_ROAS; Dauer → Videolänge; Datum / veröffentlicht → Veröffentlichungsdatum.

Shopify – Shops entdecken#

track_store(store_url) Fügt dem Store Tracker einen Shop/eine Domain hinzu. Es verwendet dieselben Validierungsregeln, Plan-Limits, Shop-Auflösung und Bestseller-Scrape-Warteschlange wie das Dashboard.

Aliasnamen: Umsatz / Monatsumsatz / Umsatz_30d / 30d_Umsatz → 30d_rev_geschätzter_Maximalwert; Jahresumsatz / Jahresumsatz → Umsatz_1J; Tagesumsatz / Umsatz_1d → 1d_rev_geschätzter_Maximalwert; Verkehr / Besuche / Besucher / monatliche Besucherzahlen → monatliche Besuche; Durchschnittlicher Bestellwert / durchschnittlicher Bestellwert / Bestellwert → Durchschnittlicher Warenkorbwert; Verkehrswachstum_1M → Besucherwachstum_in_Prozent_M1; Verkehrswachstum_3M → Besucherwachstum_in_Prozent_M3; Umsatzveränderung / Umsatzdynamik / Umsatzentwicklung des Geschäfts in den letzten 30 Tagen → Besucherwachstum_in_Prozent_M1 (gleiche Zuordnung wie in der Live-Tabelle „Explore Shops“, als die alte Sortierung nach Umsatzdifferenz abgeschafft wurde).

Shopify-Shops suchen / Geschäfte suchen Filter (alle optional, sofern nicht anders angegeben). Die Namen entsprechen den Namen der MCP-Argumente:

Verwendung list_shopify_store_filter_options bevor nach dynamischen Werten gefiltert wird (Shopify-Themes, Store-Apps, Produkt-Taxonomie_Ebene_1/2/3). Seine Abschnitt Das Argument akzeptiert alle, statisch, Themen, Apps, Produkt-Taxonomie_Ebene_1, Produkt-Taxonomie_L2, Produkt-Taxonomie_L3; weiter Abfrage um dynamische Optionslisten zu durchsuchen.

Leitfaden für das Intent-Modell: „Nischenläden“ → Kategorie oder Nische = einer der Bereiche von Explore Shops. Für Mode/Kleidung/Bekleidung verwende Kleidung. Vermeiden Sie Stichwort-nur Nischenanfragen. „Top / umsatzstärkste“ → sort_by=Umsatz_1j, sort_order=desc. „Neu in den letzten N Monaten“ → aus_dem_Shop_erstellt / store_created_to einschließlich JJJJ-MM-TT (beides erforderlich).

Gleichheit mit POST-https://app.winninghunter.com/api/shops/explore: MCP verwendet dieselben serverseitigen POST-Schlüssel (Suche, Kategorie, Sortierschlüssel, Sortierrichtung, Seite, Seitengröße, includeWlads, …). Argumentzuordnung: Stichwort→Suche, sort_by→Sortierschlüssel, Größe→Seitengröße. Standard include_wlads=false → includeWlads=0 (entspricht der Abfrage der Dashboard-Tabelle, bei der die Vorschau von WLADs übersprungen wird).

Ähnliche Geschäfte anhand eines Bildes finden dauert Bild-URL (erforderlich) sowie die dieselben Filter wie oben, mit Ausnahme von Stichwort (Die Ähnlichkeitssuche ersetzt die Textsuche).

Hinweis: Die TikTok-MCP-Tools nutzen ebenfalls ein Land Argument – da ist es: Marktplatz/Länderkontext, nicht derselbe Bereich wie bei Shopify-Händlern Land.

Marken-Tracker#

track_brand(page_id?, url?) fügt dem Brand Tracker eine Facebook-/Meta-Seite hinzu. Geben Sie entweder eine Seiten-ID oder eine URL der Facebook-Anzeigenbibliothek, die Folgendes enthält alle_Seiten-ID; es nutzt dieselbe Plan-Obergrenze und dieselbe globale Tracking-Warteschlange wie das Dashboard.

Aliasnamen: vor kurzem / hinzugefügt / neueste / aktuell / Datum → Datum der Aufnahme; alphabetisch / alpha / A–Z → Name; neu / neue Anzeigen → neue Anzeigen; trending / Schwung → Wachstum.

Heiße Themen#

Aliase für Sortieren: Umfang → absolutes Volumen; exponentiell → Exponent; vor kurzem / neueste / aktuell → Datum der Aufnahme; trending → Wachstum. Kategorie akzeptiert Dashboard-Slugs (z. B. Mode, Schönheit, Hautpflege, Fitness, Technologie, ai, …) oder Standard für alle Kategorien.

mcp_sorting Antwortblock#

Jedes Such- oder Listentool, das sort_by (oder sortieren/Sortieren) fügt eine mcp_sorting Objekt in der Antwort-Nutzlast:

{
  "mcp_sorting": {
    "requested_sort_by": "revenue_30d",
    "applied_sort_by": "revenue_30_days",
    "applied_sort_order": "desc",
    "allowed_sort_by": ["revenue", "name", "revenue_30_days", "..."],
    "normalized_from": "revenue_30d"
  }
}

Wenn Sie einen unbekannten Sortierschlüssel übergeben, mcp_sorting.warning es heißt, es sei auf die Standardeinstellung zurückgefallen – das Tool gibt keinen Fehler aus.

Schnittwerte für Detailwerkzeuge#

Verwende eine dieser Optionen Scheibe Werte:

• get_tiktok_product: Detail, Geschichte, Kennzahlen, Urheber, Videos
• get_tiktok_shop: Detail, Geschichte, Kennzahlen, Produkte, Videos, Urheber, Strategie
• get_tiktok_creator: Detail, Geschichte, Kennzahlen, Geschäfte, Produkte, Videos
• get_tiktok_video: Detail, Geschichte, Kennzahlen, Produkte, ähnlich

Zwei häufige Fehler#

1. Trending

   • get_tiktok_trending_products ist die Produktdynamik von TikTok Shop
   • „Exploding Topics“ ist ein eigenständiges Projekt (Suche nach aktuellen Themen + get_exploding_topic_detail)

2. Schreibvorgänge

   • MCP unterstützt Marke und track_store
   • Lesezeichen, Voreinstellungen, Transkripte und andere Einträge müssen über die REST-API abgerufen werden

Block für KI-Anweisungen kopieren#

Fügen Sie dies in die Anweisungen für den Makler ein:

Verwenden Sie WinningHunter MCP unter https://app.winninghunter.com/mcp.
Die Authentifizierung kann entweder über ein OAuth-Bearer-Token (Connector-Flow) oder einen X-API-Key (für Header-fähige Clients) erfolgen.
Die meisten MCP-Tools sind schreibgeschützt. `track_brand` und `track_store` fügen Elemente zu den WinningHunter-Trackern hinzu.
Erfolgreiche Tools/Aufrufe kosten 1 API-Credit.
Wenn der Benutzer andere Schreibvorgänge anfordert (Favoriten/Voreinstellungen/Transkripte), verwenden Sie stattdessen REST /api/v1/tiktok-shop/*.
Wenn Sie sich über das genaue Schema unsicher sind, rufen Sie zunächst tools/list auf.

Benötigen Sie die vollständigen technischen Details?#

Die vollständige Filter-Semantik und das Verhalten der Endpunkte finden Sie hier:

• TikTok Shop-Filter
• Meta-Anzeigenbibliothek
• Marken
• Shopify-Shop-Explorer
• Trends