Developer

Язык: Русский
Оформление

Тема

Цвет акцента

Тема и цвет сохранятся на satelit.md и в приложении.

Войти

Где сменить тему?

Выберите, где применить новую тему.

Изменить можно в любой момент в шапке.

Гайд · Python 3.9+

Туры по вашему бюджету

Вы задаёте страны, бюджет на человека в леях и число ночей. Трижды в день скрипт ищет в предложениях турагентств Молдовы и сообщает только о новых или подешевевших.

Работает на
Python 3.9+
Один запуск
7 кредитов
В месяц
630 кредитов
Настройка
10 мин
$ COUNTRIES=Egipt,Turcia BUDGET=9000 NIGHTS_MIN=7 python3 tours_alert.py14 offers under 9000 lei, 7 credits

Как это работает

  1. Читает минимальную цену на человека по каждой стране из /v1/tours/countries. Страна дороже бюджета не стоит поиска.
  2. По каждой оставшейся стране ищет в /v1/tours по возрастанию цены, с фильтрами ночей, дат и питания.
  3. Останавливается на первом предложении дороже бюджета: остальные дороже.
  4. Сравнивает с прошлым запуском из tours-state.json и сообщает только о новых или подешевевших предложениях.

Сколько стоит: 1 кредит за страны, 3 за каждый поиск: 7 кредитов для двух стран. Трижды в день: 630 кредитов в месяц. Укладывается в план Start.

Как запустить

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

Что выводит

stdout
14 offers under 9000 lei, 7 credits

Полный скрипт

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()

Используемые маршруты

Данные в гайде

Обновлено:

Вопросы об этом гайде

Из каких агентств предложения?

Из публичных предложений турагентств Молдовы, которые читает Satelit. У каждого предложения есть агентство и ссылка на его страницу; бронирование у агентства.

Цена за человека или за номер?

Поле price_per говорит, как агентство дало цену; price_pp_mdl всегда за человека, в леях. Скрипт сравнивает бюджет с ним.

Можно искать только all inclusive или только даты?

Да: BOARD=AI для питания, FROM и TO для даты вылета, NIGHTS_MIN и NIGHTS_MAX для ночей.