CLI-referencia

A haszno CLI telepítése, beállítása és használata: globális flagek, kimeneti formátumok, kilépési kódok és minden parancscsoporthoz példák.

Telepítés

A haszno CLI egy Node.js program (Node.js 20 vagy újabb kell hozzá). A csomag nincs közzétéve npm-en ("private": true a package.json-ban). Használd az alábbi módszerek egyikét.

Egylépéses telepítő (mindhárom eszköz)

Egyszerre telepíti a CLI-t, az MCP-szervert és a skillt. Szükséges: Node.js 20+, git és npm.

curl -fsSL https://raw.githubusercontent.com/haszno-labs/haszno-skill/main/install.sh | bash

Lásd az Agentek áttekintése oldalt a telepítő lépésenkénti leírásáért.

Kézi telepítés (csak a CLI)

npm install -g github:haszno-labs/haszno-cli

Futtatás telepítés nélkül

npx -y github:haszno-labs/haszno-cli account ping

Telepítés ellenőrzése

haszno --version
# 0.1.0

haszno account ping
# API: OK elérhető

Beállítás

A CLI az API címét és a hitelesítési adatokat a --api-url / --api-key jelzőkből, környezeti változókból vagy a haszno login által írt konfigurációs fájlból veszi. Saját gépen elég egyszer bejelentkezned:

haszno login --api-url https://haszno.com --api-key <your-api-key>

Szkriptekben, CI-ban és cron-feladatokban inkább exportáld a változókat:

export HASZNO_API_URL=https://haszno.com
export HASZNO_API_KEY=<your-api-key>

Környezeti változók

Prioritási sorrend

A legmagasabbtól a legalacsonyabbig:

1. --api-url / --api-key jelzők
2. HASZNO_API_URL, HASZNO_API_KEY, HASZNO_BASIC
3. ARFUTAR_API_URL, ARFUTAR_API_KEY, ARFUTAR_BASIC (régi nevek)
4. ~/.config/haszno/config.json
5. ~/.config/arfutar/config.json (régi hely, csak akkor olvassa, ha a fenti fájl nem létezik)
6. https://haszno.com, hitelesítés nélkül

Az API-kulcs az x-api-key fejlécben megy. HTTP Basic hitelesítést csak akkor használ, ha nem talál API-kulcsot; ehhez nincs jelző.

Két szabály gondoskodik arról, hogy a hitelesítési adat ne kerüljön rossz szerverhez:

• A konfigurációs fájlt csak akkor olvassa be, ha sem jelző, sem környezeti változó nem ad hitelesítési adatot. A környezeti változóból jövő kulcsot soha nem küldi olyan URL-re, amelyet csak a konfigurációs fájl nevez meg.
• A konfigurációs fájlban lévő hitelesítési adatot csak arra az URL-re küldi el, amelyhez mentetted (a fájl apiUrl értéke, vagy https://haszno.com, ha nincs benne). Ha a --api-url vagy a HASZNO_API_URL másik szerverre mutat, ahhoz külön add meg a kulcsot.

Ha semmi nincs beállítva, a kérések hitelesítés nélkül mennek. A nyilvános demóvégpontokhoz ez elég.

Konfigurációs fájl

A haszno login a ~/.config/haszno/config.json fájlt írja (600-as fájlmóddal). A CLI és az MCP-szerver is ezt olvassa, így egy bejelentkezés mindkettőt beállítja.

{
  "apiUrl": "https://haszno.com",
  "apiKey": "<your-api-key>"
}

A fájlban lévő basicAuth értéket (user:password) is figyelembe veszi. Ha a fájl nem érvényes JSON, vagy nem JSON-objektum, figyelmen kívül hagyja.

Kérések

Minden kérés Content-Type: application/json, Accept: application/json és User-Agent: haszno-cli/0.1.0 fejlécet küld. A HTTP 429 és 5xx válaszokat, valamint a hálózati hibákat újrapróbálja, összesen legfeljebb 3 kísérlettel, 500 ms-ról induló exponenciális várakozással. Minden kísérlet 30 másodperc után időtúllépéssel leáll.

Globális flagek

Ezek a flagek a gyökér haszno parancshoz tartoznak. Az alparancs elé és mögé is írhatod őket (a haszno --json products list és a haszno products list --json ugyanaz).

Kimeneti formátumok

--json nélkül: ember által olvasható szöveg és táblázatok, magyar feliratokkal és üzenetekkel.

--json esetén: egyetlen JSON-dokumentum az stdout-on. A listázó parancsok JSON-tömböt adnak, kivéve, ha lent a parancs leírása burkoló objektumot említ (catalogue search, ideas list, blog latest). Egyes parancsok formázva, mások egy sorban írják ki a JSON-t; JSON-elemzővel (például jq-val) dolgozd fel, ne soronként.

A hibák sima szövegként kerülnek az stderr-re (többnyire Hiba: <üzenet>), --json módban is. Az egyetlen kivétel a haszno ideas, amely --json módban {"error": "<üzenet>"} formában írja a hibát az stderr-re.

Kilépési kódok

Írási parancsok és megerősítés

Az írási parancsok --yes nélkül háromféleképpen viselkednek:

A haszno import add azonnal ír; nincs megerősítése és nincs --yes flagje.

Szkriptekben és agentekben mindig add meg a --yes-t egy írási parancsnál, miután a felhasználó jóváhagyta a műveletet. Terminál nélkül az account settings update és a feeds import-* 2-es kóddal kilép, az ideas fill-keywords --json pedig megtagadja a futást.

haszno login

Elmenti az API URL-t és a kulcsot a ~/.config/haszno/config.json fájlba a CLI és az MCP-szerver számára. A haszno configure ugyanezt teszi.

Szintaxis: haszno login [--api-url <url>] [--api-key <key>]

Jelzőkkel kérdés nélkül elmenti a megadott értékeket, így szkriptből is használható. Jelzők nélkül bekéri az API URL-t (Enterrel marad az alapértelmezett https://haszno.com) és az API-kulcsot; jelzők és terminál nélkül 2-es kóddal kilép. A fájlban már meglévő értékek megmaradnak, hacsak nem írod felül őket, a fájl pedig 600-as móddal jön létre.

haszno login --api-url https://haszno.com --api-key <your-api-key>
# Konfigurációs fájl elmentve: /home/you/.config/haszno/config.json

haszno account

haszno account ping

API-kapcsolat ellenőrzése. Az /api/health-hez nem kell hitelesítés. 1-es kóddal lép ki, ha az API nem ok-val válaszol.

Szintaxis: haszno account ping

haszno account ping

haszno account stats

Az irányítópult-összesítő kiírása.

Szintaxis: haszno account stats [--json]

haszno account stats --json

JSON-kimenet: { products, losing, overMarket, toFix, orders }

Lásd még: haszno account impact · MCP: haszno_account_get_stats

haszno account impact

Haszon-mérő az utolsó N napra.

Szintaxis: haszno account impact [--days <n>] [--json]

haszno account impact --days 7 --json

JSON-kimenet: többek között days, extraProfit, baseline, pctGain, orders, autoForwardedOrders

haszno account settings update

Árazási beállítások frissítése. Írás – [y/N] kérdést tesz fel, hacsak nem adod meg a --yes-t. A három flag közül legalább egyet adj meg; a többi megtartja az aktuális értékét.

Szintaxis: haszno account settings update [--undercut-pct <n>] [--min-margin-pct <n>] [--vat-pct <n>] [--yes]

haszno account settings update --undercut-pct 1 --min-margin-pct 10 --vat-pct 27 --yes

haszno products

A saját boltod termékei és árazása.

Az írási alparancsok [y/N] kérdést tesznek fel, hacsak nem adod meg a --yes-t.

haszno products list

A termékeid lekérése és kiírása.

Szintaxis: haszno products list [--all] [--losing] [--over-market] [--cats <names>] [--json]

# Human-readable table
haszno products list

# JSON output — all fields
haszno products list --json

# Include unlisted, filter with jq
haszno products list --all --json | jq '.[] | select(.current.marginPct < 10)'

JSON-mezők termékenként (válogatás): id, sku, name, supplierName, listed, priceGross, costNet, stock, current.marginPct, recommended.priceGross, marketMinGross, marketShop

haszno products update

Szintaxis: haszno products update <id> [--price <gross>] [--market-min <gross>] [--market-shop <name>] [--yes]

Adj meg legalább egyet a --price, --market-min, --market-shop közül, különben a parancs 2-es kóddal kilép.

haszno products apply-prices

A motor által javasolt árak alkalmazása. Írás – [y/N] kérdést tesz fel, hacsak nem adod meg a --yes-t.

Szintaxis: haszno products apply-prices [--ids <id,...>] [--yes] [--json]

# Prompts before changing anything
haszno products apply-prices --ids 1,2,3

# After the user has confirmed
haszno products apply-prices --ids 1,2,3 --yes

JSON-kimenet: { changed, total }

haszno catalogue

Keresés a partnerkatalógusban.

haszno catalogue search

Szintaxis: haszno catalogue search [--q <szöveg>] [--cats <kulcsok>] [--partner <id>] [--min-margin <pct>] [--max-price <ft>] [--min-price <ft>] [--in-stock] [--country <kód>] [--sort <kulcs>] [--page <n>] [--page-size <n>] [--json]

JSON-kimenet: { items, total, facets }. Minden tételben van id (a katalógustermék-azonosító, amelyet a haszno import add vár), name, partnerId, partnerName, categoryKey, wholesaleNet, rrpGross, marginPct, stock, inImportList, inShop.

# Find in-stock garden items with at least 20% margin
haszno catalogue search --cats kert --min-margin 20 --in-stock --json \
  | jq '.items[] | {id, name, marginPct, stock}'

haszno import

Importlista: katalógustermékek előkészítése, majd létrehozásuk a boltodban vagy kiküldésük egy bekötött webshopba.

Állapotértékek a --status-hoz: varakozik, feltoltve, elvetve Az API ezekre az értékekre szűr; a CLI beépített súgója a varakozik, kuldve, kesz, hiba értékeket sorolja fel, amelyek célboltonkénti küldési állapotok, nem tételállapotok.

A push --target nélkül a POST /api/import-list/push végpontot hívja, amely létrehozza a termékeket a Haszno-boltodban, és { pushed }-ot ad vissza. --target <connectionId> megadásával (a haszno connections list-ből) a POST /api/connect/stores/<connectionId>/push végpontot hívja, amely az adott bekötött webshopba küldi őket, és { pushed, failed, errors }-t ad vissza.

# Stage two catalogue products (catalogue product IDs from `catalogue search`)
haszno import add 101 102

# Look up the import list item IDs
haszno import list --status varakozik --json

# Preview: what push would do
haszno import push --ids 5,6

# Create the items in your Haszno shop
haszno import push --ids 5,6 --yes

# Push to a specific connected webshop
haszno import push --ids 5,6 --target 1 --yes

haszno connections

Állapotértékek: uj, domain_ok, kapcsolva, hiba

haszno connections list --status kapcsolva --json

haszno proposals

Állapotértékek a --status-hoz: pending, approved, rejected, rolled_back

--yes nélkül az approve, a reject és a rollback egy [DRY-RUN] sort ír ki, és 0-val kilép.

# List pending proposals
haszno proposals list --status pending --json

# Preview the approval
haszno proposals approve --ids 10,11,12

# Approve after the user has confirmed
haszno proposals approve --ids 10,11,12 --yes
# Jóváhagyva: 3 javaslat (batch: <batchId>)

# Roll back if needed
haszno proposals rollback --batch <batchId> --yes

haszno rules

Automatizálási szabályok. Minden írási alparancs [DRY-RUN] előnézetet ír ki és 0-val kilép, hacsak nem adod meg a --yes-t.

Sablonkulcsok: keszlet_or, arjavaslat, felar_savok, veszteseg_riasztas. Beépített triggerek: feed_import, market_price, manual. A CLI csak sablonból tud szabályt létrehozni; egyéni feltételekhez vagy műveletekhez nincs flagje.

# Check kill switch
haszno rules automation --json

# Browse templates
haszno rules templates --json

# View execution log
haszno rules runs --limit 10 --json

# Pause automation (without --yes this is only a preview)
haszno rules automation pause --yes

haszno orders

Állapotértékek a --status-hoz: received, forwarded, shipped, error

A ship és a demo [i/n] kérdést tesz fel, hacsak nem adod meg a --yes-t.

# Find error-status orders
haszno orders list --status error --json

# Mark shipped
haszno orders ship 42 --yes

haszno peers

P2P-partnermeghívók a beszállítói hozzáférés megosztásához egy partnerbolttal.

# Preview (no --yes)
haszno peers invite --supplier 7 --expires 2026-12-01T00:00:00Z

# Create invite
haszno peers invite --supplier 7 --expires 2026-12-01T00:00:00Z --yes

# Accept a received invite code
haszno peers accept INVITE-XYZ --acceptor my-shop --yes

haszno ideas

Termékötletek a saját termékeidből, trendpontszám és árrés szerint rangsorolva (GET /api/recommendations).

JSON-kimenet (list): { anchor, geo, total, filtered, items }. Minden tételben van rank, id, sku, name, supplier, stock, costNet, suggestedPriceGross, marginNet, marginPct, trendScore.

haszno ideas list --limit 10 --json | jq '.items[] | {name, trendScore}'

haszno feeds

Feedimport és kimenő feedek URL-jei.

Az import-supplier-nél a --supplier és a --format kötelező. --file nélkül a parancsok az stdin-ről olvasnak; mivel ilyenkor az stdin nem terminál, a --yes-t is add meg.

Az urls a <alapcím>/feed/arukereso.xml és a <alapcím>/feed/google.xml címet írja ki. --fetch esetén le is tölti őket, hitelesítési adatok küldése nélkül.

# Import a CSV supplier feed
haszno feeds import-supplier --supplier 3 --format csv --file ./supplier-feed.csv --yes
# Létrehozva   142
# Frissítve    7
# Összesen     149

JSON-kimenet: import-supplier → { created, updated, total }; import-market → { matched, total }

haszno blog

JSON-kimenet: { posts, total, … }

haszno blog latest --period honap --limit 3 --json

Lásd még

• Agentek áttekintése – döntési táblázat, egylépéses telepítő, biztonsági modell
• MCP-szerver – teljes eszközhivatkozás a Claude Code-hoz és MCP-kliensekhez
• Hitelesítés – hogyan szerezhetsz API-kulcsot a demón túl