# Conector MCP — Amazon Seller Central

Servidor MCP que conecta Claude con tu cuenta de Amazon Seller Central vía la
**Selling Partner API (SP-API)**. Permite consultar pedidos, resumen de ventas,
inventario FBA y eventos financieros bajo demanda.

## Herramientas expuestas

| Herramienta            | Qué hace                                          |
|------------------------|---------------------------------------------------|
| `pedidos_recientes`    | Pedidos de las últimas N horas                    |
| `resumen_ventas`       | Ventas agregadas (importe, pedidos, unidades)     |
| `inventario`           | Niveles de stock FBA por SKU                      |
| `eventos_financieros`  | Liquidaciones, comisiones y fees recientes        |

---

## Instalar en un ordenador nuevo (vía `uvx`)

Requisito único: tener **[uv](https://docs.astral.sh/uv/)** instalado
(`curl -LsSf https://astral.sh/uv/install.sh | sh`). `uv` descarga Python y las
dependencias automáticamente — no hay que crear entornos ni instalar nada más.

Registra el conector en Claude (Code o Cowork) con un solo comando:

```bash
claude mcp add amazon-seller \
  --env SPAPI_REFRESH_TOKEN=TU_REFRESH_TOKEN \
  --env SPAPI_LWA_APP_ID=TU_APP_ID \
  --env SPAPI_LWA_CLIENT_SECRET=TU_CLIENT_SECRET \
  --env SPAPI_MARKETPLACE=ES \
  -- uvx --from git+https://github.com/USUARIO/amazon-seller-mcp amazon-seller
```

(Sustituye `USUARIO` por tu usuario de GitHub y rellena tus credenciales.)

Reinicia Claude y pregúntame, por ejemplo:
- "¿Cuántas ventas llevo hoy?"
- "Dame los pedidos de las últimas 6 horas"

---

## Conseguir las credenciales (una sola vez)

1. **Seller Central → Settings → User Permissions → Develop apps for your
   account**.
2. Crea una aplicación y solicita los roles: **Orders**, **Inventory**,
   **Finance** y **Selling Partner Insights / Sales**.
3. Tras la aprobación obtendrás `LWA client_id` y `LWA client_secret`.
4. Autoriza la app sobre tu propia cuenta (self-authorization) para generar el
   **refresh token**.

> Desde 2024 la SP-API ya **no** requiere claves AWS IAM ni firma SigV4: basta
> con las credenciales LWA.

Las mismas credenciales valen para todos tus ordenadores. Se pasan como
variables de entorno en la config de Claude (ver arriba); **nunca** van dentro
del repositorio.

---

## Desarrollo local

```bash
uv run amazon-seller          # arranca el servidor por stdio
```

Para pruebas locales puedes poner las credenciales en un `.env` (gitignored);
en producción se pasan como `--env` en la config de Claude.

## Notas

- La SP-API es **pull**, no streaming: consulto la API en el momento que
  preguntas. Amazon aplica *throttling*, evita consultas en bucle.
- El `refresh_token` da acceso continuo a tu cuenta; trátalo como una contraseña.
- `inventario` puede devolver 403 si la cuenta no tiene habilitada la API de
  inventario FBA; el resto de herramientas funcionan con credenciales LWA.
</content>