@gojinko/plugin 1.1.0 → 1.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "jinko",
|
|
3
3
|
"description": "Search flights, book trips, and manage bookings with the Jinko Travel API. Connects to the Jinko MCP server for live flight pricing, trip management, and payment.",
|
|
4
|
-
"version": "1.1.
|
|
4
|
+
"version": "1.1.1",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Jinko",
|
|
7
7
|
"url": "https://gojinko.com"
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "jinko",
|
|
3
3
|
"description": "Search flights, book trips, and manage bookings with the Jinko Travel API. Connects to the Jinko MCP server for live flight pricing, trip management, and payment.",
|
|
4
|
-
"version": "1.1.
|
|
4
|
+
"version": "1.1.1",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Jinko",
|
|
7
7
|
"url": "https://gojinko.com"
|
package/package.json
CHANGED
|
@@ -34,7 +34,7 @@ Two modes (use exactly one):
|
|
|
34
34
|
}
|
|
35
35
|
```
|
|
36
36
|
|
|
37
|
-
**Price-check** (user has an `offer_token` from find_flight):
|
|
37
|
+
**Price-check** (user has an `offer_token` — e.g. from a prior `flight_calendar` or legacy `find_flight` result):
|
|
38
38
|
```json
|
|
39
39
|
{
|
|
40
40
|
"price_check": {
|
package/skills/cli/SKILL.md
CHANGED
|
@@ -32,8 +32,8 @@ Auth alternatives:
|
|
|
32
32
|
| `auth login / logout / status` | Credentials |
|
|
33
33
|
| `find-destination` | Discover destinations from origin(s) — inspiration |
|
|
34
34
|
| `flight-calendar` | Cheapest prices across a date range for a specific route |
|
|
35
|
-
| `
|
|
36
|
-
| `flight
|
|
35
|
+
| `flight-search` | Live pricing — direct search by route + dates, or `--offer-token` price-check (returns bookable `trip_item_token`) |
|
|
36
|
+
| `find-flight` | **Legacy.** Cached route + dates search. Kept for backwards compat; prefer `flight-search` for new work. |
|
|
37
37
|
| `hotel-search` | Live hotel search by city/query/geo/hotel-ids |
|
|
38
38
|
| `trip` | Create / update a trip: add items, remove items, set travelers + contact |
|
|
39
39
|
| `select-ancillaries` | Add baggage / seats / meals to a trip item |
|
|
@@ -9,11 +9,13 @@ You have access to three Jinko MCP tools for flight discovery. Pick the right on
|
|
|
9
9
|
|
|
10
10
|
## Tool Selection
|
|
11
11
|
|
|
12
|
-
| User
|
|
12
|
+
| User intent | Tool to use |
|
|
13
13
|
|-----------|-------------|
|
|
14
|
-
| Nothing — wants inspiration | `find_destination` |
|
|
15
|
-
| Route
|
|
16
|
-
| Route + dates | `
|
|
14
|
+
| Nothing in mind — wants inspiration | `find_destination` |
|
|
15
|
+
| Route known, flexible on dates | `flight_calendar` |
|
|
16
|
+
| Route + dates, wants live pricing + bookable token | `flight_search` (see the `book-trip` skill) |
|
|
17
|
+
|
|
18
|
+
> `find_flight` (cached search by route + dates) still exists for backwards compatibility but is no longer recommended — `flight_search` returns live prices and a `trip_item_token` in a single step.
|
|
17
19
|
|
|
18
20
|
## find_destination
|
|
19
21
|
|
|
@@ -53,27 +55,13 @@ Show cheapest prices across a date range for a specific route. Great for "what's
|
|
|
53
55
|
|
|
54
56
|
**Response:** List of dates with `price`, `offer_token`, `airline`, `stops`. Includes `cheapest` entry.
|
|
55
57
|
|
|
56
|
-
## find_flight
|
|
57
|
-
|
|
58
|
-
Search cached flights by route and dates. Fast results with offer tokens.
|
|
59
|
-
|
|
60
|
-
**Required params:**
|
|
61
|
-
- `origin`: IATA code (e.g. `"CDG"`)
|
|
62
|
-
- `destination`: IATA code (e.g. `"JFK"`)
|
|
63
|
-
- `trip_type`: `"oneway"` or `"roundtrip"`
|
|
64
|
-
|
|
65
|
-
**Optional params:**
|
|
66
|
-
- `departure_dates` or `departure_date_ranges`: when to depart
|
|
67
|
-
- `return_dates` or `return_date_ranges`: when to return (roundtrip)
|
|
68
|
-
- `stay_days` or `stay_days_range`: trip duration
|
|
69
|
-
- `direct_only`, `cabin_class`, `max_price`, `sort_by`, `currency`
|
|
58
|
+
## find_flight (legacy — prefer flight_search)
|
|
70
59
|
|
|
71
|
-
|
|
60
|
+
Cached flight search by route + dates. Still callable for backwards compatibility with older ChatGPT App versions, but not recommended for new integrations. Use `flight_search` (in the `book-trip` skill) for the same inputs plus live pricing + a bookable `trip_item_token` in one step.
|
|
72
61
|
|
|
73
62
|
## Important notes
|
|
74
63
|
|
|
75
64
|
- **Airport codes**: Use 3-letter IATA codes (PAR, NYC, JFK, CDG)
|
|
76
65
|
- **Dates**: YYYY-MM-DD format
|
|
77
|
-
- **Cached vs Live**:
|
|
78
|
-
-
|
|
79
|
-
- All three tools support `format: "json"` for structured output or `format: "text"` for readable summaries
|
|
66
|
+
- **Cached vs Live**: `find_destination` and `flight_calendar` use cached data — great for exploration. For live pricing + a bookable token, use `flight_search` (see the `book-trip` skill).
|
|
67
|
+
- Both tools support `format: "json"` for structured output or `format: "text"` for readable summaries
|