Referencia de herramientas MCP (básica)

Esta es la versión en lenguaje sencillo de la lista de herramientas de MCP.

• URL de MCP: https://app.winninghunter.com/mcp
• Guía de configuración completa: Conectar MCP
• Todas las herramientas son de solo lectura
• Exitoso herramientas/llamada consume 1 crédito de API

Quick list (all 30 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
list_shopify_store_filter_options
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

Cómo enfocar las herramientas#

1) Buscar cosas#

Utiliza primero estos:

• buscar_productos_en_TikTok
• buscar_en_TikTok_Shops
• buscar_creadores_de_TikTok
• buscar_vídeos_en_TikTok
• buscar_anuncios_en_Facebook
• encontrar_productos_ganadores
• paquete_de_inspiración_creativa
• resumen_de_la_competencia
• scan_ad
• buscar_tiendas_de_Shopify
• buscar_tiendas
• buscar_tiendas_similares
• buscar_tiendas_similares_por_imagen
• temas_de_tendencia

2) Ver detalles#

Utiliza un identificador de los resultados de búsqueda:

• obtener_producto_de_TikTok
• get_tiktok_shop
• obtener_creador_de_TikTok
• obtener_vídeo_de_TikTok
• obtener_detalles_del_tema_destacado

3) Ayudantes#

• número de entidades de TikTok (cifras por entidad)
• explorar_categorías_de_TikTok (árbol de categorías y vistas)
• lista_categorías_más_populares_de_TikTok (los artículos más destacados de una categoría)
• autocompletar_tiktok (sugerencias al escribir)
• temas_en_auge_con_autocompletado (sugerencias de temas)
• obtener_productos_de_tendencia_en_TikTok ( trending en TikTok Shop)
• daily_radar (cambios en la marca con seguimiento)
• analizar_marca_rastreada (análisis en profundidad de una sola marca)
• list_shopify_store_filter_options (valid Store Explorer filter values, including dynamic themes/apps/taxonomy)
• ver créditos (créditos API restantes)

Argumentos más comunes#

La mayoría de los motores de búsqueda utilizan estos:

• palabra clave
• país
• página
• tamaño
• ordenar por
• orden de clasificación

For Meta ad tools, página is 1-based in MCP (1 = first page), even though the dashboard backend uses 0-based indexing internally.

orden de clasificación is asc o desc (por defecto desc) on every tool that accepts it.

La mayoría de las herramientas de detalle utilizan:

• id
• rodaja (¿qué parte quieres?)

Permitido ordenar por per tool#

Pass any string from the table below. Common aliases are normalized automatically (case-insensitive). Anything else falls back to the default sort and the response includes a mcp_sorting block describing what was applied.

Meta ad library#

Alias: creado / fecha_de_creación / fecha / reciente / más reciente / últimas noticias → fecha de hallazgo; último_anuncio_iniciado → última conexión; primero_anuncio_iniciado / el más antiguo / más temprano → fecha de hallazgo (ascending); active_ads → anuncios activos en la página; monthly_visits → visitas mensuales. For within-brand ad_rank (“top ad from [brand]”), use toprank or aliases rank, ranking, ad_rank, top_ad, best_ranked, best_ad, adrank, topad, …; spaced phrases like top rank / top ad normalize to toprank. orden de clasificación is ignored for toprank (always ascending rank).

palabra clave de búsqueda (field scope for palabra clave on Meta tools): Todo (default), URL de destino, nombre de la página, texto del anuncio, nombre del producto. This is no a niche/category field; aliases like landing_url, page_name, ad_text, producto are normalized too. If an agent mistakenly sends a niche/category term as palabra clave de búsqueda with no palabra clave / niche (for example searchkeyword: "Fashion"), the MCP tool recovers it as the matching niche (CG) instead of failing schema validation.

For Meta vertical/category searches, use niche o nichos instead of keyword-only filtering. Treat user wording like “category”, “niche”, “vertical”, “market”, or “product category” as a request for this Meta niche filter. The MCP input schema exposes the dashboard niche codes as an enum, so a fashion query should be sent as niche=CG (Moda y ropa). Useful fashion-ad refinements are WC = Women's Clothing, MC = Ropa de hombre, FW = Calzado, BG = Bolsos, JY = Joyería, WT = Relojes, y SG = Sunglasses. The runtime also accepts dashboard names like Moda y ropa; invalid values return allowed_niches instead of being passed through.

rank_growth_filter is also validated against the dashboard options: comma-separated rising, stable, declining.

Other Meta dashboard filters are exposed as MCP args and validated before calling /api/fb-ads: países / exclude_countries, technology / technologies, language / idiomas / exclude_languages, aplicaciones / exclude_apps, theme / temas, escalado, media_type, page_type, ad_score, low_impressions, range filters (min_* / max_* for duplicates, active ads, ad spend, reach, monthly visits, products on store, price, copy length, video length, days running), and date ranges (ad_created_*, last_seen_*, product_created_*, page_created_*). Theme names must be exact dashboard Themes values; apps accept dashboard app ids or app names. Date ranges require both *_from y *_to en YYYY-MM-DD.

TikTok Shop#

All TikTok Shop search tools default to sort_by=revenue. Allowed values match the dashboard's sortable columns.

Para lista_categorías_más_populares_de_TikTok, obtener_producto_de_TikTok (creadores / vídeos slices), get_tiktok_shop (productos / vídeos / creadores slices), obtener_creador_de_TikTok (tiendas / productos / vídeos slices), and obtener_vídeo_de_TikTok (similar slice), the sort_field arg uses the matching entity's allow-list above.

Aliases auto-normalized across TikTok Shop tools: units_sold / units / sales / sold → sold_count; gmv → ingresos; gmv_30d / ingresos_30d → revenue_30_days; growth / revenue_growth / gmv_growth_rate → revenue_growth_rate; sales_growth → sales_growth_rate; price / avg_price → avg_unit_price; rating → shop_rating; opiniones → product_review_cnt; followers_count → followers; views → views_30_days; likes → likes_30_days; roas → estimated_roas; duration → video_duration; fecha / published → fecha de publicación.

Shopify Explore Shops#

Alias: ingresos / monthly_revenue / ingresos_30d / 30d_revenue → 30d_rev_estimated_max; annual_revenue / yearly_revenue → revenue_1y; daily_revenue / revenue_1d → 1d_rev_estimated_max; traffic / visits / visitors / monthly_traffic → monthly_visits; avg_order_value / average_order_value / order_value → aov; traffic_growth_1m → visits_growth_pct_m1; traffic_growth_3m → visits_growth_pct_m3; revenue_change / revenue_momentum / store_revenue_change_30d → visits_growth_pct_m1 (same mapping as the live Explore Shops table when legacy revenue-delta sort was retired).

buscar_tiendas_de_Shopify / buscar_tiendas filters (all optional unless noted). Names mirror MCP argument names:

Uso list_shopify_store_filter_options before filtering by dynamic values (shopify_themes, store_apps, product_taxonomy_l1/l2/l3). Its section argument accepts todos, static, temas, aplicaciones, product_taxonomy_l1, product_taxonomy_l2, product_taxonomy_l3; pass query to search dynamic option lists.

Intent playbook: “Stores in a niche” → categoría o niche = one of the Explore Shops verticals. For fashion/clothing/apparel, use Ropa. Avoid palabra clave-only niche queries. “Top / biggest by revenue” → sort_by=revenue_1y, sort_order=desc. “New in last N months” → store_created_from / store_created_to inclusive YYYY-MM-DD (both required).

Parity with POST https://app.winninghunter.com/api/shops/explore: MCP uses the same server-side POST keys (buscar, categoría, clave de ordenación, dirección de ordenación, página, tamaño de página, includeWlads, …). Argument mapping: palabra clave→buscar, ordenar por→clave de ordenación, tamaño→tamaño de página. Default include_wlads=false → includeWlads=0 (matches the dashboard table request that skips wlads previews).

buscar_tiendas_similares_por_imagen takes url_de_la_imagen (required) plus the same filters as above except palabra clave (similarity replaces text search).

Nota: TikTok MCP tools also use a país argument — there it is marketplace/country context, no the same field as Shopify merchant país.

Brand tracker#

Alias: reciente / added / más reciente / últimas noticias / fecha → date_added; alphabetical / alpha / a-z → nombre; new / newads → new_ads; trending / momentum → growth.

Exploding Topics#

Aliases for clasificación: volume → absolute_volume; exponential → exponent; reciente / más reciente / últimas noticias → date_added; trending → growth. categoría accepts dashboard slugs (e.g. moda, beauty, skincare, fitness, technology, ai, …) or default for all categories.

mcp_sorting response block#

Every search/list tool that accepts ordenar por (o clasificar/clasificación) attaches an mcp_sorting object to the response payload:

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

If you pass an unknown sort key, mcp_sorting.warning says it fell back to the default — the tool does not error out.

Valores de corte para herramientas de detalle#

Usa uno de estos rodaja valores:

• obtener_producto_de_TikTok: detalle, historia, indicadores, creadores, vídeos
• get_tiktok_shop: detalle, historia, indicadores, productos, vídeos, creadores, estrategia
• obtener_creador_de_TikTok: detalle, historia, indicadores, tiendas, productos, vídeos
• obtener_vídeo_de_TikTok: detalle, historia, indicadores, productos, similar

Dos errores comunes#

1. Trending

   • obtener_productos_de_tendencia_en_TikTok ¿Cuál es el impulso de los productos de TikTok Shop?
   • «Exploding Topics» es independiente (temas_de_tendencia + obtener_detalles_del_tema_destacado)

2. Acciones de escritura

   • El MCP es de solo lectura
   • Los favoritos, los ajustes preestablecidos, las transcripciones y otros contenidos escritos deben utilizar la API REST

Bloque de texto para instrucciones de IA#

Pega esto en las instrucciones para el agente:

Utiliza WinningHunter MCP en https://app.winninghunter.com/mcp.
La autenticación puede realizarse mediante un token OAuth de tipo «bearer» (flujo de conector) o una clave X-API (clientes compatibles con encabezados).
Todas las herramientas MCP son de solo lectura.
Las herramientas/llamadas que se ejecutan correctamente cuestan 1 crédito API.
Si el usuario solicita operaciones de escritura (favoritos/preajustes/transcripciones), utilice REST /api/v1/tiktok-shop/* en su lugar.
Si no está seguro del esquema exacto, llame primero a tools/list.

¿Necesitas toda la información técnica?#

Para obtener información detallada sobre la semántica de los filtros y el comportamiento de los puntos finales:

• Filtros de TikTok Shop
• Biblioteca de anuncios de Meta
• Marcas
• Explorador de tiendas de Shopify
• Tendencias