AI-agenteknek

Agentek – áttekintés és gyors kezdés

Telepítsd a Haszno skillt, CLI-t és MCP-szervert; futtasd az első csak olvasásos parancsot a demón öt percen belül.

A három eszköz

A Haszno három csomagot biztosít AI-agenteknek és automatizálási szkripteknek. A CLI és az MCP-szerver ugyanazt a HTTP API-t hívja, ugyanolyan hitelesítési adatokkal (az x-api-key fejlécben küldött API-kulccsal vagy HTTP Basic-kel), de máshonnan olvassák őket: a CLI csak az --api-key / --api-url flagekből és a környezeti változókból (HASZNO_API_KEY, HASZNO_API_URL, HASZNO_BASIC), az MCP-szerver ezekből a környezeti változókból, vagy ha egyik sincs beállítva, a ~/.config/haszno/config.json fájlból. Lásd: CLI-beállítás.

Csomag	Mi ez	Mire való
MCP-szerver (`haszno-mcp`)	MCP stdio szerver: 51 eszköz `haszno_*` névvel regisztrálva	Interaktív Claude Code- vagy Claude Desktop-munkamenetek – az eszközök natívan jelennek meg, nincs szükség parancssori meghívásra
CLI (`haszno`)	Node.js parancssori program	Shellszkriptek, cron-feladatok, Codex, Cursor terminál, fej nélküli agentek
Skill (`haszno-skill`)	Irányítófájlok a Claude Code-hoz: biztonsági szabályok, munkafolyamat-receptek, eszköz- és parancshivatkozások	A Claude Code betöltheti, ha a beszélgetés a Hasznóról szól; megtanítja az agentnek az MCP és a CLI használatát

A skill önmagában nem önálló API-felület. A Claude Code-ban töltődik be, és utasítja az agentet: ha az MCP csatlakoztatva van, azt használja, egyébként a CLI-t.

Melyiket válaszd?

Környezet	Mit használj
Interaktív Claude Code-munkamenet	MCP-szerver + skill
Claude Desktop	MCP-szerver
Bármely MCP-kompatibilis kliens (Cursor, Zed …)	MCP-szerver
Shellszkript vagy cron-feladat	CLI
Codex terminál	CLI
Mindhárom egyszerre	Egylépéses telepítő

Telepítés

Egylépéses telepítő (ajánlott)

Egyetlen paranccsal telepíti a CLI-t, az MCP-szervert és a skillt. Szükséges: Node.js 20 vagy újabb, git és npm.

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

Mit csinál:

Klónozza mindhárom repót a ~/.haszno/ mappába (gh repo clone-nal, ha a GitHub CLI be van jelentkezve, egyébként git clone-nal HTTPS-en)
Lefordítja a CLI-t és az MCP-szervert (npm install && npm run build)
npm link-kel globálisan elérhetővé teszi a haszno binárist (ha nem sikerül, ~/.local/bin/haszno szimlinket hoz létre)
Regisztrálja az MCP-szervert a Claude Code-ban: claude mcp add haszno --scope user -- node ~/.haszno/haszno-mcp/dist/index.js (kihagyja, ha a claude nincs a PATH-on, vagy a haszno már regisztrálva van)
Átmásolja a skill fájlokat a ~/.claude/skills/haszno/ mappába

A telepítő nem állít be hitelesítési adatokat. A végén kiírja azt a két export sort (HASZNO_API_URL, HASZNO_API_KEY), amelyre a CLI-nek szüksége van.

A csomagok nincsenek közzétéve npm-en. Használd a fenti telepítőt, vagy a CLI-referenciában és az MCP-szerver oldalon megadott GitHub-telepítési útvonalakat.

Helyi forrás felülbírálása

HASZNO_SRC_DIR=~/Documents/medusa-shops/haszno-labs bash install.sh

Eltávolítás

bash ~/.haszno/haszno-skill/install.sh --uninstall

Törli a ~/.haszno/ mappát, a ~/.local/bin/haszno szimlinket, az npm link-et (ha tudja), a ~/.claude/skills/haszno/ mappát és az MCP-regisztrációt. A ~/.config/haszno/config.json fájlt nem törli.

Mi működik hitelesítés nélkül

A https://haszno.com demó néhány nyilvános, csak olvasásos végpontot hitelesítés nélkül, szintetikus adatokkal szolgál ki. A többi végpont 401-et ad.

A nyilvános demón minden ár, SKU és piaci adat szintetikus. Csak az /api/settings és az /api/impact válaszában van "demo": true mező. Lásd a Hitelesítés oldalt valódi adatokhoz való hozzáférésért.

Képesség	Hitelesítés nélkül (demó)	Hitelesítés szükséges
Kategóriák listázása	Igen	—
Termékek listázása árral és piaci összehasonlítással	Igen	—
Irányítópult-összesítő, Haszon-mérő, árazási beállítások	Igen	—
Rendelések és árjavaslatok megtekintése	Igen (üres listák)	—
Hálózati beszállítók böngészése vagy keresés a partnerkatalógusban	—	Igen
Szabályok, automatizálási állapot, termékötletek megtekintése	—	Igen
Beállítások vagy árak módosítása	—	Igen
Javaslatok jóváhagyása vagy elutasítása	—	Igen
Termékek küldése webshopba	—	Igen
Automatizálási szabályok létrehozása vagy futtatása	—	Igen

Biztonsági modell

Az olvasó eszközök és listázó parancsok mindig biztonságosak – nyugodtan hívd őket anélkül, hogy megkérdeznéd.

Minden adatmódosító parancs kifejezett megerősítést kér:

Az MCP-szerverben: add át a "confirm": true argumentumot az eszközhívásban. Nélküle az írási eszközök előnézeti leírást adnak vissza, és nem hívják az API-t.
A CLI-ben: add meg a --yes-t. Nélküle az árjavaslat-, szabály-, importlista-kiküldési és partnerparancsok előnézetet írnak ki, és semmit nem változtatva kilépnek; a fiók-, termék-, feed-, ötlet- és rendelésmódosító parancsok interaktív kérdéssel kérnek megerősítést. Kivétel a haszno import add: megerősítés nélkül ír. Lásd: Írási parancsok és megerősítés.

Minden tömeges írás előtt (javaslatok jóváhagyása, szabályok futtatása) ellenőrizd az automatizálás kill switch-ét:

haszno rules automation --json
# or via MCP: haszno_automation_get

Ha a paused értéke true, ne hagyj jóvá javaslatokat és ne futtass szabályokat – először tájékoztasd a felhasználót.

Ha egy jóváhagyott javaslatbatch rossznak tűnik, hívd a haszno proposals rollback --batch <batchId> parancsot, vagy az haszno_proposals_rollback MCP-eszközt, mielőtt bármit csinálnál. A batchId-t a jóváhagyási parancs adja vissza.

5 perces gyors kezdés

1. lépés – telepítés

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

Telepítés után indítsd újra a shelledet (vagy nyiss új terminált).

2. lépés – kapcsolat ellenőrzése

haszno account ping

Hitelesítés nem szükséges. Várt kimenet:

API: OK elérhető

3. lépés – az első olvasási parancs

Az irányítópult-összesítő kiírása – nem kell hitelesítés:

haszno account stats --json

Ha később a saját adataiddal dolgoznál, futtasd egyszer a haszno login parancsot: az API URL-t és a kulcsot a ~/.config/haszno/config.json fájlba menti, amelyet a CLI és az MCP-szerver is olvas. Szkriptekben inkább exportáld a HASZNO_API_KEY-t (lásd: CLI-beállítás).

4. lépés – kérdezd meg Claude-ot

Az MCP-szerver regisztrálásával nyiss meg egy Claude Code-munkamenetet, és próbáld ki:

„Listázd a Haszno legfelső kategóriáit, és mutasd az egyes kategóriák termékszámát!"

„Mik az aktuális árazási beállításaim?"

„Mi az aktuális árhatás-összesítő?"

A Claude Code magától is betöltheti a skillt, ha megemlíted a Hasznót, a dropshippinget vagy kapcsolódó témákat.

Géppel olvasható dokumentáció

llms.txt

Minden dokumentációs oldal strukturált indexe:

https://docs.haszno.com/llms.txt

Ez az llms.txt konvenciót követi. Azok az AI-agentek, amelyek kérdések megválaszolása előtt beolvassák a dokumentációt, ezt a fájlt kérjék le először, hogy megismerjék a rendelkezésre álló oldalakat.

llms-full.txt

Egyetlen fájl, amely minden oldal teljes Markdown-tartalmát tartalmazza:

https://docs.haszno.com/llms-full.txt

Hasznos olyan agenteknek, amelyeknek egyetlen HTTP-kéréssel kell megszerezniük a teljes dokumentációt.

Markdown-tükrök

Minden HTML-oldal rendelkezik egy egyszerű Markdown-tükörrel, ugyanazon az útvonalon .md kiterjesztéssel:

https://docs.haszno.com/en/agents.md
https://docs.haszno.com/en/cli.md
https://docs.haszno.com/en/mcp.md
https://docs.haszno.com/en/skill.md

Minden HTML-oldal bejelenti a tükrét egy HTTP Link: válaszfejléccel is:

Link: </en/agents.md>; rel="alternate"; type="text/markdown"

Oldalmásolás

Minden oldalon van egy Oldal másolása gomb, amely a vágólapra írja az oldal Markdown-tartalmát. Böngészőbe ágyazott agentekben használd, hogy HTML renderelése nélkül olvasd be az aktuális oldalt.

Lásd még

CLI-referencia – teljes parancshivatkozás az összes flaggel és példával
MCP-szerver – teljes eszközhivatkozás bemeneti és kimeneti sémákkal
Agent skill – mit tanít a skill, biztonsági szabályok, munkafolyamat-receptek
Hitelesítés – hogyan szerezhetsz API-hozzáférést a demón túl