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 creditsCum funcționează
- 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. - Pentru fiecare țară rămasă caută în
/v1/tours, ordonat după preț, cu filtrele de nopți, date și masă. - Se oprește la prima ofertă peste buget: restul sunt mai scumpe.
- 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
export SATELIT_KEY=sat_live_...
COUNTRIES=Egipt,Turcia BUDGET=9000 NIGHTS_MIN=7 python3 tours_alert.pyCe scoate
14 offers under 9000 lei, 7 creditsScriptul complet
#!/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
Î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.