Security checks across malware telemetry and agentic risk
This travel-search skill is coherent and disclosed, but users should understand that travel queries and booking-link details are sent to external travel APIs and a proxy/shortener.
Install only if you are comfortable sharing travel-search details with the listed travel providers and the api.botclaw.ru proxy/shortener. Avoid unnecessary sensitive details, be cautious when searches include children’s ages, use explicit departure cities instead of IP geolocation, and inspect shortened links before booking.
**Quick example — cheapest flights:**
```bash
python scripts/api_call.py --method GET \
--url "https://api.botclaw.ru/v1/prices/cheap" \
--params '{"origin":"MOW","destination":"AYT","depart_date":"2026-06","currency":"rub"}'
```After getting prices, create a booking link on aviasales.ru. See [references/aviasales-links.md](references/aviasales-links.md) for URL format, then get a short link:
```bash
python scripts/api_call.py --method GET \
--url "https://api.botclaw.ru/short-link" \
--params '{"url":"https://www.aviasales.ru/search?origin_iata=MOW&destination_iata=AYT&depart_date=2026-06-01&return_date=2026-06-15&adults=1&children=0&infants=0&trip_class=0"}'
```**Step 1 — start search:**
```bash
python scripts/api_call.py --method POST \
--url "https://api.botclaw.ru/travelata-partners/tours/asyncSearch" \
--body '{"departureCity":2,"country":92,"checkInDateRange":{"from":"2026-06-08","to":"2026-06-22"},"nightRange":{"from":"7","to":"10"},"touristGroup":{"adults":2,"kids":1,"infants":0,"kidsAges":[8]},"hotelCategories":[4,7],"meals":[1,8]}'
```**Step 2 — fetch tours** (same criteria; pass arrays as `key[]`):
```bash
python scripts/api_call.py --method GET \
--url "https://api.botclaw.ru/travelata-partners/tours" \
--params '{"departureCity":"2","country":"92","checkInDateRange[from]":"2026-06-08","checkInDateRange[to]":"2026-06-22","nightRange[from]":"7","nightRange[to]":"10","touristGroup[adults]":"2","touristGroup[kids]":"1","touristGroup[infants]":"0","touristGroup[kidsAges][]":["8"],"hotelCategories[]":["4","7"],"meals[]":["1","8"],"sections[]":["hotels","meals"],"limit":"30"}'
```**Build the booking URL** from `tour.hotel` and `tour.id`, then convert through `/short-link`:
```bash
python scripts/api_call.py --method GET \
--url "https://api.botclaw.ru/short-link" \
--params '{"url":"https://travelata.ru/hotel/<tour.hotel>/tourPage?identity=<tour.id>"}'
```**Quick example:**
```bash
python scripts/api_call.py --method GET \
--url "https://api.botclaw.ru/leveltravel/tours" \
--params '{"departure_key":"moscow","country_iso2":"TR","date_from":"2026-05-01","date_to":"2026-05-15","nights_min":"7","nights_max":"10","stars_min":"4","limit":"20"}'
```**Quick example — excursions in Kemer:**
```bash
python scripts/api_call.py --method GET \
--url "https://api.botclaw.ru/sputnik8/v1/products" \
--params '{"city_id":"420","limit":"10","lang":"ru","currency":"rub","order":"rating","order_type":"desc"}'
```### 4. Utilities
- **City/airport lookup:** [references/travelpayouts-utils.md](references/travelpayouts-utils.md) — autocomplete and IATA resolver
- **Short links:** `GET https://api.botclaw.ru/short-link?url=<URL>` — get a short booking link for any travel URL
- **Airline logos:** `http://pics.avs.io/{width}/{height}/{IATA}.png` (e.g. `http://pics.avs.io/200/200/SU.png`)
- **Currency rates to RUB:** `GET http://yasen.aviasales.ru/adaptors/currency.json`VirusTotal findings are pending for this skill version.