Docs
Ctrl+K Rechercher Alt+[Alt+] Guides
Obtenir une clé API

Intégrations

MCP tools reference (simple)

This is the plain-English version of the MCP tools list.

  • MCP URL: https://app.winninghunter.com/mcp
  • Full setup guide: Connect MCP
  • All tools are read-only
  • Successful outils/appel uses 1 API credit

Quick list (all 29 tools)

search_tiktok_products
search_tiktok_shops
search_tiktok_creators
search_tiktok_videos
count_tiktok_entities
browse_tiktok_categories
list_tiktok_category_top
autocomplete_tiktok
get_tiktok_product
get_tiktok_shop
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
analyze_tracked_brand
list_tracked_brands
search_shopify_stores
search_shops
find_similar_shops
find_similar_stores_by_image
search_exploding_topics
get_exploding_topic_detail
autocomplete_exploding_topics
check_credits

How to think about the tools

1) Find things

Use these first:

  • rechercher_des_produits_sur_TikTok
  • rechercher_sur_TikTok_Shops
  • rechercher_des_créateurs_sur_TikTok
  • rechercher_des_vidéos_sur_TikTok
  • search_facebook_ads
  • find_winning_products
  • creative_inspiration_pack
  • brief_competitor
  • scan_ad
  • search_shopify_stores
  • search_shops
  • find_similar_shops
  • find_similar_stores_by_image
  • search_exploding_topics

2) Open details

Use an ID from search results:

  • récupérer_produit_tiktok
  • get_tiktok_shop
  • get_tiktok_creator
  • récupérer_vidéo_TikTok
  • get_exploding_topic_detail

3) Helpers

  • nombre_d'entités_TikTok (counts by entity)
  • Parcourir les catégories TikTok (category tree and views)
  • liste_catégorie_top_TikTok (top items in one category)
  • suggestion automatique_TikTok (typeahead suggestions)
  • autocomplete_exploding_topics (topic suggestions)
  • get_tiktok_trending_products (TikTok Shop trending)
  • daily_radar (tracked-brand changes)
  • analyze_tracked_brand (single-brand deep dive)
  • générique (remaining API credits)

Most common arguments

Most search tools use these:

  • mot-clé
  • pays
  • page
  • taille
  • sort_by
  • sort_order

For Meta ad tools (search_facebook_ads, find_winning_products), sort_by is not arbitrary. Use one of:

  • relevance
  • datefound
  • lastseen
  • adspend
  • longestrunning
  • reach
  • adsetamount
  • consistency
  • monthlyvisits
  • pageactiveads

Common aliases are auto-normalized by MCP:

  • created, created_at, date, recent, newest, latest -> datefound
  • last_ad_started -> lastseen
  • first_ad_started, oldest, earliest -> datefound with ascending order

Most detail tools use:

  • id
  • slice (which part you want)

Slice values for detail tools

Use one of these slice values:

  • récupérer_produit_tiktok: detail, history, metrics, créateurs, vidéos
  • get_tiktok_shop: detail, history, metrics, produits, vidéos, créateurs, strategy
  • get_tiktok_creator: detail, history, metrics, magasins, produits, vidéos
  • récupérer_vidéo_TikTok: detail, history, metrics, produits, similar

Two easy mistakes

  1. Trending confusion

    • get_tiktok_trending_products is TikTok Shop product momentum
    • Exploding Topics is separate (search_exploding_topics + get_exploding_topic_detail)

  2. Write actions

    • MCP is read-only
    • Favorites, presets, transcripts, and other writes must use REST API

Copy block for AI instructions

Paste this into agent instructions:

Use WinningHunter MCP at https://app.winninghunter.com/mcp.
Auth can be either OAuth bearer token (connector flow) or X-API-Key (header-capable clients).
All MCP tools are read-only.
Successful tools/call costs 1 API credit.
If user asks for writes (favorites/presets/transcripts), use REST /api/v1/tiktok-shop/* instead.
When unsure about exact schema, call tools/list first.

Need the full technical detail?

For full filter semantics and endpoint behavior: