Documentos
Ctrl+K Pesquisar Alt+[Alt+] Guias
Obter chave da API

Integrações

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 ferramentas/chamada 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:

  • search_tiktok_products
  • search_tiktok_shops
  • search_tiktok_creators
  • search_tiktok_videos
  • pesquisar_anúncios_no_Facebook
  • descobrir produtos vencedores
  • pacote_de_inspiração_criativa
  • resumo_da_concorrência
  • 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:

  • get_tiktok_product
  • get_tiktok_shop
  • get_tiktok_creator
  • get_tiktok_video
  • get_exploding_topic_detail

3) Helpers

  • count_tiktok_entities (counts by entity)
  • browse_tiktok_categories (category tree and views)
  • list_tiktok_category_top (top items in one category)
  • autocomplete_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)
  • verificar créditos (remaining API credits)

Most common arguments

Most search tools use these:

  • palavra-chave
  • país
  • página
  • size
  • ordenar por
  • sort_order

For Meta ad tools (pesquisar_anúncios_no_Facebook, descobrir produtos vencedores), ordenar por is not arbitrary. Use one of:

  • relevância
  • data encontrada
  • visto pela última vez
  • adspend
  • de maior duração
  • alcance
  • valor do conjunto de anúncios
  • coerência
  • visitas mensais
  • pageactiveads

Common aliases are auto-normalized by MCP:

  • criado, created_at, data, recente, newest, latest -> data encontrada
  • início do último anúncio -> visto pela última vez
  • primeiro_anúncio_iniciado, oldest, earliest -> data encontrada with ascending order

Most detail tools use:

  • id
  • slice (which part you want)

Slice values for detail tools

Use one of these slice values:

  • get_tiktok_product: detalhe, history, metrics, criadores, vídeos
  • get_tiktok_shop: detalhe, history, metrics, produtos, vídeos, criadores, strategy
  • get_tiktok_creator: detalhe, history, metrics, lojas, produtos, vídeos
  • get_tiktok_video: detalhe, history, metrics, produtos, 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: