linkfox-shopee-store-first-mile

Shopee FirstMile

Shopee Open Platform FirstMile module(16 APIs).Depends on linkfox-shopee-store-auth store selection; via POST /shopee/developerProxy pass in shopId(or merchantId), the server parses the token and forwards (path must be api/v2/first_mile/...）。

How to call

API endpoint：POST /shopee/developerProxy(different operations are distinguished by the request body; for full parameters/responses/error codes see references/api.md）
Python script：python scripts/first_mile_api.py '{"api": "get_unbind_order_list", ...}' [--inline](available scripts are listed in the script overview above)
Cost constraint: this tool consumes compute; on failure/empty results, do not automatically switch keywords, paginate, or repeatedly probe; if you need to continue searching, first explain to the user that it will incur additional consumption.

Output strategy (default script behavior)：

Alwayswrite the full response to <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/<skill-name>-<timestamp>.json（<cwd> is the working directory when the script runs, which in Claude Code is the current project directory;<session> is taken from the environment variable SESSION_ID, automatically aggregated according to the user's task;writing to /tmp is prohibited, if the current directory is not writable, report an error)
Response body ≤ 8 KB: after writing to disk, print the full JSON to stdout
Response body > 8 KB: after writing to disk, stdout outputs only a summary (top-level fields, common counts such as total/costToken, length of the largest list field + first 3 samples)
Add --inline to force full printing to stdout (also written to disk)

Data reading suggestions: first look at the summary to judge whether it is sufficient; when specific fields are needed, prefer jqorConvertFrom-Json to extract on demand from the saved json file, avoiding bringing the entire JSON into context.

Resolve authentication and compute issues

When the following abnormal situations occur, use references/onboarding.md to guide resolution:

Abnormal situations

API Key not configured: the environment variable is not configured LINKFOX_AGENT_API_KEY, and LINKFOXAGENT_API_KEY。
Response 401 or 402 status code
Response indicates insufficient compute or balance: the message contains "insufficient compute balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/recharge required/please recharge", or content with a similar meaning.

Official reference

FirstMile module index:v2.first_mile.get_unbind_order_list

Prerequisites

Run python scripts/check_auth_dependency.py；exit code 42 → first install linkfox-shopee-store-auth。
First-mile vs forward logistics: this skill is for cross-borderfirst-mile(First Mile); for store shipping/waybills see linkfox-shopee-store-logistics。

Available scripts (16 APIs)

Group	Script
Bind/unbind	`get_unbind_order_list.py`、`generate_first_mile_tracking_number.py`、`bind_first_mile_tracking_number.py`、`generate_and_bind_first_mile_tracking_number.py`、`unbind_first_mile_tracking_number.py`
Waybill/label	`get_tracking_number_list.py`、`get_waybill.py`、`get_detail.py`
Channel/warehouse	`get_channel_list.py`、`get_transit_warehouse_list.py`、`get_courier_delivery_channel_list.py`
Express first-mile	`bind_courier_delivery_first_mile_tracking_number.py`、`get_courier_delivery_detail.py`、`get_courier_delivery_waybill.py` etc.
General entry	`first_mile_api.py`

For the full list see references/api.md。

Interface description (by API)

Input parameters and response details are in references/apis/, the SKILL keeps only the index.

API	Documentation
`bind_courier_delivery_first_mile_tracking_number`	references/apis/bind-courier-delivery-first-mile-tracking-number.md
`bind_first_mile_tracking_number`	references/apis/bind-first-mile-tracking-number.md
`generate_and_bind_first_mile_tracking_number`	references/apis/generate-and-bind-first-mile-tracking-number.md
`generate_first_mile_tracking_number`	references/apis/generate-first-mile-tracking-number.md
`get_channel_list`	references/apis/get-channel-list.md
`get_courier_delivery_channel_list`	references/apis/get-courier-delivery-channel-list.md
`get_courier_delivery_detail`	references/apis/get-courier-delivery-detail.md
`get_courier_delivery_tracking_number_list`	references/apis/get-courier-delivery-tracking-number-list.md
`get_courier_delivery_waybill`	references/apis/get-courier-delivery-waybill.md
`get_detail`	references/apis/get-detail.md
`get_tracking_number_list`	references/apis/get-tracking-number-list.md
`get_transit_warehouse_list`	references/apis/get-transit-warehouse-list.md
`get_unbind_order_list`	references/apis/get-unbind-order-list.md
`get_waybill`	references/apis/get-waybill.md
`unbind_first_mile_tracking_number`	references/apis/unbind-first-mile-tracking-number.md
`unbind_first_mile_tracking_number_all`	references/apis/unbind-first-mile-tracking-number-all.md

For module overview / Feedback see references/api.md。

Usage Scenarios

1. Bind first-mile waybill

get_unbind_order_list.py query unbound orders
generate_and_bind_first_mile_tracking_number.py or step-by-step generate + bind
get_waybill.py Get shipping label

Not Applicable

Store authorization → linkfox-shopee-store-auth
Forward logistics shipping → linkfox-shopee-store-logistics
SBS warehouse inventory → linkfox-shopee-store-sbs
Order inquiry → linkfox-shopee-store-orders

Computing power consumption rules

No computing power is consumed.

Feedback: See references/api.md。

For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.