grupo-venus

# Grupo Venus

Use this skill to fetch free astrological charts, transit forecasts, and compatibility reports from **grupovenus.com** — a classic ASP astrology platform with a rich free tier. Manage multiple people in memory and analyze charts conversationally.

> **Unofficial skill.** Not affiliated with or endorsed by Grupo Venus. Uses the public free tier of grupovenus.com as-is.

**Base URL:** `https://grupovenus.com`
**No API key required.** Data is session-cookie based; person data is stored locally in memory.

---

## People Storage

All person data lives in your memory file. Load it before any operation:

```
~/.openclaw/workspace/memory/grupo-venus.json
```

Structure (we use Luis Alberto Spinetta as the example throughout this skill — because he's from another planet):
```json
{
  "people": {
    "spinetta": {
      "name": "Luis Alberto Spinetta",
      "birthdate": "1/23/1950 4:35:00 PM",
      "city": "Buenos Aires",
      "country": "Argentina",
      "sex": "H",
      "tz_offset": "3",
      "lat_dms": "34S35",
      "lon_dms": "58W22",
      "lat_decimal": -34.5833,
      "lon_decimal": 58.3667,
      "style": "deep"
    }
  }
}
```

**sex:** `H` = Hombre (male), `V` = Varón/Mujer — use `H` for male, `V` for female.
**tz_offset:** Hours from UTC, sign inverted: `3` = UTC-3 (Argentina), `-1` = UTC+1 (Madrid).
**lat_dms / lon_dms:** `34S35` = 34°35′S, `58W22` = 58°22′W. N/S and E/W are explicit.
**style:** Communication style preference — `casual`, `deep`, or `practical`. See Voice & Style section.

If the file doesn't exist yet, create it with `{"people": {}}`.

---

## Adding a Person

### Step 1 — Look up the city coordinates

```bash
curl -s "https://grupovenus.com/buscaciudjson.asp?q=CITY&pais=COUNTRY"
```

Example:
```bash
curl -s "https://grupovenus.com/buscaciudjson.asp?q=Bahia+Blanca&pais=Argentina"
# → [{"label":"Bahia Blanca, Argentina"}]
```

This confirms the city/country string the server recognises. Use the exact spelling returned.

###...

# grupo-venus

Agentic skill that acts as a conversational frontend for [grupovenus.com](https://grupovenus.com) — natal charts, transit forecasts, and compatibility reports, all from the free tier.

> **Unofficial.** Not affiliated with or endorsed by Grupo Venus.

---

## What it does

- Fetches and displays **natal chart images**
- Parses **1-year slow-planet transit graphs** (Saturn, Uranus, Neptune, Pluto) and identifies the most active transits by intensity and timing
- Retrieves **interpretation texts** in three styles: colloquial, technical, and potentials
- Generates **compatibility reports** between two people (synastry, friendship, composite chart)
- Stores people across sessions in a local memory file
- Adapts its reading style per person: `casual`, `deep`, or `practical`

No API key required. Uses the public free tier of grupovenus.com as-is.

---

## Requirements

- `curl`
- `python3` (for URL-decoding the registration response)

---

## People storage

Person data is stored locally at:

```
~/.openclaw/workspace/memory/grupo-venus.json
```

---

## Free tier coverage

| Feature | Available |
|---------|-----------|
| Natal chart image | ✅ |
| 1-year outer planet transits (Sat–Plu) | ✅ |
| 3-day / 1-week short forecasts | ✅ |
| Transit interpretation texts | ✅ |
| Compatibility reports (partial) | ✅ |
| Full natal report text | Ticket required |
| 2-year forecast | Ticket required |

---

## License

MIT