> ## 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 Commerce

> Otimização de conteúdo com IA — optimize_product, batch_optimize, get_score, compare_scores.

## optimize\_product

Gere título, descrição e atributos otimizados com IA para um produto.

**Parâmetros:**

| Parâmetro         | Tipo     | Obrigatório | Descrição                                      |
| ----------------- | -------- | ----------- | ---------------------------------------------- |
| `product_id`      | string   | Sim         | ID ou SKU do produto                           |
| `target_platform` | string   | Não         | `google`, `meta`, `openai` (padrão: todos)     |
| `apply`           | booleano | Não         | Aplicar mudanças imediatamente (padrão: false) |

<CodeGroup>
  ```javascript JavaScript theme={null}
  const result = await client.callTool({
    name: "optimize_product",
    arguments: {
      product_id: "SKU-001",
      target_platform: "google",
      apply: false,
    },
  });
  console.log(result.content[0].text);
  ```

  ```python Python theme={null}
  result = await session.call_tool(
      "optimize_product",
      arguments={
          "product_id": "SKU-001",
          "target_platform": "google",
          "apply": False,
      },
  )
  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":"optimize_product","arguments":{"product_id":"SKU-001","target_platform":"google"}}}'
  ```
</CodeGroup>

**Resposta:**

```json theme={null}
{
  "product_id": "SKU-001",
  "original": { "title": "Camiseta Azul", "description": "Uma camiseta" },
  "optimized": {
    "title": "Camiseta de Algodão Slim-Fit Azul Masculina | P-GG",
    "description": "100% algodão pré-encolhido. Tecido respirável para conforto o dia todo..."
  },
  "score_before": 0.42,
  "score_after": 0.89,
  "applied": false
}
```

***

## batch\_optimize

Otimize múltiplos produtos em uma única chamada.

**Parâmetros:**

| Parâmetro         | Tipo      | Obrigatório | Descrição                             |
| ----------------- | --------- | ----------- | ------------------------------------- |
| `product_ids`     | string\[] | Sim         | Array de IDs (máx: 50)                |
| `target_platform` | string    | Não         | Plataforma alvo                       |
| `apply`           | booleano  | Não         | Aplicar imediatamente (padrão: false) |

<CodeGroup>
  ```javascript JavaScript theme={null}
  const result = await client.callTool({
    name: "batch_optimize",
    arguments: {
      product_ids: ["SKU-001", "SKU-002", "SKU-003"],
      apply: true,
    },
  });
  ```

  ```python Python theme={null}
  result = await session.call_tool(
      "batch_optimize",
      arguments={
          "product_ids": ["SKU-001", "SKU-002", "SKU-003"],
          "apply": True,
      },
  )
  ```
</CodeGroup>

***

## get\_score

Obtenha o score de otimização atual de um produto.

**Faixas de score:** Excelente (0,85–1,0) · Bom (0,65–0,84) · Atenção (0,40–0,64) · Ruim (0–0,39)

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

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

***

## compare\_scores

Compare scores de otimização entre um conjunto de produtos.

<CodeGroup>
  ```javascript JavaScript theme={null}
  const result = await client.callTool({
    name: "compare_scores",
    arguments: {
      product_ids: ["SKU-001", "SKU-002", "SKU-003"],
      sort_by: "score_asc",
    },
  });
  ```

  ```python Python theme={null}
  result = await session.call_tool(
      "compare_scores",
      arguments={
          "product_ids": ["SKU-001", "SKU-002", "SKU-003"],
          "sort_by": "score_asc",
      },
  )
  ```
</CodeGroup>