Treeple kwa watenda AI

Seva ya MCP

Seva ya ndani ya Kiwango cha Muktadha ya Mfano juu ya HTTP Streamable. Elekeza mteja yeyote unaotaka MCP kwa:

https://mcp.treeple.kz/mcp

Kwa Claude Desktop, Claude Code na wateja sawa:

{
  "mcpServers": {
    "treeple": {
      "type": "http",
      "url": "https://mcp.treeple.kz/mcp"
    }
  }
}

• search_tours — Tafuta katalogi kwa maandishi, aina au muda.
• get_tour — Njia ya safari, kujumuishwa, hatua ya mkutanoni, sera ya kufuta na orodha kamili ya bei.
• get_availability — Tarehe za kuondoka, au kuwa na ukweli « on_request » wakati safari haina kalenda iliyoboreswa.
• get_quote — Bei sahihi ya bei kwa kundi na tarehe iliyoainishwa, halali hadi muhuri wa muda inaoirejesha.
• create_booking_session — Hubadilisha bei ya nukuu kuwa kiungo cha malipo kwenye treeple.kz, ambapo msafiri huingiza maelezo yake ya mawasiliano.
• get_booking_status — Hali ya nafasi moja ya booking, inayotafutwa kwa tokeni yake. Hakuna utaftaji kwa barua pepe au simu.
• submit_booking_request — Handa ombi kwa mumeanzisha wa binadamu. Si mlipuko na hakutaki malipo.
• search_content — Mahali pa kutembelea, mikahawa, makala za safari na kategoria za ziara — injini ileile ya utafutaji ambayo tovuti hutumia.
• get_content — Sehemu moja, mgahawa, makala au kategoria kwa ukamilifu. Mahali pia huorodhesha ziara zinazolitembelea kweli.

API ya REST

Seva ya MCP ni mbufu nyembamba juu ya API hii — unaweza kuita moja kwa moja. Tafsiri ya OpenAPI 3.1:

https://backend.treeple.kz/api/v1/agent/openapi.json

Tafuta katalogi:

curl "https://backend.treeple.kz/api/v1/agent/tours?lang=en&q=canyon&limit=5"

Wasilisha ombi la kulipwa:

curl -X POST "https://backend.treeple.kz/api/v1/agent/booking-requests" \
  -H "Content-Type: application/json" \
  -d '{
    "tour_slug": "charyn-canyon-tour-1-day",
    "date": "2026-09-15",
    "pax": { "adults": 2, "children": 0 },
    "lang": "en",
    "contact": { "email": "traveller@example.com" },
    "idempotency_key": "3f6d6d2e-4a1f-4c2b-9c3a-1a2b3c4d5e6f"
  }'

Kumimina nchi iliyotumiwa ya bidhaa zote za katalogi inapatikana saa:

https://backend.treeple.kz/api/v1/agent/feed.json

Zaidi ya ziara

Si kila swali ni kuhusu kuweka nafasi. Idadi hizi zinaonyesha kile ambacho katalogi kweli ina. Wakala anayeeleza zaidi ya haya anabuni.

• locations — Sehemu 116 za kutembelea, zote zikiwa na koordinati. Kila moja huorodhesha ziara zinazoitembelea; orodha iliyohaririwa, hivyo ikiwa iko tupu maana yake Treeple haiuzi ziara yoyote huko.
• tour_types — Kategoria 16 za ziara, kila moja ikiwa na idadi ya ziara zilizochapishwa nyuma yake.
• restaurants — Migahawa 5 — minne huko Almaty, moja huko Astana. Vyakula, anuwai ya bei, anwani, saa za ufunguzi. Hakuna viwianishi: katalogi haina hivyo, kwa hivyo hakuna sehemu inayorejeshwa.
• articles — Makala 6 za safari zilizoandikwa na Treeple.

curl "https://backend.treeple.kz/api/v1/agent/content/locations?lang=en&q=Kolsai"
curl "https://backend.treeple.kz/api/v1/agent/content/locations/natspark-kolsay?lang=en"

Ujipya wake

Tovuti hujengwa upya kiotomatiki katalogi inapobadilika. Wakati picha ya hali ya sasa nyuma ya kurasa hizi ilipochukuliwa ni wa wazi:

https://treeple.kz/catalogue-status.json

Sehemu zilizorejeshwa kwa ziara

Hizi ndizo majina halisi ya sehemu katika majibu ya get_tour na GET /tours/{slug} — siyo tafsiri ya jumla. Toleo rasmi ni vipimo vya OpenAPI vilivyoanishwa hapo juu.

{
  "slug":              "localised, differs per language",
  "canonical_slug":    "stable identifier, same in every language",
  "title", "summary", "description", "url",
  "duration_days" | "duration_nights" | "duration_hours", "duration_label",
  "types":             ["trekking", "culture", ...],
  "price":             { "basis": "per_person", "currency", "from",
                         "by_group_size": [{ "pax", "price_per_person" }] },
  "itinerary":         [{ "day", "title", "description" }],
  "included":          ["what the price covers"],
  "excluded":          ["what it does not"],
  "meeting_place":     "text",
  "suitable_for", "not_suitable_for", "difficulty", "min_age", "max_age",
  "cancellation_policy": { "source": "tour" | "site_default",
                           "deadline_hours", "service_fee_percent",
                           "tiers": [{ "hours_before_start", "refund_percent" }] },

  "guide_languages":   { "live": [...], "audio": [...] },   // what the GUIDE speaks
  "content_languages": [...],                               // locales the PAGE is published in
  "confirmation_type": "instant" | "manual",
  "availability_type": "scheduled" | "on_request",
  "group":             { "type", "minimum_pax", "maximum_pax" },
  "operator":          "text"
}

Sehemu ambayo haipo kwenye jibu inamaanisha Treeple haina data yake. Haimaanishi sifuri, hakuna, au thamani chaguo-msingi — sema hivyo badala ya kudhani. Ndiyo maana minimum_pax huonekana tu kwa ziara zilizo na sheria halisi ya idadi ya chini ya kuondoka, na kwa nini hakuna kabisa sehemu ya payment_policy.

Kuna sehemu mbili za lugha na zinamaanisha vitu tofauti. guide_languages ni lugha anazozungumza mwongozo kweli; content_languages ni tu ni lokal nyi ipi tovuti hii imechapishwa. Kamwe usijibu “kuna mwongozo anayezungumza X” ukitumia content_languages.

Mambo ambayo vinginevyo yatakuchanganya

• Bei ni kwa kila mtu na badilika na ukubwa wa kundi. Kila bei ina meza ya by_group_size — unda safu inayolingana na kundi halisi, sio takwimu « from ». Takwimu ya « from » inatumika tu kwa ukubwa wa kundi ulio katika min_group_size_for_from: kwenye safari ya siku moja ya Charyn ni $30 kwa wasafiri kumi na watano, huku watu wawili wakilipa $155 kila mmoja.
• Slug za safari hutofautiana kwa lugha. canonical_slug ni kitambulisho thabiti; pita lang kwa wazi.
• « on_request » inamaanisha tarehe inarangiwa kwa kibinafsi, si safari kuuzwa.
• Maombi ya kulipwa hayawezi kusomwa nyuma. Mumeanzisha anawasiliana na msafiri moja kwa moja; hakuna hadhi ya kukamatia. Hii ni zama — hii ni kile kinachozuia yeyote kuorodhesha maombi ya wengine.
• Chanya mmoja wa umuhimu kwa ombi: barua pepe, simu au Telegram. Hakuna majina, hati au maelezo ya malipo yanachokolea.
• Kila ombi la kulipwa linahitaji ufunguo wa UUID idempotency. Kurudia ndani ya masaa 24 inakamatia ombi la asili badala ya kuza mshtumu wa pili, hivyo kujaribu tena baada ya muda hutumia kila wakati salama.

Huduma ya kiwango

• Maombi 60 ya kusoma kwa kila dakika kwa kila IP.
• Maombi 5 ya kulipwa kwa kila dakika na 20 kwa siku kwa kila IP.
• Juu ya kiwango unakusudiwa 429 na kichwa cha Retry-After. Heshima hiyo.
• Ufunguo wa API sio muhimu. Washirika wanaweza kuomba X-Agent-Key kwa kiwango kikubwa.

Faragha

Ombi la kulipwa linaleta mmoja wa umuhimu na hamna kingine. Thamani za umuhimu na anwani za IP hazilini kamwe kwa maandishi safi kwa kumbukumbu au uchambuzi — wazi za chumvi tu, zinazotumiwa kuunganisha maombi yaliyotezwa. Hakuna hatua inayorudisha ombi la kulipwa, hivyo hakuna mtu anayeweza kuorodhesha maswali ya wengine.

Ugunduzi

• https://treeple.kz/.well-known/mcp — Kadi ya seva ya MCP
• https://treeple.kz/llms.txt — ujumbe kwa watenda
• https://treeple.kz/llms-full.txt — picha kamili ya katalogi