Developer

Limba: Română
Aspect

Tema

Culoarea de accent

Tema și culoarea te urmează pe satelit.md și în aplicație.

Intră

Unde schimbi tema?

Alege unde se aplică tema nouă.

Poți schimba oricând din antet.

Ghid · Python 3.9+

Alerte oferte turistice sub buget

Spui țările, bugetul pe persoană în lei și câte nopți. De trei ori pe zi scriptul caută în ofertele agențiilor din Moldova și te anunță doar de ofertele noi sau care s-au ieftinit.

Rulează pe
Python 3.9+
O rulare
7 credite
Pe lună
630 de credite
Pornit în
10 min
$ COUNTRIES=Egipt,Turcia BUDGET=9000 NIGHTS_MIN=7 python3 tours_alert.py14 offers under 9000 lei, 7 credits

Cum funcționează

  1. Citește prețul minim pe persoană al fiecărei țări din /v1/tours/countries. O țară peste buget nu mai costă o căutare.
  2. Pentru fiecare țară rămasă caută în /v1/tours, ordonat după preț, cu filtrele de nopți, date și masă.
  3. Se oprește la prima ofertă peste buget: restul sunt mai scumpe.
  4. Compară cu rularea trecută din tours-state.json și alertează doar ofertele noi sau mai ieftine.

Cât costă: 1 credit pentru țări, 3 pentru fiecare căutare: 7 credite cu două țări. De trei ori pe zi: 630 de credite pe lună. Încape în planul Start.

Cum îl rulezi

bash
export SATELIT_KEY=sat_live_...
COUNTRIES=Egipt,Turcia BUDGET=9000 NIGHTS_MIN=7 python3 tours_alert.py

Ce scoate

stdout
14 offers under 9000 lei, 7 credits

Scriptul complet

tours_alert.py
#!/usr/bin/env python3
"""Tours under budget: package tours from Moldova's agencies, an alert when one fits your price.

    SATELIT_KEY=sat_live_... COUNTRIES=Egipt,Turcia BUDGET=9000 python3 tours_alert.py

BUDGET is lei per person. Optional: NIGHTS_MIN, NIGHTS_MAX, FROM and TO (YYYY-MM-DD, the departure window),
BOARD (AI, BB...), ALERT_URL (a Slack-style incoming webhook; empty prints the alerts).
Standard library only. Put it in cron: 0 8,14,20 * * * python3 /path/tours_alert.py
"""
import json
import os
import sys
import time
import urllib.error
import urllib.parse
import urllib.request
from pathlib import Path

sys.stdout.reconfigure(encoding="utf-8")  # names hold ă, ș, ț whatever the console's code page

BASE = os.environ.get("SATELIT_BASE", "https://api.satelit.md/v1")
KEY = os.environ["SATELIT_KEY"]
COUNTRIES = [c.strip() for c in os.environ.get("COUNTRIES", "Egipt,Turcia").split(",") if c.strip()]
BUDGET = float(os.environ.get("BUDGET", "9000"))
FILTERS = {k.lower(): os.environ[k] for k in ("NIGHTS_MIN", "NIGHTS_MAX", "FROM", "TO", "BOARD") if os.environ.get(k)}
ALERT_URL = os.environ.get("ALERT_URL", "")
STATE = Path(os.environ.get("STATE_FILE", "tours-state.json"))
credits_used = 0


def api(path, **params):
    global credits_used
    query = urllib.parse.urlencode({"lang": "ro", **params})
    req = urllib.request.Request(f"{BASE}{path}?{query}", headers={"Authorization": f"Bearer {KEY}"})
    for attempt in range(3):
        try:
            with urllib.request.urlopen(req, timeout=20) as res:
                body = json.load(res)
                credits_used += body["meta"].get("credits", 0)
                return body["data"]
        except urllib.error.HTTPError as err:
            retry = err.headers.get("Retry-After")
            if err.code in (429, 503) and retry and attempt < 2:
                time.sleep(int(retry))
                continue
            raise SystemExit(f"{path}: {err.code} {err.read().decode()}")


def alert(text):
    print(text)
    if ALERT_URL:
        req = urllib.request.Request(ALERT_URL, json.dumps({"text": text}).encode(), {"Content-Type": "application/json"})
        urllib.request.urlopen(req, timeout=10).close()


def main():
    # the cheapest price per country first: a country whose floor is over budget costs no search
    floors = {c["country"]: c["min_price_pp_mdl"] for c in api("/tours/countries")}
    last = json.loads(STATE.read_text("utf-8")) if STATE.exists() else {}
    now, found = {}, 0
    for country in COUNTRIES:
        if floors.get(country, 0) > BUDGET:
            print(f"{country}: from {floors[country]:.0f} lei, over budget")
            continue
        for t in api("/tours", country=country, sort="price", **FILTERS):
            price = t["price_pp_mdl"]
            if price > BUDGET:
                break  # sorted by price: the rest cost more
            key = str(t["id"])
            now[key] = price
            found += 1
            before = last.get(key)
            if before is None or price < before - 1:
                stars = "*" * (t["stars"] or 0)
                was = f" (was {before:.0f})" if before else ""
                alert(f"{country}, {t['resort']}: {t['hotel']} {stars} {t['board']}, {t['nights']} nights from {t['date_from']}, "
                      f"{price:.0f} lei/person{was}, {t['agency']}: {t['url']}")
    STATE.write_text(json.dumps(now), "utf-8")
    print(f"{found} offers under {BUDGET:.0f} lei, {credits_used} credits")


if __name__ == "__main__":
    main()

Rutele folosite

Datele din ghid

Actualizat:

Întrebări despre acest ghid

Din ce agenții vin ofertele?

Din ofertele publice ale agențiilor de turism din Moldova pe care le citește Satelit. Fiecare ofertă are agenția și linkul spre pagina ei; rezervarea se face la agenție.

Prețul e pe persoană sau pe cameră?

Câmpul price_per spune cum a dat agenția prețul; price_pp_mdl e mereu pe persoană, în lei. Scriptul compară bugetul cu acesta.

Pot căuta doar all inclusive sau doar o perioadă?

Da: BOARD=AI pentru masă, FROM și TO pentru data plecării, NIGHTS_MIN și NIGHTS_MAX pentru nopți.