---
name: claude-api
description: Use the Vivino API from Claude/OpenClaw for wine search and integration workflows.
---

# Claude/OpenClaw Vivino API Skill

Use this skill when you need to query the Vivino API directly from an LLM workflow.

## Base guidance

- Prefer `GET /api/wine/search?q={query}` for all discovery requests.
- Authenticate with bearer token:
  - `Authorization: Bearer {YOUR_API_KEY}`
  - `Accept: application/json`
- Use the direct OpenAPI document for schema-aware generation:
  - `/openapi/direct.json`

## Example call

```bash
curl -G 'https://wine.mediashare.ro/api/wine/search' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json' \
  --data-urlencode 'q=Purcari Malbec 2020'
```

## Output shaping

Return compact summaries with:

- `name`
- `winery`
- `year`
- `score`
- `reviews`
- `url`