# Fontes (/mcp/tools/fontes)

Os sites e páginas que as IAs leem e citam, o que elas pesquisam e onde a marca aparece em Shopping e no mapa.

## Abrir não é citar

As tools de fontes contam um funil de três etapas:

- **totalConversations**: Conversas monitoradas no período. É a base.

- **conversationsAppeared**: Em quantas dessas a IA **abriu** a fonte pra montar a resposta.

- **conversationsCited**: Em quantas ela **citou** a fonte, mostrando o link.

A diferença entre abrir e citar é leitura sem crédito: a página foi achada, mas não convenceu como resposta. Fontes abertas e nunca citadas (a "consulta silenciosa") ficam de fora por padrão; `include_silent=true` inclui.

A posição da fonte na resposta vem como `bestPosition`: 1 é fonte principal, 2 secundária, 3 menção.

## get_top_sources

As fontes citadas nos prompts da marca, em dois níveis na mesma resposta:

* `urls`: as páginas específicas, até 30. É o nível que vira ação.
* `domains`: todos os domínios do período, até 25, com `citations`, `distinctUrls` e os totais do funil.

Quando `urlsTruncated` é `true`, existem mais páginas do que as listadas. Pra saber se um site é usado, olhe `domains` ou chame de novo com `domain`.

**Pergunte assim:** "quais sites as IAs mais usam pra responder sobre o meu mercado?"

- **brand_id**: UUID da marca.

- **domain**: Só páginas desse domínio, ex.: 

`g2.com`

.

- **brand_prompt_id**: Só um prompt.

- **include_silent**: Inclui fontes abertas e nunca citadas. Padrão 

`false`

.

- **limit**: Padrão 10, máximo 30.

- **period**: Padrão 

`7d`

.

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

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

## get_top_urls

Ranking das páginas mais citadas, com a melhor posição em que cada uma apareceu.

**Pergunte assim:** "qual página do g2.com mais aparece?"

- **brand_id**: UUID da marca.

- **domain**: Só páginas desse domínio.

- **brand_prompt_id**: Só um prompt.

- **include_silent**: Inclui consulta silenciosa. Padrão 

`false`

.

- **limit**: Padrão 15, máximo 30.

- **period**: Padrão 

`7d`

.

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

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

## find_prompts_citing_url

O caminho inverso: dada uma página ou um domínio, em quais prompts ela foi aberta e citada. Serve pra saber onde o seu site (ou o de um concorrente) está influenciando as respostas.

**Pergunte assim:** "em quais prompts o g2.com aparece?", "onde a minha página /precos é citada?"

- **brand_id**: UUID da marca.

- **url**: Uma página. Protocolo, 

`www`

, barra final e parâmetros de rastreio não atrapalham a comparação.

- **domain**: Qualquer página desse domínio. Envie 

`url`

ou 

`domain`

, não os dois.

- **include_silent**: Inclui consulta silenciosa. Padrão 

`false`

.

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

- **period**: Padrão 

`30d`

.

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

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

## get_search_queries

As pesquisas na web que as IAs fizeram enquanto respondiam os prompts da marca. Mostra a intenção real por trás das respostas e ajuda a achar temas sem conteúdo.

**Pergunte assim:** "o que as IAs pesquisam quando respondem sobre o meu mercado?"

- **brand_id**: UUID da marca.

- **brand_prompt_id**: Só um prompt.

- **limit**: Padrão 15, máximo 30.

- **period**: Padrão 

`7d`

.

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

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

## get_channel_presence

Presença da marca nos recursos especiais das respostas: produtos de Shopping, o mapa de negócios locais do Google e posts do X citados pelo Grok. A conta é por conversa: em quantas o recurso apareceu e em quantas a marca estava nele. Pro mapa, traz também a posição média e os negócios concorrentes que mais aparecem.

**Pergunte assim:** "eu apareço no mapa do Google?", "quem domina o Shopping no meu mercado?"

- **brand_id**: UUID da marca.

- **period**: Padrão 

`7d`

.

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

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