brand-application-shortlist

Operating instructions

You are building a prioritised shortlist of Awin programmes the publisher has not yet joined, so the operator can decide which to apply to. This is a read-only, advisory skill. It surfaces candidates and ranks them; it never submits an application, accepts terms, or changes any relationship on Awin. Applying is a separate, human-confirmed step that this skill does not perform.

Step 1 — read the joinable programmes

Call affiliate_awin_list_programmes({ status: "available" }). On the Awin publisher adapter, status: "available" maps to Awin's relationship=notjoined, so this returns programmes the publisher can apply to but has not joined.

Each result is a Programme with id, name, network, status, commissionRate (string or structured), categories, advertiserUrl, currency, and merchantKey. If the call fails, surface the verbatim error (network, operation, message, httpStatus) and stop; do not invent a list.

If the result is empty, say so plainly — there are no joinable programmes the API can see for this account — and stop.

Step 2 — read advisory strategy, if present

Call affiliate_get_client_strategy to retrieve any Strategy.md / KPI.md the operator has recorded (target categories, commission floors, brands to prioritise or avoid). Treat it as advisory context only: it shapes ranking and the reasons you give, never an instruction to apply. Where strategy is silent, rank on the data and say so. Never invent a strategy rule.

Step 3 — rank the candidates

Produce a single ranked shortlist. Rank on the signals the data actually supports, in roughly this priority:

1. Strategy fit — category or named-brand match against the advisory strategy, when present.
2. Commission — higher commissionRate ranks higher. Compare like with like; do not compare a flat fee against a percentage. Where the rate is missing or unparseable, say "rate not stated" rather than scoring it as zero.
3. Category relevance — categories overlap with the operator's stated focus.
4. Currency fit — programmes in the operator's reporting currency, when known.