> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alana.shopping/llms.txt
> Use this file to discover all available pages before exploring further.

# Ferramentas de Analytics

> Analytics de busca, performance de consultas e estatísticas de recomendações.

## get\_search\_analytics

Recupere analytics de busca agregados do seu catálogo.

**Parâmetros:**

| Parâmetro    | Tipo    | Obrigatório | Descrição                            |
| ------------ | ------- | ----------- | ------------------------------------ |
| `days`       | inteiro | Não         | Janela em dias (padrão: 30, máx: 90) |
| `catalog_id` | string  | Não         | Filtrar para um catálogo específico  |

<CodeGroup>
  ```javascript JavaScript theme={null}
  const result = await client.callTool({
    name: "get_search_analytics",
    arguments: { days: 30 },
  });
  console.log(result.content[0].text);
  ```

  ```python Python theme={null}
  result = await session.call_tool(
      "get_search_analytics",
      arguments={"days": 30},
  )
  print(result.content[0].text)
  ```

  ```bash cURL theme={null}
  curl -X POST "https://app.alana.shopping/api/mcp/sse" \
    -H "Authorization: Bearer sk_live_sua_chave_api" \
    -H "Content-Type: application/json" \
    -d '{"method":"tools/call","params":{"name":"get_search_analytics","arguments":{"days":30}}}'
  ```
</CodeGroup>

**Resposta:**

```json theme={null}
{
  "period_days": 30,
  "total_queries": 18420,
  "zero_result_rate": 0.032,
  "avg_results_per_query": 12.4,
  "top_queries": [
    { "query": "camiseta algodão", "count": 842 },
    { "query": "tênis de corrida", "count": 671 }
  ]
}
```

***

## get\_query\_performance

Obtenha métricas de performance para consultas de busca específicas.

**Parâmetros:**

| Parâmetro | Tipo      | Obrigatório | Descrição                         |
| --------- | --------- | ----------- | --------------------------------- |
| `queries` | string\[] | Sim         | Consultas para analisar (máx: 20) |
| `days`    | inteiro   | Não         | Janela de lookback (padrão: 30)   |

<CodeGroup>
  ```javascript JavaScript theme={null}
  const result = await client.callTool({
    name: "get_query_performance",
    arguments: {
      queries: ["camiseta algodão", "tênis de corrida"],
      days: 30,
    },
  });
  ```

  ```python Python theme={null}
  result = await session.call_tool(
      "get_query_performance",
      arguments={
          "queries": ["camiseta algodão", "tênis de corrida"],
          "days": 30,
      },
  )
  ```
</CodeGroup>

***

## get\_recommendation\_stats

Recupere estatísticas sobre recomendações de produtos e sua efetividade.

**Parâmetros:**

| Parâmetro    | Tipo    | Obrigatório | Descrição                          |
| ------------ | ------- | ----------- | ---------------------------------- |
| `days`       | inteiro | Não         | Janela de lookback (padrão: 30)    |
| `product_id` | string  | Não         | Filtrar para um produto específico |

<CodeGroup>
  ```javascript JavaScript theme={null}
  const result = await client.callTool({
    name: "get_recommendation_stats",
    arguments: { days: 30 },
  });
  ```

  ```python Python theme={null}
  result = await session.call_tool(
      "get_recommendation_stats",
      arguments={"days": 30},
  )
  ```
</CodeGroup>

**Resposta:**

```json theme={null}
{
  "period_days": 30,
  "total_recommendations_shown": 94200,
  "click_through_rate": 0.087,
  "conversion_rate": 0.012,
  "top_recommended_products": [
    { "product_id": "SKU-001", "impressions": 4820, "clicks": 389 }
  ]
}
```