Overzicht van MCP-tools (eenvoudig)

Dit is de in begrijpelijke taal opgestelde versie van de lijst met MCP-tools.

• MCP-URL: https://app.winninghunter.com/mcp
• Volledige installatiehandleiding: MCP aansluiten
• De meeste tools zijn alleen-lezen; track_merk en track_store items toevoegen aan je trackers
• Succesvol tools/oproep kost 1 API-tegoed

Sneloverzicht#

zoek_tiktok_producten
zoek_tiktok_winkels
zoek_tiktok_makers
zoek_tiktok_video’s
teller_tiktok_entiteiten
blader_door_tiktok_categorieën
lijst_top_tiktok_categorieën
autocomplete_tiktok
haal_tiktok_product_op
haal_tiktok_winkel_op
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
lijst_shopify_winkel_filteropties
zoek_shopify_winkels
zoek_winkels
vind_vergelijkbare_winkels
vind_vergelijkbare_winkels_op_afbeelding
zoek_explosieve_onderwerpen
haal_explosief_onderwerp_detail
autocomplete_explosieve_onderwerpen
controleer_credits

Hoe moet je over de tools denken?#

1) Zoek dingen#

Gebruik deze eerst:

• zoek_tiktok_producten
• zoek_tiktok_shops
• zoek_tiktok_makers
• zoek_tiktok-video's
• zoek_op_Facebook-advertenties
• winnende producten vinden
• creatief_inspiratiepakket
• kort_overzicht_concurrenten
• scan_ad
• zoek_shopify_winkels
• winkels zoeken
• zoek_vergelijkbare_winkels
• zoek_vergelijkbare_winkels_op_afbeelding
• zoek_trending_onderwerpen

2) Details openen#

Gebruik een ID uit de zoekresultaten:

• get_tiktok_product
• get_tiktok_shop
• get_tiktok_creator
• get_tiktok_video
• get_exploding_topic_detail

3) Helpers#

• aantal_tiktok-entiteiten (aantallen per entiteit)
• door TikTok-categorieën bladeren (categoriebomen en weergaven)
• lijst_tiktok_categorie_top (populairste artikelen in één categorie)
• automatisch aanvullen_tiktok (suggesties tijdens het typen)
• autocomplete_populaire_onderwerpen (onderwerpsuggesties)
• get_tiktok_trending_products ( trending op TikTok Shop)
• dagelijkse_radar (wijzigingen in het merk bijgehouden)
• track_merk (een metapagina toevoegen aan Brand Tracker)
• analyseer_gevolgd_merk (diepgaande analyse van één merk)
• track_store (een Shopify-winkel/domein toevoegen aan Store Tracker)
• lijst_shopify_winkel_filteropties (geldige filterwaarden voor Store Explorer, inclusief dynamische thema’s/apps/taxonomie)
• Auteursvermelding (resterende API-tegoed)

Meest voorkomende argumenten#

De meeste zoekmachines maken hiervan gebruik:

• trefwoord
• land
• pagina
• grootte
• sorteren op
• sorteervolgorde

Voor Meta-advertentietools, pagina is 1-gebaseerd in MCP (1 = eerste pagina), ook al maakt de backend van het dashboard intern gebruik van indexering vanaf 0.

sorteervolgorde is asc of beschrijving (standaard beschrijving) op elk gereedschap dat dit ondersteunt.

De meeste detailtools maken gebruik van:

• id
• plak (welk deel je wilt)

Toegestaan sorteren op per stuk#

Voer een willekeurige tekenreeks uit de onderstaande tabel in. Veelgebruikte aliassen worden automatisch genormaliseerd (hoofdlettergevoelig). Voor al het andere wordt de standaardsorteervolgorde gebruikt en bevat het antwoord een mcp_sorteren blok waarin wordt beschreven wat er is toegepast.

Meta-advertentiebibliotheek#

Aliassen: gemaakt / aangemaakt op / datum / recent / nieuwste / nieuwste → gevonden op; most_recent / mostrecent / ad_started / ad_creation → mostrecent; laatste_advertentie_gestart → laatst gezien; eerste_advertentie_gestart / oudste / vroegst → gevonden op (oplopend); actieve advertenties → pageactiveads; maandelijks_aantal_bezoeken → maandelijkse bezoeken. Voor binnen hetzelfde merk ad_rank (“topadvertentie van [merk]”), gebruik topklasse of aliassen rang, ranglijst, ad_rank, top_ad, hoogst genoteerd, beste_advertentie, drankje, topad, …; zinnen met spaties zoals toppositie / topadvertentie normaliseren naar topklasse. sorteervolgorde wordt genegeerd voor topklasse (altijd in oplopende volgorde).

zoekwoord (veldbereik voor trefwoord (over Meta-tools): Alle (standaard), landingspagina, paginanaam, advertentietekst, productnaam. Dit is niet een niche-/categorieveld; alternatieve namen zoals landingspagina, paginanaam, ad_text, product worden ook genormaliseerd. Als een agent per ongeluk een niche-/categorie-term verstuurt als zoekwoord zonder trefwoord / niche (bijvoorbeeld zoekwoord: "Mode"), herstelt de MCP-tool het als de overeenkomende niche (CG) in plaats van dat de schemavalidatie mislukt.

Gebruik voor zoekopdrachten in Meta-verticalen/categorieën niche of nischen in plaats van alleen op trefwoorden te filteren. Beschouw termen die gebruikers gebruiken, zoals „categorie“, „niche“, „verticaal“, „markt“ of „productcategorie“, als een verzoek om dit Meta-nichefilter. Het MCP-invoerschema geeft de nichecodes van het dashboard weer als een opsomming, dus een zoekopdracht voor mode moet worden verzonden als niche=CG (Mode & Kleding). Handige verfijningen voor modeadvertenties zijn WC = Dameskleding, MC = Herenkleding, FW = Schoeisel / Schoenen, BG = Tassen, JY = Sieraden, WT = Horloges, en SG = Zonnebrillen. De runtime accepteert ook dashboardnamen zoals Mode & Kleding; ongeldige waarden worden geretourneerd toegestane niches in plaats van erdoorheen te worden geleid.

filter_voor_groei_in_ranglijst wordt ook getoetst aan de opties in het dashboard: door komma’s gescheiden stijgend, stabiel, afnemend.

Andere filters van het Meta-dashboard worden als MCP-argumenten beschikbaar gesteld en gecontroleerd voordat ze worden aangeroepen /api/fb-ads: landen / uitsluitingslanden, technologie / technologieën, taal / talen / talen uitsluiten, apps / apps uitsluiten, thema / thema's, schaalbaarheid, mediatype, paginatype, ad_score, weinig vertoningen, bereikfilters (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 only; dashboard 14d/2m and EU reach % growth are omitted from MCP), and date ranges (ad_created_*, laatst_gezien_*, product_created_*, page_created_*). Themanamen moeten exact overeenkomen met de waarden voor dashboardthema’s; apps accepteren dashboard-app-id’s of app-namen. Bij datumbereiken zijn beide vereist *_van en *_naar in JJJJ-MM-DD.

TikTok Shop#

Alle zoekfuncties van TikTok Shop zijn standaard ingesteld op sort_by=omzet. De toegestane waarden komen overeen met de sorteerbare kolommen van het dashboard.

Voor lijst_tiktok_categorie_top, get_tiktok_product (makers / video's plakjes), get_tiktok_shop (producten / video's / makers plakjes), get_tiktok_creator (winkels / producten / video's plakjes), en get_tiktok_video (vergelijkbaar plak), de sorteerveld arg maakt gebruik van de bovenstaande lijst met toegestane entiteiten.

Aliassen worden automatisch genormaliseerd in alle TikTok Shop-tools: aantal verkochte eenheden / eenheden / verkoop / verkocht → aantal verkochte; gmv → omzet; gmv_30d / omzet_30d → omzet_30_dagen; groei / omzetgroei / gmv_groeipercentage → omzetgroei; omzetgroei → omzetgroei; prijs / gemiddelde prijs → gemiddelde eenheidsprijs; beoordeling → winkelbeoordeling; recensies → aantal_productrecensies; aantal volgers → volgers; weergaven → weergaven_in_de_afgelopen_30_dagen; vindt leuk → likes_30_dagen; roas → geschatte_ROAS; duur → videoduur; datum / gepubliceerd → publicatiedatum.

Shopify Ontdek winkels#

track_store(store_url) voegt een winkel/domein toe aan Store Tracker. Het maakt gebruik van dezelfde validatie, abonnementslimiet, winkelresolutie en wachtrij voor het verzamelen van bestsellers als het dashboard.

Aliassen: omzet / maandelijkse_omzet / omzet_30d / 30d_omzet → 30d_rev_geschatte_max; jaaromzet / jaaromzet → omzet_1j; dagelijkse_omzet / omzet_1d → 1d_rev_geschatte_max; verkeer / bezoeken / bezoekers / maandelijks_verkeer → maandelijks_aantal_bezoeken; gemiddelde orderwaarde / gemiddelde_orderwaarde / bestelwaarde → gemiddelde orderwaarde; verkeersgroei_1m → groei_bezoekers_pct_m1; verkeersgroei_3m → groei_bezoekers_pct_m3; omzetverandering / omzetgroei / omzetontwikkeling_winkel_30d → groei_bezoekers_pct_m1 (dezelfde indeling als de live-tabel ‘Explore Shops’ toen de oude sortering op omzetverschil werd afgeschaft).

zoek_shopify_winkels / winkels zoeken filters (allemaal optioneel, tenzij anders vermeld). De namen komen overeen met de namen van de MCP-argumenten:

Gebruik lijst_shopify_winkel_filteropties voordat er op dynamische waarden wordt gefilterd (Shopify-thema's, winkel_apps, product_taxonomie_l1/l2/l3). Zijn rubriek argument accepteert alle, statisch, thema's, apps, product_taxonomie_l1, product_taxonomie_l2, product_taxonomie_l3; doorgeven zoekopdracht om dynamische keuzelijsten te doorzoeken.

Handleiding voor intenties: “Nichewinkels” → categorie of niche = een van de categorieën van Explore Shops. Voor mode/kleding/kledingstukken gebruik je Kleding. Vermijd trefwoord-alleen nichezoekopdrachten. “Top / grootste qua omzet” → sort_by=omzet_1j, sort_order=desc. “Nieuw in de afgelopen N maanden” → aangemaakt_op_basis_van / aangemaakt_tot inclusief JJJJ-MM-DD (beide verplicht).

Gelijkwaardigheid met POST-https://app.winninghunter.com/api/shops/explore: MCP maakt gebruik van dezelfde POST-sleutels aan de serverzijde (zoeken, categorie, sorteersleutel, sorteerrichting, pagina, paginagrootte, inclusief Wlads, …). Argumenttoewijzing: trefwoord→zoeken, sorteren op→sorteersleutel, grootte→paginagrootte. Standaard include_wlads=false → includeWlads=0 (komt overeen met de aanvraag voor de dashboardtabel waarbij de voorbeelden van wlads worden overgeslagen).

zoek_vergelijkbare_winkels_op_afbeelding neemt afbeelding_url (verplicht) plus de dezelfde filters als hierboven, behalve trefwoord (overeenkomst vervangt het zoeken op tekst).

Opmerking: De MCP-tools van TikTok maken ook gebruik van een land argument — daar is het dan: de context van de markt/het land, niet in dezelfde branche als Shopify-verkopers land.

Merkvolger#

track_brand(pagina-id?, url?) voegt een Facebook-/Meta-pagina toe aan Brand Tracker. Voer een pagina-id of een URL naar de Facebook-advertentiebibliotheek die het volgende bevat alle_pagina’s_bekijken; het maakt gebruik van dezelfde limiet en algemene wachtrij als het dashboard.

Aliassen: recent / toegevoegd / nieuwste / nieuwste / datum → toevoegdatum; alfabetisch / alpha / a-z → naam; nieuw / nieuwe advertenties → nieuwe advertenties; trending / momentum → groei.

Actuele onderwerpen#

Aliassen voor sorteren: volume → absoluut_volume; exponentieel → exponent; recent / nieuwste / nieuwste → toevoegdatum; trending → groei. categorie ondersteunt dashboard-slugs (bijv. mode, schoonheid, huidverzorging, fitness, technologie, ai, …) of standaard voor alle categorieën.

mcp_sorteren reactieblok#

Elke zoek- of lijstfunctie die sorteren op (of sorteren/sorteren) voegt een mcp_sorteren bezwaar maken tegen de inhoud van het antwoord:

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

Als je een onbekende sorteersleutel doorgeeft, mcp_sorting.waarschuwing zegt dat het terugviel op de standaardinstelling — het programma geeft geen foutmelding.

Waarden voor detailgereedschappen#

Gebruik een van deze plak waarden:

• get_tiktok_product: detail, geschiedenis, statistieken, makers, video's
• get_tiktok_shop: detail, geschiedenis, statistieken, producten, video's, makers, strategie
• get_tiktok_creator: detail, geschiedenis, statistieken, winkels, producten, video's
• get_tiktok_video: detail, geschiedenis, statistieken, producten, vergelijkbaar

Twee veelgemaakte fouten#

1. Trending

   • get_tiktok_trending_products is de groei van TikTok Shop-producten
   • Exploding Topics is een apart (zoek_trending_onderwerpen + get_exploding_topic_detail)

2. Acties schrijven

   • MCP ondersteunt track_merk en track_store
   • Favorieten, voorinstellingen, transcripties en andere gegevens moeten via de REST API worden verwerkt

Tekstblok voor AI-instructies#

Kopieer dit en plak het in de instructies voor de agent:

Gebruik WinningHunter MCP via https://app.winninghunter.com/mcp.
De authenticatie kan plaatsvinden via een OAuth-bearer-token (connector-flow) of een X-API-Key (clients die headers ondersteunen).
De meeste MCP-tools zijn alleen-lezen. `track_brand` en `track_store` voegen items toe aan WinningHunter-trackers.
Succesvolle tools/aanroepen kosten 1 API-tegoed.
Als de gebruiker om andere schrijfbewerkingen vraagt (favorieten/voorinstellingen/transcripten), gebruik dan in plaats daarvan REST /api/v1/tiktok-shop/*.
Als je niet zeker bent van het exacte schema, roep dan eerst tools/list aan.

Wil je alle technische details weten?#

Voor de volledige filtersemantiek en het gedrag van eindpunten:

• Filters in TikTok Shop
• Meta-advertentiebibliotheek
• Merken
• Shopify-winkelverkenner
• Trends