# Prompts (/mcp/tools/prompts)

As perguntas monitoradas, o desempenho de cada uma e o texto das respostas das IAs.

## list_prompts

Os prompts monitorados com o desempenho no período. Cada item traz `citationRatePct`, a porcentagem das conversas em que a marca foi citada (0 a 100). Serve pra achar os prompts mais fracos e os mais fortes.

**Pergunte assim:** "quais os 10 prompts em que eu menos apareço?", "onde eu mais caí este mês?"

- **brand_id**: UUID da marca.

- **order**: `worst_first`

(padrão, piores primeiro) ou 

`best_first`

.

- **limit**: Padrão 50, máximo 100.

- **search**: Só prompts que contêm esse texto.

- **exclude_terms**: Tira prompts que contêm qualquer um desses termos.

- **with_trend**: Traz também a taxa do período anterior (

`previousCitationRatePct`

) e a diferença (

`deltaCitationRatePct`

).

- **period**: Padrão 

`7d`

.

- **start_date / end_date**: Janela exata.

- **llm_provider**: Só uma IA.

- **segment_id**: Só um segmento.

`list_prompts` só mostra prompts que já rodaram no período. Pra ver o inventário completo, incluindo prompts recém-criados, use `list_monitored_prompts`.

## list_monitored_prompts

O inventário de prompts cadastrados, independente de desempenho. Inclui os que acabaram de ser adicionados e ainda não rodaram.

**Pergunte assim:** "quais prompts eu monitoro?", "quais prompts estão sem segmento?"

- **brand_id**: UUID da marca.

- **segment_id**: Só um segmento.

- **unsegmented_only**: Só prompts sem segmento.

- **country**: País, em duas letras (

`BR`

, 

`US`

).

- **search**: Só prompts que contêm esse texto.

- **include_inactive**: Inclui prompts desativados. Padrão 

`false`

.

- **limit**: Padrão 100, máximo 200.

## list_segments

Os segmentos da marca, com quantos prompts ativos cada um agrupa. É de onde vêm os `segment_id`.

- **brand_id**: UUID da marca.

## get_prompt_deep_dive

Tudo sobre um prompt: desempenho em cada IA, concorrentes que mais aparecem nele, fontes mais citadas, o que as IAs pesquisaram na web, presença em Shopping, mapa e posts do X, e um trecho da última resposta de cada IA.

**Pergunte assim:** "me explica o que está acontecendo no prompt sobre preço"

- **brand_id**: UUID da marca.

- **brand_prompt_id**: UUID do prompt.

- **period**: Padrão 

`7d`

.

- **start_date / end_date**: Janela exata.

## get_recent_responses

As últimas respostas completas das IAs pra um prompt, com o trecho onde a marca foi citada, como os concorrentes aparecem na mesma resposta, as fontes e as pesquisas feitas. É a tool pra análise qualitativa: tom, argumentos, como a marca é descrita.

**Pergunte assim:** "como o ChatGPT fala de mim nesse prompt?", "como o concorrente X é apresentado?"

- **brand_id**: UUID da marca.

- **brand_prompt_id**: UUID do prompt.

- **limit_per_provider**: Respostas por IA. Padrão 3, máximo 5.

- **llm_provider**: Só uma IA.

- **only_mentioning_brand**: Só respostas que citam a marca.

- **only_mentioning_competitor_id**: Só respostas que citam esse concorrente.

## suggest_prompts

Reúne o contexto pra IA sugerir prompts novos: dados da marca, uma amostra dos prompts já monitorados, os prompts em que você perde (com o concorrente e a fonte que dominam), países e segmentos. A sugestão em si é escrita pela IA que você está usando.

**Pergunte assim:** "sugira 5 prompts novos que eu deveria monitorar"

- **brand_id**: UUID da marca.