> ## 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 Mídia e Contexto

> Gere descrições, melhore imagens e recupere contexto de marca.

## generate\_description

Gere uma descrição de produto com IA a partir dos dados existentes ou de uma imagem.

**Parâmetros:**

| Parâmetro    | Tipo    | Obrigatório | Descrição                                       |
| ------------ | ------- | ----------- | ----------------------------------------------- |
| `product_id` | string  | Sim         | ID ou SKU do produto                            |
| `style`      | string  | Não         | `technical`, `lifestyle`, `seo` (padrão: `seo`) |
| `max_chars`  | inteiro | Não         | Tamanho máximo (padrão: 500)                    |
| `language`   | string  | Não         | `pt-BR` ou `en` (padrão: idioma do workspace)   |

<CodeGroup>
  ```javascript JavaScript theme={null}
  const result = await client.callTool({
    name: "generate_description",
    arguments: {
      product_id: "SKU-001",
      style: "lifestyle",
      max_chars: 300,
      language: "pt-BR",
    },
  });
  console.log(result.content[0].text);
  ```

  ```python Python theme={null}
  result = await session.call_tool(
      "generate_description",
      arguments={
          "product_id": "SKU-001",
          "style": "lifestyle",
          "max_chars": 300,
          "language": "pt-BR",
      },
  )
  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":"generate_description","arguments":{"product_id":"SKU-001","style":"lifestyle","language":"pt-BR"}}}'
  ```
</CodeGroup>

**Resposta:**

```json theme={null}
{
  "product_id": "SKU-001",
  "description": "Vista o conforto com nossa Camiseta de Algodão Azul. Feita com 100% algodão pré-encolhido, ela mantém você fresco e com estilo do trabalho ao fim de semana.",
  "style": "lifestyle",
  "char_count": 163
}
```

***

## enhance\_images

Analise imagens de produtos e retorne sugestões de melhoria (alt text, composição, score de qualidade).

**Parâmetros:**

| Parâmetro           | Tipo     | Obrigatório | Descrição                     |
| ------------------- | -------- | ----------- | ----------------------------- |
| `product_id`        | string   | Sim         | ID ou SKU do produto          |
| `generate_alt_text` | booleano | Não         | Gerar alt text (padrão: true) |

<CodeGroup>
  ```javascript JavaScript theme={null}
  const result = await client.callTool({
    name: "enhance_images",
    arguments: { product_id: "SKU-001", generate_alt_text: true },
  });
  ```

  ```python Python theme={null}
  result = await session.call_tool(
      "enhance_images",
      arguments={"product_id": "SKU-001", "generate_alt_text": True},
  )
  ```
</CodeGroup>

***

## get\_brand\_context

Recupere diretrizes de marca, tom de voz e dados de posicionamento.

**Parâmetros:**

| Parâmetro          | Tipo     | Obrigatório | Descrição                             |
| ------------------ | -------- | ----------- | ------------------------------------- |
| `brand_id`         | string   | Sim         | ID da marca                           |
| `include_keywords` | booleano | Não         | Incluir palavras-chave (padrão: true) |

<CodeGroup>
  ```javascript JavaScript theme={null}
  const result = await client.callTool({
    name: "get_brand_context",
    arguments: { brand_id: "brand_abc", include_keywords: true },
  });
  ```

  ```python Python theme={null}
  result = await session.call_tool(
      "get_brand_context",
      arguments={"brand_id": "brand_abc", "include_keywords": True},
  )
  ```
</CodeGroup>

**Resposta:**

```json theme={null}
{
  "brand_id": "brand_abc",
  "name": "SuaMarca",
  "tone": "amigável, acessível, confiante",
  "positioning": "Moda casual premium para profissionais ativos",
  "keywords": ["conforto", "qualidade", "sustentável", "versátil"],
  "forbidden_terms": ["barato", "desconto"]
}
```