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

# Recursos e Prompts MCP

> Use Recursos MCP para acessar dados do catálogo e Prompts MCP para executar fluxos de otimização.

## Recursos MCP

Os Recursos MCP permitem que agentes leiam dados estruturados do Alana sem fazer chamadas de ferramentas explícitas. Pense neles como anexos de dados somente leitura que o agente pode referenciar.

### Recursos Disponíveis

| URI do Recurso                 | Descrição                                 |
| ------------------------------ | ----------------------------------------- |
| `alana://catalog/{catalog_id}` | Catálogo completo como dados estruturados |
| `alana://product/{product_id}` | Detalhes do produto individual            |
| `alana://brand/{brand_id}`     | Diretrizes e contexto de marca            |
| `alana://workspace/stats`      | Estatísticas do workspace                 |

### Lendo um Recurso

<CodeGroup>
  ```javascript JavaScript theme={null}
  // Listar recursos disponíveis
  const resources = await client.listResources();

  // Ler um recurso específico
  const resource = await client.readResource({
    uri: "alana://catalog/cat_abc",
  });
  console.log(resource.contents[0].text);
  ```

  ```python Python theme={null}
  # Listar recursos disponíveis
  resources = await session.list_resources()

  # Ler um recurso específico
  resource = await session.read_resource("alana://catalog/cat_abc")
  print(resource.contents[0].text)
  ```
</CodeGroup>

### Como Agentes Usam Recursos

Quando um agente precisa de contexto do catálogo, pode ler o recurso no início de uma sessão em vez de fazer chamadas repetidas a `search_products`. Isso reduz latência e chamadas de ferramentas para fluxos com muito contexto.

***

## Prompts MCP

Os Prompts MCP são templates de fluxo de trabalho pré-construídos que agentes podem invocar. Eles combinam múltiplas chamadas de ferramentas em um único fluxo guiado.

### Prompts Disponíveis

| Nome do Prompt            | Descrição                                     |
| ------------------------- | --------------------------------------------- |
| `optimize-catalog`        | Executar otimização em um catálogo inteiro    |
| `analyze-product`         | Análise profunda de um produto                |
| `generate-feed-report`    | Análise de performance de feed                |
| `brand-consistency-check` | Verificar produtos contra diretrizes de marca |

### Usando um Prompt

<CodeGroup>
  ```javascript JavaScript theme={null}
  // Listar prompts disponíveis
  const prompts = await client.listPrompts();

  // Obter um prompt com argumentos
  const prompt = await client.getPrompt({
    name: "optimize-catalog",
    arguments: { catalog_id: "cat_abc", target_platform: "google" },
  });

  console.log(prompt.messages);
  ```

  ```python Python theme={null}
  # Listar prompts disponíveis
  prompts = await session.list_prompts()

  # Obter um prompt
  prompt = await session.get_prompt(
      "optimize-catalog",
      arguments={"catalog_id": "cat_abc", "target_platform": "google"},
  )
  print(prompt.messages)
  ```
</CodeGroup>

### Prompt: analyze-product

Gera uma análise estruturada do produto incluindo score, sugestões de melhoria e recomendações por plataforma.

**Argumentos:**

| Argumento    | Obrigatório | Descrição                                         |
| ------------ | ----------- | ------------------------------------------------- |
| `product_id` | Sim         | Produto para analisar                             |
| `platforms`  | Não         | Lista separada por vírgulas: `google,meta,openai` |

### Prompt: brand-consistency-check

Verifica um conjunto de produtos contra as diretrizes de marca e sinaliza inconsistências.

**Argumentos:**

| Argumento    | Obrigatório | Descrição                             |
| ------------ | ----------- | ------------------------------------- |
| `brand_id`   | Sim         | Marca para verificar                  |
| `catalog_id` | Não         | Catálogo para auditar (padrão: todos) |