Przejdź do treści
Biblioteka skilli
Produktywność osobista · Research

car-search

/car-search

Wyszukuje i porównuje wynajem samochodów w miastach i na lotniskach, podając cenę każdego sprzedawcy z linkiem do rezerwacji.

Repozytorium
ktemia-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
12.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
16
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/ktemia.py

Co robi i kiedy

Wyszukuje i porównuje wynajem samochodów w miastach i na lotniskach, podając cenę każdego sprzedawcy z linkiem do rezerwacji.

Oryginalny opis (EN)

Search and compare rental cars with the Ktemia car search API and return each seller's price with a booking link. Use when the user asks to hire, rent, or compare a car at a city or airport on specific dates, including narrowing to one rental agency or booking site. Asks for missing details instead of guessing.

Jak działa

  1. Before you call anything
  2. Workflow
  3. Errors
  4. Without Python
  5. Security
  6. Further reading
Sekcje z nagłówków SKILL.md, w oryginale · 129 linii, 1 090 słów
Podgląd SKILL.md
---
name: car-search
description: Search and compare rental cars with the Ktemia car search API and return each seller's price with a booking link. Use when the user asks to hire, rent, or compare a car at a city or airport on specific dates, including narrowing to one rental agency or booking site. Asks for missing details instead of guessing.
version: 1.0.1
allowed-tools: Bash(python3 scripts/ktemia.py:*)
metadata:
  openclaw:
    emoji: "🚗"
    homepage: https://www.ktemia.com/docs/api/cars/search/
    requires:
      env: [KTEMIA_API_KEY]
      anyBins: [python3, python]
    primaryEnv: KTEMIA_API_KEY
    envVars:
      - name: KTEMIA_API_KEY
        required: true
        description: Ktemia API key from https://app.ktemia.com (Free plan includes 100 requests a month).
      - name: KTEMIA_API_URL
        required: false
        description: Optional. Override the API base URL; must be https on ktemia.com, anything else is refused. Defaults to https://api.ktemia.com.
---

# Car search with the Ktemia API

Ktemia compares rental cars and returns each seller's booking link. It does not reserve the car: the traveller books on the seller's site.

API reference: https://www.ktemia.com/docs/api/cars/search/

## Before you call anything

1. You need `KTEMIA_API_KEY` in the environment. If it is missing, tell the user to create a key (https://www.ktemia.com/docs/api/#authentication) and export it. Never print the key or put it in code you write for a browser.
2. You need a pickup place, a pickup date, and a drop-off date. Drop-off defaults to the same place. Times default to 12:00.
3. **Do not guess.** If a place, date, or time is missing or vague ("next week", "somewhere"), ask. Every API call counts against the user's monthly quota, so a guessed search wastes it.
4. Dates are `YYYY-MM-DD` and must be today or later. Times are `HH:MM`. Resolve "next Friday" into a date and confirm it with the user if there is any doubt.

## Workflow

Use the bundled script `scripts/ktemia.py` in this skill's directory. It needs only Python 3, no packages. Every command prints JSON.

### 1. Turn a place name into a location id

`pickupLocation` is a `locationId`, not a city name or an airport code.

```bash
python3 scripts/ktemia.py locations "Lisbon"
python3 scripts/ktemia.py locations "LIS" --type airport
```

`--type` is `city` (default), `airport`, or `all`.

- Send `locationId` as `--pickup`. Use a second id as `--dropoff` only when the traveller returns the car somewhere else.
- If several places match, **ask which one**. Do not take the first match.

### 2. Start the search

```bash
python3 scripts/ktemia.py search --pickup 29230 --pickup-date 2027-03-10 --dropoff-date 2027-03-17
python3 scripts/ktemia.py search --pickup 29230 --dropoff 174457 --pickup-date 2027-03-10 --dropoff-date 2027-03-17 --pickup-time 09:00 --dropoff-time 18:00 --transmission automatic --sort price --sort-order asc
```

Other options: `--driver-age 30` (18–99; send it only when the user gave an age), `--class small|medium|large|suv|van|pickup|luxury|convertible`, `--max-price N` (whole number in the country's currency), `--price-mode total|perDay` (default `total`, the price for the whole hire), `--country GB`.

`--providers` and `--agencies` narrow a search to named sellers. Both need ids from a previous results page, so they belong on a **second** search — see "Filter by seller or agency" below. Do not guess the ids.

`country` picks the market. Prices come back in that country's native currency: GB is GBP, DE is EUR, US is USD. Omit it for the US. Do not send a currency field.

`sort` is `bestValue` (default), `price`, `rating`, or `distance`. `--sort-order` changes `price` only: `asc` is cheapest first, `desc` is dearest first. Rating is always highest first. Distance is always nearest first.

The search returns a `searchToken`, valid for 60 minutes. It does not return cars. A search usually answers in several seconds.

### 3. Read results

```bash
python3 scripts/ktemia.py results <searchToken>
```

Up to 20 cars per page. Show the user a short list: car, class, passengers, agency, and price. `price` is the hire total. `perDay` is the daily price. If `nextToken` is present and the user wants more, call `results <nextToken>`.

The summary also lists `bookingSites` and `agencies`: the sellers and rental companies in this search, each with a count. Those ids are what `--providers` and `--agencies` take.

### 4. Filter by seller or agency

When the user wants one company ("only Avis", "book through Expedia, not the agency"), read the ids off a results page and start a **new** search with them. A filter cannot be applied to an existing token.

```bash
python3 scripts/ktemia.py search --pickup 22863 --pickup-date 2027-03-10 --dropoff-date 2027-03-17 --agencies avis,hertz
python3 scripts/ktemia.py search --pickup 22863 --pickup-date 2027-03-10 --dropoff-date 2027-03-17 --providers "Booking.com,Expedia"
```

- `--agencies` is the company whose car it is. Ids are lowercase: `avis`, `hertz`, `enterprise`, `budget`, `alamo`, `dollar`, `europcar`, `fox`.
- `--providers` is the site selling it. Ids are display names with capitals and dots: `Booking.com`, `Expedia`, `Avis`, `Auto Europe`, `DiscoverCars.com`.
- Take both from `bookingSites` and `agencies` on a results page, exactly as written — matching is case-sensitive. Separate with commas only, so an id containing a space is fine: `--providers "Auto Europe,Car Rental 8"`.
- Up to 10 each. An id with `,`, `;`, or `=` in it is rejected.
- Which sellers appear changes by city and date, so **read the ids rather than hard-coding them**. Tell the user this is a second search against their quota, and ask first.

Both filters can be sent together. Narrowing can return nothing, which is a real `NO_RESULTS` — report it instead of retrying.

### 5. Booking links for one car

```bash
python3 scripts/ktemia.py details <searchToken> <car id>
```

Each option includes `providerUrl`, the seller's booking page. Give the user the link as returned; do not edit the query string. A null URL means that seller did not resolve. Make clear they book on the seller's site, and that prices can change after the search.

## Errors

The script prints the API error and exits non-zero. Common codes:

- `MISSING_FIELD` / `INVALID_REQUEST`: ask the user for the field in `param`, or fix the value.
- `DATE_IN_PAST`: ask for a future date.
- `NO_RESULTS` (404): nothing published for that place and those dates. Suggest nearby dates or a different desk, and ask before searching again.
- `SEARCH_EXPIRED` (410): the 60-minute token is gone. Start a new search.
- `MISSING_API_KEY` / `INVALID_API_KEY` (401): the key is missing or wrong.
- `QUOTA_EXCEEDED` / `RATE_LIMIT_EXCEEDED` (429): stop and tell the user. Do not retry in a loop.
- `LOCATIONS_UNAVAILABLE` / `SEARCH_FAILED` / `DETAILS_FAILED` (502): temporary. Retry the same request once.

Full list: https://www.ktemia.com/docs/api/#errors

## Without Python

```bash
curl "https://api.ktemia.com/cars/locations?query=Lisbon" -H "X-API-Key: $KTEMIA_API_KEY"

curl https://api.ktemia.com/cars/search \
  -H "X-API-Key: $KTEMIA_API_KEY" -H "Content-Type: application/json" \
  -d '{"pickupLocation": "29230", "pickupDate": "2027-03-10", "dropoffDate": "2027-03-17"}'

curl https://api.ktemia.com/cars/search \
  -H "X-API-Key: $KTEMIA_API_KEY" -H "Content-Type: application/json" \
  -d '{"pickupLocation": "29230", "pickupDate": "2027-03-10", "dropoffDate": "2027-03-17", "agencies": ["avis"], "providers": ["Booking.com"]}'

curl "https://api.ktemia.com/cars/results?token=$TOKEN" -H "X-API-Key: $KTEMIA_API_KEY"
curl "https://api.ktemia.com/cars/details?token=$TOKEN&resultId=$ID" -H "X-API-Key: $KTEMIA_API_KEY"
```

## Security

- The API key is read from `KTEMIA_API_KEY` and sent only as the `X-API-Key` header, over HTTPS, to `https://api.ktemia.com`.
- `scripts/ktemia.py` refuses any `KTEMIA_API_URL` that is not `https://` on `ktemia.com`, and never follows redirects, so the key cannot reach another host.
- The script uses the Python standard library only. It reads no files and writes nothing to disk.

## Further reading

Background for the user. You do not need these to run a search, so don't open them unless the user asks.

- [Car rental API: compare vehicles and prices for a pickup](https://www.ktemia.com/blog/car-rental-api/)
- [Car rental aggregator API: search multiple providers in one call](https://www.ktemia.com/blog/car-rental-aggregator-api/)
- [How to compare car rental deals across providers and locations](https://www.ktemia.com/blog/compare-car-rental-deals/)
Pliki w paczce (2)
  • SKILL.md 8 KB
  • scripts/ktemia.py 9 KB

Wersje

W bazie nie ma innych skilli o nazwie car-search.

Migawka bazy z 13.11.2026 · wersja paczki 573050fa79e2 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100hotel-search
    Szuka i porównuje hotele przez API Ktemia: cenę u każdego sprzedawcy, link do rezerwacji i opinie gości.
  • 100flight-search
    Wyszukuje, porównuje i wycenia loty w jedną stronę, w obie strony lub z kilku miejsc, z linkami do rezerwacji.
  • 90bama-ir
    Przeszukuje ogłoszenia i ceny samochodów na Bama w Iranie tylko do odczytu, także nowych i używanych.
  • 100rental-assistant
    Wyszukuje oferty wynajmu mieszkań, porównuje ogłoszenia z różnych platform i pomaga znaleźć lokal w wybranym regionie.
  • 95booking-cli
    Wyszukuje hotele, apartamenty i noclegi na Booking.com po miejscu, datach i filtrach, porównuje ceny i oceny.
  • 90karnameh
    Odczytuje ogłoszenia samochodów używanych, ceny nowych aut i porównania z serwisu Karnameh w Iranie.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.