Claude FBA talks to Amazon through your own private SP-API app — no third-party service ever sees your data, and credentials never leave your machine. Creating the app is free, needs no approval beyond your own seller account, and takes about 30 minutes once.
python3 scripts/sp_api.py # the verify step, once keys are inEverything happens inside your own Seller Central — the same place you already log into. Nothing here is granted to anyone but you.
Seller Central → Apps & Services → Develop Apps. First time, Amazon asks for a Developer Profile: choose Private developer (you're building for your own business), answer the data-use questionnaire honestly, submit.
*The one waitProfiles are usually approved instantly or within a day or two. If yours goes to review, everything below waits on it — do this step first, today.
Develop Apps → Add new app client. Name it anything (claude-fba works),
API type SP-API, and check these roles:
read + patch listings, A+ read
orders + review solicitations
price data
account / marketplace info
search query performance
Save. The app shows as Draft — that's fine; self-authorization works from draft.
App row → View under LWA credentials. Copy the Client ID
(amzn1.application-oa2-client.…) and Client Secret.
SecurityThese give API access to your store. Never commit them, never paste them into websites or chats. Claude FBA keeps them in a gitignored local file only.
App row → Authorize → confirm. Amazon shows a Refresh Token
starting with Atzr| — copy it immediately. This token lets the toolkit act as
you, on your store only. No third-party OAuth, because there
are no third parties.
cp scripts/config.example.env scripts/config.envFill in the three values from steps 03–04: LWA_CLIENT_ID,
LWA_CLIENT_SECRET, SP_REFRESH_TOKEN.
python3 scripts/sp_api.pyExchanges your token and probes all three regions, printing every marketplace you sell in.
Copy its output into config.env (SP_REGION, MARKETPLACE_ID)
and you're done — every skill and script works from here.
Every setup problem we've seen maps to one of these.