Nastavení eBay API pro AI agenta na tvorbu inzerátů

AI agent, který vystavuje moje věci na eBay, umí seskupit moje fotky, rozpoznat předmět, určit cenu podle srovnatelných nabídek, které mu dodám, a sestavit inzerát. Vlastní vývojářský účet na eBay si ale založit neumí. Na to eBay vyžaduje člověka, stejně jako na několik dalších obrazovek, které následují.

Proto tento návod k nastavení eBay API rozděluje práci na dvě části. Ty projdeš šest stránek eBay a vložíš tři hodnoty do jednoho souboru na vlastním disku. Tvůj agent zařídí zbytek z terminálu: stránku se zásadami ochrany osobních údajů, odkaz k udělení souhlasu, výměnu kódu za token a kontrolu pravidel. Nadpis každého kroku říká, kdo je na řadě: Ty, nebo Ty a tvůj agent. Uvnitř kroku je běžný pokyn určený tobě. Řádek začínající slovy “Požádej svého agenta” znamená, že je řada na něm, a ty můžeš sledovat, jak po obrazovce běží JSON.

Kdo co dělá při nastavování eBay API

Krok	Ty	Tvůj agent
Než začneš	Připravíš si účet prodejce, účet na GitHubu a AI agenta na programování. Odpovíš na otázky k převzetí nástroje	Zkopíruje kód do soukromé složky, nainstaluje ho a spustí testy
1. Vývojářský účet	Zaregistruješ se a počkáš na schválení	—
2. Sada klíčů Production (produkční prostředí)	Vytvoříš ji	—
3. Odemknutí sady klíčů	Vyplníš formulář eBay týkající se mazání účtů	—
4. Stránka se zásadami ochrany osobních údajů	Dodáš název, kontakt a používanou AI službu	Vyplní šablonu a zveřejní Gist
5. RuName (název přesměrování)	Vyplníš jeden formulář	—
6. Soubor .env	Vložíš tři hodnoty	Vytvoří soubor a nastaví Production
7. Souhlas	Udělíš souhlas na eBay a zkopíruješ jednu adresu	Sestaví odkaz a vymění kód za token
8. Obchodní pravidla	Vytvoříš pravidla dopravy, platby a vrácení zboží	Zkontroluje je a zapne ti jejich používání, pokud řekneš ano
9. account.json	Rozhodneš tam, kde to sám nedokáže, a schválíš nové umístění	Zapíše soubor, použije tvoje odpovědi k převzetí nástroje a provede pět kontrol

Obnovovací token z kroku 7 si představ jako klíč od auta a automatizovaný postup jako obsluhu parkoviště s příručkou pravidel. Obsluha auto zaparkuje: tvůj agent sestaví nezveřejněnou nabídku, kterou kupující nevidí. Z parkoviště nevyjede, dokud nekývneš, protože zveřejnění vyžaduje tvoje výslovné ano. Jeden háček je potřeba přiznat. Samotný klíč umožňuje víc, než dovoluje příručka, a proto patří do .env na tvém disku a nikdy do chatu.

Růžová čísla na snímku obrazovky odpovídají číslům kroků pod ním. Názvy prvků odpovídají obrazovkám eBay v listopadu 2026. eBay je občas přejmenovává, takže pokud se nějaký název liší, řiď se odkazovanou stránkou eBay.

Všechno tady vychází z ebay-listing-agent, automatizovaného postupu pro tvorbu inzerátů, který používám na vlastním účtu prodejce. Tvůj agent potřebuje repozitář ještě před krokem 1, tak si odkaz vezmi hned.

Proč při tomto nastavení eBay API jdeme rovnou do Production

eBay nabízí Sandbox (testovací prostředí), tržiště nanečisto pro testování. Vlastní návod repozitáře začíná tam. Tenhle ne. Tvoje inzeráty patří do Production a testovací uživatel v Sandboxu začíná bez obchodních pravidel i bez umístění zásob. Vytvářet je v Sandboxu je odbočka navíc. Tvůj agent se proto od začátku připojí k tvému skutečnému účtu prodejce a ochranu zajistí pojistky automatizovaného postupu:

• Pracovní postup Lister končí u nezveřejněné nabídky. Kupující ji nevidí.
• publish bez --confirm vypíše souhrn a odmítne pokračovat. Tvůj agent ti souhrn ukáže a počká na tvoje ano.
• Dva příkazy, které mění tvůj účet prodejce, setup --opt-in a setup --create-location, také odmítnou pokračovat bez --confirm.
• Nechtěnou nezveřejněnou nabídku může tvůj agent odstranit pomocí delete-offer. Příkaz odmítne cokoli, co už bylo zveřejněno.

⚠️ Varování: Toto nastavení připojí tvého agenta k tvému skutečnému účtu prodejce. Cert ID (identifikátor certifikátu) a obnovovací token uchovávej pouze v .env. Nevkládej je do chatu. Nezahrnuj .env do commitu v gitu.

Než začneš

Ty si připravíš:

• Účet prodejce na eBay bez omezení, s nastavenými platbami. Sem budou patřit tvoje inzeráty.
• Americké tržiště (EBAY_US). Ostatní tržiště nejsou otestovaná.
• Účet na GitHubu. Tvůj agent tam v kroku 4 zveřejní jednu malou stránku.
• AI agenta na programování, který umí spouštět příkazy v terminálu, například Claude Code, Cursor nebo Codex CLI.

Tvůj agent udělá:

• Naklonuje repozitář a zkopíruje core/ do nové soukromé složky. Vytvoří kopii, ne fork: fork veřejného repozitáře je na GitHubu veřejný a tvoje složky s inzeráty budou obsahovat identifikátory nabídek.
• Nainstaluje Python 3.10+, ImageMagick 7 a GitHub CLI (gh), pokud chybějí, potom balíčky Pythonu a nakonec spustí testy.
• Projde s tebou ADOPTION-QUESTIONS.md: cenový limit pro kontrolu, míru jistoty, kterou potřebuje před vystavením, a pravidla, která má používat. Tvoje odpovědi si zapíše a použije je v kroku 9. Odpovědi ohledně dopravy a vrácení zboží určují, co vytvoříš v kroku 8.

Zadání, které můžeš vložit:

Přečti si ADOPTION-GUIDE.md v github.com/matbanik/ebay-listing-agent. Proveď se mnou kroky 1 až 3. Nastavujeme eBay v Production, ne v Sandboxu. Zastav se před přístupem k eBay API.

Řekni takhle výslovně “Production”. Návod repozitáře doporučuje nejdřív Sandbox a svědomitý agent se repozitářem řídí.

1. Ty: přihlas se do programu eBay Developers Program

Tvůj účet prodejce nemůže volat API. eBay provozuje svůj vývojářský program jako samostatnou budovu s vlastním vchodem, takže potřebuješ druhý účet. Může používat stejnou e-mailovou adresu jako tvůj účet prodejce. Pořád je to ale jiné přihlášení.

1. Otevři registrační stránku programu eBay Developers Program.
2. Vyplň formulář. Tam, kde to formulář požaduje, zadej e-mailovou adresu podruhé.
3. Přijmi API License Agreement (licenční smlouvu k API). Dokonči ověření, že nejsi robot. Vyber Join (Zaregistrovat se).
4. Počkej na schválení. Schválení může trvat přibližně jeden pracovní den. Před schválením nemůžeš vytvářet klíče.

eBay může chtít firemní e-mailovou adresu. Pokud ji máš, zadej ji.

2. Ty: vytvoř si sadu klíčů eBay pro Production

Sada klíčů je průkaz tvojí aplikace: tři hodnoty, které eBay říkají, která aplikace klepe na dveře. Potřebuješ tu pro Production.

1. Na vývojářském webu otevři Application Keys (Klíče aplikace).
2. V části Production vytvoř sadu klíčů. Aplikaci dej libovolný název, například “my-ebay-lister”.
3. Zkontroluj, že sekce Production zobrazuje App ID (Client ID) (identifikátor aplikace neboli klienta), Dev ID (identifikátor vývojáře) a Cert ID (Client Secret) (identifikátor certifikátu neboli tajný klíč klienta).
4. Nech tuhle stránku otevřenou. Budeš ji znovu potřebovat v krocích 3, 5 a 6.

App ID identifikuje tvoji aplikaci. Cert ID je její heslo, tak s ním podle toho zacházej. Dev ID se nepoužívá. Dva orámované odkazy pod App ID, User Tokens (Uživatelské tokeny) a Notifications (Oznámení), jsou vstupem ke krokům 5 a 3. U nové sady klíčů Production se také zobrazuje “Your Keyset is currently disabled.” (Tvoje sada klíčů je momentálně zakázaná.) To je normální. Krok 3 ji odemkne.

3. Ty: odemkni sadu klíčů Production

eBay nezapne sadu klíčů Production, dokud neodpovíš na jednu otázku: jak se tvoje aplikace dozví, že uživatel eBay zrušil svůj účet? Aplikace, které ukládají údaje uživatelů eBay, musí přijímat tato oznámení o smazání. Aplikace, které je neukládají, mohou požádat o výjimku. Formulář najdeš za odkazem Notifications pod svým App ID pro Production. Můžeš také přímo otevřít stránku oznámení pro Production.

⚠️ Upozornění: Vyber jen takový důvod výjimky, který pro tebe platí. Pokud pro tvoji aplikaci žádný důvod neplatí, o výjimku nežádej. Použij cestu s koncovým bodem popsanou na konci tohoto kroku. Pokud se po přepnutí zobrazí potvrzovací okno, přečti si ho. Confirm (Potvrdit) vyber jen tehdy, pokud pro tebe uvedené prohlášení platí. Formulář uvádí: “Failure to provide correct information may result in penalties or having your account disabled.” (Poskytnutí nesprávných informací může vést k postihům nebo zablokování tvého účtu.)

1. Vyber Marketplace Account Deletion (Smazání účtu na tržišti).
2. Zapni přepínač Exempted from Marketplace Account Deletion (Výjimka z oznámení o smazání účtu na tržišti).
3. Vyber Exemption reason (Důvod výjimky), který pro tebe platí. V části Additional information (Další informace) popiš, co ukládáš.
4. Vyber Submit (Odeslat).
5. Znovu otevři Application Keys. U sady klíčů Production zkontroluj, zda se zobrazuje zpráva “Your Keyset is currently disabled.”
6. Je tam zpráva pořád? Zastav se. Než zmizí, pokračuj stránkou se zásadami ochrany osobních údajů v kroku 4. Souhlas v kroku 7 nezačínej udělovat, dokud zpráva nezmizí.

O tomhle rozhoduješ. Automatizovaný postup běží jen na tvém vlastním účtu prodejce. Nikdy nepřihlašuje jiné uživatele eBay a neuchovává žádné údaje kupujících. Na tvém disku ale uchovává soubory o tvých vlastních inzerátech: názvy, ceny, identifikátory nabídek a identifikátory inzerátů. Formulace eBay “any eBay data,” (jakákoli data eBay) neříká, zda se to počítá. Tohle za tebe nemůžu rozhodnout já ani tvůj agent.

Pokud žádný důvod neodpovídá nebo eBay výjimku zamítne, druhou možností je přihlásit k odběru koncový bod HTTPS, který odpovídá na oznámení eBay. Repozitář žádný neobsahuje, takže si ho musíš hostovat sám a souhlas v kroku 7 počká, dokud nebude fungovat. Vysvětluje to návod eBay ke smazání účtu. Někteří vývojáři na fóru eBay hlásí, že jejich sady klíčů zůstaly po podání žádosti ve stavu “Non Compliant” (Nesplňuje požadavky), takže než půjdeš dál, sadu klíčů zkontroluj.

4. Ty a tvůj agent: zveřejnění stránky se zásadami ochrany osobních údajů

Bez adresy URL zásad ochrany osobních údajů ti eBay v kroku 5 nevytvoří RuName. Sepsat je zní jako domácí úkol. Většinu práce ale udělá tvůj agent, protože repozitář obsahuje šablonu.

1. Dej svému agentovi název aplikace, svoje jméno nebo firmu, veřejný kontakt a AI službu, kterou používáš.
2. Požádej svého agenta, aby vyplnil PRIVACY-TEMPLATE.md. Výsledek uloží jako privacy-policy.md.
3. Požádej svého agenta, aby zveřejnil privacy-policy.md jako veřejný GitHub Gist.
4. Chce gh přihlášení? Sám spusť gh auth login. Řiď se jeho pokyny.
5. Přečti si stránku, kterou tvůj agent zveřejní. Zkontroluj jméno a kontakt.
6. Poznamenej si odkaz na Gist. V kroku 5 ho vložíš do formuláře RuName.

Zadání, které můžeš vložit:

Vyplň PRIVACY-TEMPLATE.md pro “My eBay Lister”. Vlastník: [tvoje jméno nebo firma]. Kontakt: [e-mail nebo stránka, kterou zveřejníš]. AI služba: [ta, kterou používáš]. Ulož výsledek jako privacy-policy.md, zveřejni ho jako veřejný Gist a dej mi odkaz.

Šablona má pět krátkých částí: k čemu aplikace přistupuje, co ukládá, s kým údaje sdílí, jak je smazat a jak tě kontaktovat. Má i řádek pro uvedení AI služby, která analyzuje tvoje fotky. Tvůj agent z fotek rozpoznává předměty, takže uveď službu, na které ho provozuješ. Šablona si ani nehraje na víc, než je: “Tohle je výchozí návrh, ne právní rada.” Samotné zveřejnění je pro tvého agenta jeden řádek:

gh gist create --public --desc "Privacy policy: My eBay Lister" privacy-policy.md

5. Ty: vytvoř si eBay RuName

RuName je zkratka pro “redirect URL name.” (název přesměrovací URL). Tak eBay přezdívá tvému nastavení přesměrování a vypadá to, jako by název tvojí aplikace prošel skartovačkou: YourName-YourApp-ab12-cdefgh. Krok s udělením souhlasu ho potřebuje. Každá sada klíčů má vlastní RuName, takže tohle vytvoř ze sady klíčů Production.

K formuláři se dostaneš takhle:

1. Na Application Keys vyber User Tokens pod App ID pro Production.
2. Otevři Get a Token from eBay via Your Application (Získat token od eBay prostřednictvím tvojí aplikace). Vyber “You have no Redirect URLs. Click here to add one.” (Nemáš žádné přesměrovací URL. Klikni sem a přidej jednu.)
3. Chce eBay oficiální adresu? Vyplň formulář. Vyber Continue to create RuName (Pokračovat k vytvoření RuName).

Vyplň formulář. Růžová čísla odpovídají tomuto seznamu:

1. Do Your privacy policy URL (URL tvých zásad ochrany osobních údajů) vlož odkaz na Gist z kroku 4.
2. Do Your auth accepted URL (Tvoje URL po přijetí souhlasu) a Your auth declined URL (Tvoje URL po odmítnutí souhlasu) zadej libovolnou adresu HTTPS. Moje nastavení používá https://example.com.
3. Zadej Display Title (Zobrazovaný název), například “My eBay Lister”. Tento název uvidíš na stránce souhlasu v kroku 7.
4. Ulož formulář.
5. Zkopíruj RuName. V kroku 6 ho vložíš do .env.

Proč může být URL po přijetí souhlasu libovolná stránka HTTPS? Nemusí na ní nic běžet. Jakmile v kroku 7 udělíš souhlas, eBay pošle tvůj prohlížeč na tuto adresu s připojeným jednorázovým kódem a ty ho zkopíruješ přímo z adresního řádku. Formulář eBay dodává: “If you leave these fields blank, the eBay default accept and reject pages will be used.” (Pokud tato pole necháš prázdná, použijí se výchozí stránky eBay pro přijetí a odmítnutí.) Adresa, kterou pak zkopíruješ, vypadá jinak. Krok 7 ukazuje obě.

eBay také nepřijme svoje vlastní zásady ochrany osobních údajů jako tvoje: URL musí používat HTTPS a “should not be eBay’s Privacy Policy URL.” (neměla by to být URL zásad ochrany osobních údajů eBay). Průvodce eBay Quick OAuth Guide (Stručný průvodce OAuth) požaduje RuName s volbou “OAuth Enabled” (OAuth povoleno). Pokud tuto možnost ve formuláři vidíš, zapni ji.

6. Ty a tvůj agent: vyplnění souboru .env

.env je prostý textový soubor, který uchovává tvoje klíče na tvém vlastním disku. Tvůj agent ho vytvoří. Tajné údaje do něj vložíš ty, takže nikdy neprojdou chatem.

1. Požádej svého agenta, aby vytvořil .env ze souboru .env.example s nastavením EBAY_ENVIRONMENT=production.
2. Otevři .env v textovém editoru.
3. Vlož App ID za EBAY_CLIENT_ID=.
4. Vlož Cert ID za EBAY_CLIENT_SECRET=.
5. Vlož RuName za EBAY_REDIRECT_URI=. Vlož RuName, ne URL.
6. Nech EBAY_USER_REFRESH_TOKEN= prázdné. Vyplní ho krok 7.
7. Ulož soubor.

Až budeš hotový, pět důležitých řádků bude vypadat takhle, s tvými hodnotami místo závorek:

EBAY_ENVIRONMENT=production
EBAY_CLIENT_ID=<Production App ID>
EBAY_CLIENT_SECRET=<Production Cert ID>
EBAY_REDIRECT_URI=<Production RuName>
EBAY_USER_REFRESH_TOKEN=

Na řádku s RuName chybuje nejvíc lidí. Nastavení se jmenuje redirect_uri, takže URL působí jako správná odpověď. eBay chce RuName. URL na tomto místě je nejčastější příčinou chyb redirect_uri.

Pokud Cert ID někdy unikne, otevři Application Keys a vyber Rotate (Reset) Cert ID s přechodnou lhůtou 0, aby ten starý přestal okamžitě fungovat. Nový vlož do .env. Obnovovací tokeny výměnu přežijí, takže nemusíš opakovat krok 7.

7. Ty a tvůj agent: souhlas a obnovovací token eBay

Tady si obě strany podají ruce. Ty jako prodejce řekneš eBay, že tahle aplikace smí spravovat tvoje inzeráty. eBay předá tvému prohlížeči jednorázový kód. Tvůj agent kód vymění za obnovovací token, dlouhodobý klíč, který pak automatizovaný postup používá. Na všechno máš pět minut, takže si nejdřív přečti seznam a pak se do toho pusť.

1. Požádej svého agenta, aby spustil auth-url. Dostaneš odkaz k udělení souhlasu.
2. Otevři odkaz k udělení souhlasu v prohlížeči.
3. Chce eBay přihlášení? Zadej uživatelské jméno a heslo svého účtu prodejce. Nepoužívej vývojářský účet.
4. Přečti si oprávnění na stránce souhlasu. Přijmi je.
5. Zkopíruj celou adresu z adresního řádku stránky, která se otevře.
6. Vlož celou adresu do chatu.
7. Požádej svého agenta, aby s ní okamžitě spustil exchange-code.
8. Zkontroluj, že tvůj agent hlásí "stored": true. Hlásí invalid_grant? Začni znovu od začátku tohoto seznamu.

Takhle vypadají ty dvě adresy. Tvůj agent ti dá první. Ty mu vrátíš druhou.

You open (the consent link from your agent):
https://auth.ebay.com/oauth2/authorize?client_id=<App ID>&redirect_uri=<RuName>&response_type=code&scope=https%3A//api.ebay.com/oauth/api_scope%20...

You copy (from the address bar, after you accept):
https://example.com/?code=v%5E1.1%23i%5E1%23...&expires_in=299

Část za code= je pokaždé nová. Funguje jednou a vyprší za 299 sekund, což ti říká expires_in=299. Tvoje adresa může obsahovat další části, například state=. Zkopíruj ji celou. Tvůj agent z ní kód vybere.

Je bezpečné vložit to do chatu? Kód funguje jednou a za pět minut přestane platit. eBay ho vymění za token jen společně s tvým Cert ID a Cert ID zůstává v .env. Bez Cert ID je tedy kód k ničemu. Přesto ho uvidí dvě místa: chat a web na tvé URL po přijetí souhlasu, který si může zapsat adresu, na kterou dorazíš. Ani jedno nedostane tvoje Cert ID a jakmile tvůj agent kód vymění, je spotřebovaný. Odkaz k udělení souhlasu tvoje App ID a RuName ukazuje. To je normální: obsahuje je každý odkaz k udělení souhlasu OAuth.

Nechal jsi v kroku 5 URL po přijetí souhlasu prázdnou? Pak tě eBay pošle na vlastní stránku a adresa začíná takhle:

https://signin.ebay.com/ws/eBayISAPI.dll?ThirdPartyAuthSucessFailure&isAuthSuccessful=true&state=null&code=v%5E1...

Ano, “Sucess.” Takhle to píše eBay, ne já. Část code= je tam také a exchange-code ji přečte z jakékoli adresy. Tahle cesta také udrží kód mimo web, který neprovozuješ. Moje vlastní nastavení používá example.com, takže tuhle cestu jsem sám nezkoušel.

Co	Jak dlouho platí	Kdo to zařídí
Kód	299 sekund, jedno použití	Jednou ho zkopíruješ
Přístupový token	2 hodiny	Nástroj ho obnovuje sám
Obnovovací token	Přibližně 18 měsíců	Až vyprší, zopakuj tento krok

Pokud se něco pokazí:

• invalid_grant: kód už byl použitý nebo je starší než pět minut. Získej nový odkaz a vlož adresu rychleji.
• Chyba redirect_uri: .env obsahuje URL nebo RuName pro Sandbox místo RuName pro Production.
• invalid_client: App ID a Cert ID pocházejí z různých sad klíčů nebo EBAY_ENVIRONMENT není production.

8. Ty a tvůj agent: vytvoření obchodních pravidel eBay

Obchodní pravidla jsou uložené odpovědi na otázky, které pokládá každý inzerát: jak se zboží odešle, jak kupující zaplatí a co se stane při vrácení? Tvůj agent je připojuje ke každé nabídce podle identifikátoru. Jeho nástroj umí pravidla číst, ale nemá příkaz k jejich vytvoření, takže tahle část je na tobě.

Nejdřív požádej svého agenta, aby spustil policies. Vypíše pravidla, která už máš. Pokud už máš pravidla dopravy zdarma, pravidla platby a pravidla vrácení zboží do 30 dnů, přeskoč ke kroku 9. Pokud policies hlásí, že tvůj účet nemá zapnuté používání Business Policies, tvůj agent může spustit setup --opt-in --confirm, ale až poté, co řekneš ano. Pak požádej svého agenta, aby znovu spustil policies. Jakmile chyba se zapnutím používání zmizí, vytvoř svá pravidla. Podle poznámek samotného repozitáře může tohle čekání trvat od několika minut do 24 hodin.

1. Otevři My eBay (Moje eBay). Vyber Account (Účet). V nabídce vlevo vyber Selling (Prodej).
2. Vyber Business Policies (Obchodní pravidla). Otevře se stránka Manage your business policies (Spravuj svá obchodní pravidla).
3. Vpravo nahoře vyber Create policy (Vytvořit pravidla). Vyber typ pravidel.

Takhle postupně vytvoř troje pravidla.

Pravidla dopravy

Automatizovaný postup při stanovení ceny započítává náklady na dopravu do ceny předmětu, takže vyžaduje pravidla dopravy zdarma. Vynech vypočítávanou cenu dopravy. Otázky k převzetí nástroje v repozitáři ji uvádějí jako příklad pravidel, která mohou selhat kvůli chybám s balíkem.

1. V části Cost type (Typ ceny) vyber Flat: Same cost to all buyers (Pevná cena: stejná pro všechny kupující).
2. Zapni Offer free shipping (Nabídnout dopravu zdarma).
3. Zadej Policy name (Název pravidel), například “Free domestic shipping” (Vnitrostátní doprava zdarma).
4. Vyber Shipping method (Způsob dopravy), který odpovídá tvým předmětům.
5. Vyber Handling time (Doba do odeslání), která odpovídá tvým předmětům.
6. Vyber Save (Uložit).

Pravidla platby a vrácení zboží

1. Vytvoř pravidla platby. Zapni Require immediate payment when buyer uses Buy It Now (Vyžadovat okamžitou platbu, když kupující použije Koupit hned). Vyber Save.
2. Vytvoř pravidla vrácení zboží. V části pro vnitrostátní vrácení zapni Accept returns (Přijímat vrácené zboží).
3. V Allowed within (Povoleno do) vyber 30 Days (30 dnů). V Return shipping paid by (Dopravu při vrácení platí) vyber Buyer (Kupující). Vyber Save.
4. Požádej svého agenta, aby znovu spustil policies.
5. Zkontroluj, že se zobrazují všechna troje pravidla.

Moje pravidla platby vyžadují okamžitou platbu a výchozí pravidla vrácení zboží v repozitáři jsou 30 dnů s tím, že dopravu při vrácení platí kupující. Formulář eBay přidává vlastní pobídku: “Offering a minimum 30-day return policy helps your listings qualify for Top Rated Seller Benefits.” (Možnost vrácení zboží po dobu alespoň 30 dnů pomáhá tvým inzerátům získat nárok na výhody nejlépe hodnocených prodejců.)

9. Ty a tvůj agent: zápis account.json a provedení kontrol

Identifikátory tvých pravidel a umístění zásob jsou jiné než u ostatních, takže patří do account.json, soukromého souboru vedle .env. Tvůj agent ho zapíše pomocí setup. Tenhle příkaz s nikým nevede rozhovor. Zachová volby, které už jsou uložené v account.json. Jinak vezme jedinou dostupnou možnost, například tvoje jediné umístění nebo tvoje jediná pravidla vrácení zboží do 30 dnů. Když nedokáže vybrat, uvede to v choices a počká na přepínač. Na tobě je rozhodnout tam, kde to sám nedokáže.

1. Požádej svého agenta, aby spustil setup --dry-run. Oznámí, co našel a o čem nedokáže rozhodnout.
2. Projdi se svým agentem choices. Je na některém řádku “found: pass”? Řekni svému agentovi, která pravidla nebo umístění má použít.
3. Chybí umístění zásob? Dej svému agentovi své americké poštovní směrovací číslo, město a stát. Schval příkaz --create-location.
4. Požádej svého agenta, aby s tvými volbami znovu spustil setup --dry-run.
5. Obsahuje problems pořád něco? Zopakuj kroky 2 až 4.
6. Požádej svého agenta, aby se stejnými volbami spustil setup. Zapíše account.json.
7. Požádej svého agenta, aby použil zbývající odpovědi k převzetí nástroje. ADOPTION-QUESTIONS.md u každé z nich uvádí příslušný klíč nebo soubor.
8. Zkontroluj cenový limit a sazbu poplatků v části pipeline souboru account.json.
9. Požádej svého agenta, aby provedl pět kontrol níže. Všech pět by mělo uspět.

Tvoje volby se předávají jako přepínače. Tvůj agent předá identifikátor pravidel pomocí --fulfillment (tak eBay označuje dopravu), --payment nebo --return a umístění pomocí --location-key. Stejnou cestou se předávají dvě odpovědi k převzetí nástroje: --disallow-fulfillment označuje pravidla dopravy, která tvůj agent nikdy nesmí použít, a --return-14-day určuje pravidla vrácení zboží do 14 dnů, pokud taková používáš:

python tools/ebay_api.py setup --dry-run --fulfillment <ID> --return <ID> --location-key HOME-01

Příkaz k vytvoření umístění, který tvůj agent spustí po tvém ano, vypadá takhle:

python tools/ebay_api.py setup --create-location --location-key HOME-01 --postal-code <ZIP> --city <city> --state <ST> --confirm

Bod 7 výše snadno přehlédneš, protože setup čte tvůj účet eBay, ne tvoje odpovědi k převzetí nástroje. Část pipeline vyplní výchozími hodnotami repozitáře: ke kontrole jde cokoli nad 200 $, pod mírou jistoty 0,70 se má zeptat, poplatek z konečné hodnoty je 13,6 % a za objednávku 0,40 $. Tyto hodnoty platí, dokud tvůj agent soubor neupraví, a další spuštění setup úpravy zachovají. Tvoje ostatní odpovědi, například zdroj fotek a zálohování, patří do souborů pracovních postupů a do AGENTS.md. Kroky 5 a 6 v ADOPTION-GUIDE.md uvádějí všechny úpravy. Jeho krok 7 přidává ověřovací běh nad smyšleným inzerátem na čelovku, který na eBay nic nemění.

Pak přijde pět kontrol z kroku 9:

python tools/ebay_api.py setup --dry-run              # "problems": [] means ready
python tools/ebay_api.py policies
python tools/ebay_api.py categories "flashlight"
python tools/ebay_api.py browse "flashlight" --limit 1
python tools/ebay_api.py reconcile

Tady je skutečný výstup setup --dry-run z mého vlastního účtu, zkrácený a se skrytými identifikátory. Je to opakované spuštění, proto každá volba uvádí “kept from account.json.” Hledáš řádek "problems": [].

{
  "file": "<your folder>/account.json",
  "written": false,
  ...
  "choices": {
    "merchantLocationKey": "kept from account.json",
    "fulfillment": "kept from account.json",
    "payment": "kept from account.json",
    "return": "kept from account.json"
  },
  "problems": [],
  ...
  "next": "Ready: the Lister copies these IDs into offer.json; validate_payload.py checks them"
}

"written": false znamená, že zkušební běh se podíval a soubor nechal být.

Tvůj první předmět: kdo co dělá

Tím máš nastavení eBay API hotové. Odteď vložíš fotky do složky a tvůj agent postupně spustí pět pracovních postupů. Tvoje role se zmenší na pár kontrol:

Pracovní postup	Co děláš ty
Import	Vložíš fotky. Zkontroluješ seskupení
Curator	Opravíš rozpoznání předmětu, pokud je chybné
Evaluator	Na požádání vložíš srovnatelné prodeje z Terapeaku
Lister	Nic. Skončí u nezveřejněné nabídky
Review	Přečteš si listing-draft.md a pak schválíš nebo odmítneš

Proč Terapeak ručně? Příkaz Browse v nástroji vidí, kolik ostatní prodejci právě chtějí, ne kolik kupující skutečně zaplatili. Požadovaná cena je strop, ne uskutečněný prodej. Evaluator tě proto požádá o srovnatelné prodeje a Terapeak v Seller Hub (Centrum prodejce) je má.

Takhle pracuje obsluha parkoviště. Každé auto úhledně zaparkuje jako nezveřejněnou nabídku a cokoli nad tvým cenovým limitem na tebe čeká, ještě než se vůbec zaparkuje. Z parkoviště nic neodjede, dokud nepředáš lístek, a tím lístkem je tvoje ano v kroku Review.

Stáhni si ebay-listing-agent na GitHubu, dej svému agentovi ADOPTION-GUIDE.md a řekni mu “Production, ne Sandbox”. Pokud některý název prvku v tomto návodu k nastavení eBay API už neodpovídá obrazovce eBay, otevři v repozitáři issue, aby ho další prodejce nemusel hledat.

Zdroje

• eBay Developers Program: registrace
• Klíče aplikace eBay
• Začínáme s rozhraními API eBay
• Přihlašovací údaje OAuth eBay
• Smazání účtu na tržišti eBay
• Stručný průvodce eBay OAuth (RuName, kód souhlasu)
• Obnovení tvého Cert ID
• Obchodní pravidla na eBay (nápověda pro prodejce)
• Obchodní pravidla (průvodce Account API)
• ebay-listing-agent na GitHubu
• GitHub CLI: příkaz gh gist create
• Stažení Pythonu
• Stažení ImageMagicku

---