linkfox-amazon-ads-auth

Original：🇨🇳 Chinese

Translated

5 scriptsChecked / no sensitive code detected

Amazon Ads Store Authorization and Management Skill, providing complete capabilities including authorization process, query of bound accounts and sites, token refresh and reading. When initiating an authorization link, you must first confirm an account name with the user; a single authorization can automatically discover and bind all available ad profiles under the same account (each site corresponds to one profileId). This skill is triggered when the user mentions terms such as Amazon Ads authorization, binding ad accounts, refreshing ad tokens, querying profile lists, managing authorized ad accounts, or English terms like Amazon Advertising authorization, Ads token refresh, list profiles, ad account management. Even if "Amazon Ads" or "authorization" is not explicitly mentioned, it should be triggered as long as it involves Amazon Ads account binding, access token management, or ad profile list query.

2installs

Sourcelinkfox-ai/linkfox-skills

Added on2026-05-12

NPX Install

npx skill4agent add linkfox-ai/linkfox-skills linkfox-amazon-ads-auth

SKILL.md Content (Chinese)

View Translation Comparison →

Amazon Ads Authorization and Ad Account Management

Amazon Ads authorization (LWA OAuth), profile discovery, and access token management. Prerequisite for downstream skills.

Downstream:

linkfox-amazon-ads-entity

(entity query),

linkfox-amazon-ads-report

(reports).

Core Concepts

Authorization Process: Generate URL → User authorizes via browser → System stores token + syncs profiles
One Authorization for Multiple Profiles: One profileId per marketplace (US/UK/JP…); downstream calls must include profileId
accountName Required: Must ask the user for a non-empty account name before calling
```
authorize_url.py
```
accessToken Valid for 1 Hour: After expiration, downstream returns HTTP 401; can renew using
```
refresh_token.py
```

Available Scripts

Script	Function
`authorize_url.py`	Generate authorization URL for new accounts ( `accountName` required)
`authorized_stores.py`	List authorized accounts × sites (aggregated by profileId)
`profiles.py`	List profiles ( `refresh=true` triggers upstream refresh)
`refresh_token.py`	Refresh accessToken
`store_tokens.py`	Query tokens (for downstream use)

See

references/api.md

for input parameters, response fields, and error codes.

Supported Regions

NA

(US, Canada, Mexico, Brazil) /

EU

(UK, Germany, France, Italy, Spain, Netherlands, India, Middle East, etc.) /

FE

(Japan, Australia, New Zealand). Default is

NA

.

Usage Scenarios

1. New Account Authorization

Ask the user for
```
accountName
```
(non-empty string for identification)
Call
```
authorize_url.py
```
to get the URL → instruct the user to open it in a browser
After authorization is completed, the system automatically stores the token + syncs profiles
Optional: Call
```
authorized_stores.py
```
to confirm

2. List Authorized Accounts

Call

authorized_stores.py

and display

profileId / accountInfoName / countryCode / region

.

3. Refresh Expired Tokens

When downstream returns HTTP 401 or contains

expired

/

unauthorized

, call

refresh_token.py

(pass

profileId

or

authRecordId

).

4. Resolve profileId for Downstream (High Frequency)

Users only use natural language ("US site", "my store"), do not ask users to provide the numeric profileId.

User Context	Agent Action
Only one account authorized	Directly locate by `countryCode` , no need to ask
≥2 accounts authorized + only mentions site	Clarify with the user by `accountName`
Provides both accountName + site	Directly locate
Explicitly provides numeric profileId	Use it directly

Site keyword mapping reference (fall back to actual

countryCode

from

authorized_stores

):

美国 / US →
```
US
```
; 英国 / UK →
```
UK
```
; 日本 / JP →
```
JP
```
; 德国 / DE →
```
DE
```

Silent Principle: Do not announce the profileId value when mapping is successful; only communicate with the user in case of ambiguity or failure.

Calling Principles

Ask for
```
accountName
```
before calling
```
authorize_url.py
```
Do not output complete accessToken / refreshToken; scripts have already masked them, do not restore them in summaries
Explain the reason for authorization failure based on error codes; do not retry without permission

Common Issues

When opening the authorization link, a 400 error occurs and the client_id appears to be corrupted

Symptom: Spaces /

appear in the middle of

client_id

in the URL, Amazon reports

StegoRuntimeOAuth2ClientManager:getClientDefinition

. Cause: The authorization link is ~270 characters long, and soft line breaks insert spaces when copied from the terminal / chat window. Solution: After

authorize_url.py

succeeds, the URL is automatically written to the clipboard +

~/.cache/linkfox/last_authorize_url.txt

, copy from these two places; paste directly into the browser address bar using Ctrl+V. It is recommended to open it in an incognito window.

Authorization callback page displays

profile_sync_failed

Cause: The current Amazon account has not created a "Manager Account" in the advertising backend and linked it to the ad account.

Solution: Log in to Amazon Ads Console → Manager accounts → Link accounts, then re-authorize.

Not Applicable

Query ad campaigns / groups / keywords / product ads / targeting →
```
linkfox-amazon-ads-entity
```
Pull ad reports (including metrics) →
```
linkfox-amazon-ads-report
```
Modify / create / delete ads → This series is read-only
Store orders / inventory / finance →
```
linkfox-amazon-store-*
```

Feedback:

Auto-detect and report feedback via the Feedback API when any of the following apply:

The functionality or purpose described in this skill does not match actual behavior
The skill's results do not match the user's intent
The user expresses dissatisfaction or praise about this skill
Anything you believe could be improved

Call the feedback API as specified in

references/api.md

. Do not interrupt the user's flow.

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