MCP-szerver

A Haszno MCP-szerver referenciája — telepítés, konfiguráció és mind az 51 megvalósított eszköz bemeneti sémákkal és példákkal.

Áttekintés

A Haszno MCP-szerver (haszno-mcp) a Haszno API-t haszno_* eszközök formájában teszi elérhetővé bármely MCP-kompatibilis AI-agent-kliens számára: Claude Code, Claude Desktop, Cursor és mások. stdio csatornán kommunikál, a Model Context Protocol szabvány szerint.

Az MCP-szerver a hitelesítési adatait környezeti változókból vagy a ~/.config/haszno/config.json konfigurációs fájlból olvassa. Ezt a fájlt a CLI haszno login parancsa (vagy a haszno_account_configure eszköz) írja. A CLI ugyanezt a fájlt olvassa, így egy bejelentkezés mindkettőt beállítja; a jelzők és a környezeti változók elsőbbséget élveznek vele szemben.

Átvitel

A szerver az @modelcontextprotocol/sdk csomag StdioServerTransport osztályát használja. Minden stdio-alapú szervereket támogató MCP-kliens kompatibilis.

Telepítés

Ajánlott: egylépéses telepítő

A skill repóban lévő egylépéses telepítő egyszerre telepíti az MCP-szervert, a CLI-t és az agent skillt:

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

Mit csinál a szkript:

1. Klónozza a haszno-mcp-t (és a haszno-cli-t, haszno-skill-t) a ~/.haszno/ mappába.
2. Futtatja az npm install && npm run build parancsot az MCP-szerveren.
3. Regisztrálja a szervert a Claude Code-ban: claude mcp add haszno --scope user -- node ~/.haszno/haszno-mcp/dist/index.js (kihagyja, ha a claude parancs nem található).
4. Átmásolja a skill fájlokat a ~/.claude/skills/haszno/ mappába.

Manuális telepítés

git clone https://github.com/haszno-labs/haszno-mcp ~/.haszno/haszno-mcp
cd ~/.haszno/haszno-mcp
npm install
npm run build

Ezután regisztráld a kliensednél (lásd Kliens-beállítás).

Kliens-beállítás

Claude Code

claude mcp add haszno --scope user -- node ~/.haszno/haszno-mcp/dist/index.js

Általános mcpServers JSON

Ezt a blokkot használd a claude_desktop_config.json-ban, .cursor/mcp.json-ban, vagy bármely más MCP-kliens-konfigurációban, amely elfogadja az mcpServers mezőt:

{
  "mcpServers": {
    "haszno": {
      "command": "node",
      "args": ["~/.haszno/haszno-mcp/dist/index.js"],
      "env": {
        "HASZNO_API_URL": "https://haszno.com",
        "HASZNO_API_KEY": "your-api-key"
      }
    }
  }
}

npx változat

A csomagok nincsenek közzétéve az npm-tárban (mindkettőnél "private": true van a package.json-ban). Ha van Node 20+ és hálózati hozzáférésed, egy GitHub-forrásra hivatkozó npx parancs is működik:

claude mcp add haszno -- npx -y github:haszno-labs/haszno-mcp

Konfiguráció

Környezeti változók

Konfigurációs fájl

Az MCP-szerver a ~/.config/haszno/config.json fájlt olvassa, és ha az nem létezik, a ~/.config/arfutar/config.json fájlt. A fájlt a CLI haszno login parancsa vagy a haszno_account_configure eszköz írja. A CLI-vel ellentétben az MCP-szerver nem ellenőrzi, hogy a mentett kulcs a használt URL-hez tartozik-e: ha az MCP-szervernél felülírod a HASZNO_API_URL-t, add meg mellé a HASZNO_API_KEY-t is.

{
  "apiUrl": "https://haszno.com",
  "apiKey": "haszno_live_..."
}

Az apiKey helyett a fájlban basicAuth (felhasználó:jelszó) is állhat.

Elsőbbség (legmagasabbtól a legalacsonyabbig)

1. HASZNO_API_URL / HASZNO_API_KEY / HASZNO_BASIC környezeti változók.
2. ARFUTAR_API_URL / ARFUTAR_API_KEY / ARFUTAR_BASIC környezeti változók (örökölt tartalék, csak akkor számít, ha a megfelelő HASZNO_* változó nincs beállítva).
3. ~/.config/haszno/config.json.
4. ~/.config/arfutar/config.json.

A konfigurációs fájlt a szerver csak akkor olvassa, ha a környezetből sem API-kulcs, sem Basic hitelesítési adat nem jön, és csak egyszer, induláskor. A fájl módosítása után indítsd újra az MCP-szervert. Az API-kulcs mindig az x-api-key fejlécben megy; a Basic adatokat csak API-kulcs hiányában használja.

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

A https://haszno.com ellen ezek az eszközök API-kulcs nélkül is működnek, és szintetikus demóadatot adnak vissza: haszno_ping, haszno_account_get_stats, haszno_account_get_impact, haszno_account_get_settings, haszno_account_list_suppliers, haszno_orders_list, haszno_orders_get, haszno_proposals_list, haszno_proposals_market, haszno_import_list_list, haszno_peers_invite_list és haszno_blog_latest. A haszno_feeds_outbound_info fetch_summary nélkül és a haszno_account_configure egyáltalán nem hív API-t.

Minden más eszköz — az összes írási eszköz, és olyan olvasó eszközök is, mint a haszno_catalog_*, a haszno_catalogue_search, a haszno_connections_list, a haszno_ideas_list, valamint a haszno_rules_* és haszno_automation_get olvasók — hitelesítés nélkül 401-et ad.

Megvalósított eszközök

A szerver pontosan 51 eszközt regisztrál 11 területen. A tizenkettedik terület, a saját bolt termékei, még nincs megvalósítva — lásd Tervezett eszközök.

A confirm paraméter

A legtöbb írási eszköznek van confirm paramétere, de ez négyféleképpen viselkedhet. Hogy melyik érvényes, azt az adott eszköz paramétertáblája mondja meg:

• true (literál): a séma csak a true értéket fogadja el. Ha elhagyod vagy false-t adsz, a bemenet-ellenőrzés elbukik, és semmi nem megy el.
• logikai, false esetén előnézet: a confirm kötelező. false esetén az eszköz előnézetet ad, és nem hív API-t.
• logikai, false esetén hiba: a confirm kötelező. false esetén az eszköz „Safety gate” hibát ad, és nem hív API-t.
• logikai, alapértelmezés false: a confirm elhagyható. Ha elhagyod vagy false, az eszköz próbafuttatási összegzést ad, és nem hív API-t.

A jelvény azt mutatja, módosít-e adatot az eszköz: a Csak olvasás eszközök csak olvasnak (némelyiknek mégis kell confirm: true, mert fizetős AI-hívást indíthat), az Írás eszközök adatot módosítanak.

Fiók és beállítások

haszno_ping

A GET /api/health végpontot hívja. Csak olvasás

Mikor hívd meg: minden más eszköz előtt, a kapcsolat ellenőrzésére.

Bemeneti paraméterek: nincs.

Visszatérési érték: siker esetén { ok: true }.

Példahívás:

{
  "name": "haszno_ping",
  "arguments": {}
}

haszno_account_get_stats

A bolt irányítópult-pillanatképét adja vissza (GET /api/stats). Csak olvasás

Mikor hívd meg: napi állapotellenőrzés elején, vagy ha a felhasználó áttekintést kér.

Bemeneti paraméterek: nincs.

Visszatérési érték: egy objektum, amelynek mezői:

Példahívás:

{
  "name": "haszno_account_get_stats",
  "arguments": {}
}

haszno_account_get_impact

A Haszno árazásának hatását adja vissza az utolsó N napra (GET /api/impact). Csak olvasás

Mikor hívd meg: ha a felhasználó többletprofitról, haszonjavulásról vagy az automatikus rendeléstovábbításról kérdez.

Bemeneti paraméterek:

Visszatérési érték: { days, extraProfit, baseline, pctGain, orders, autoForwardedOrders } — a pénzértékek bruttó HUF-ban.

Példahívás:

{
  "name": "haszno_account_get_impact",
  "arguments": { "days": 7 }
}

haszno_account_get_settings

A bolt árazási beállításait adja vissza (GET /api/settings). Csak olvasás

Mikor hívd meg: bármilyen árazási változtatás javaslása előtt, és mindig a haszno_account_update_settings előtt.

Bemeneti paraméterek: nincs.

Visszatérési érték: { undercutPct, minMarginPct, vatPct, automationPaused }.

Példahívás:

{
  "name": "haszno_account_get_settings",
  "arguments": {}
}

haszno_account_list_suppliers

A bolt saját beszállítói bekötéseit adja vissza — azokat a beszállítókat, akiknek a katalógusát már importáltad (GET /api/suppliers). Ez nem a hálózati lista; ahhoz a haszno_catalog_list_suppliers kell. Csak olvasás

Bemeneti paraméterek: nincs.

Visszatérési érték: { id, name, orderMode, email, network, category, country, shopUrl, createdAt } objektumok tömbje.

Példahívás:

{
  "name": "haszno_account_list_suppliers",
  "arguments": {}
}

haszno_account_update_settings

Lecseréli a bolt árazási szabályait (PUT /api/settings). Mindhárom számmező kötelező, ezért előbb olvasd ki az aktuális értékeket a haszno_account_get_settings eszközzel, és a nem változó értékeket is küldd vissza. Írás

Bemeneti paraméterek:

Visszatérési érték: a frissített beállítások objektuma.

Példahívás:

{
  "name": "haszno_account_update_settings",
  "arguments": { "undercutPct": 1, "minMarginPct": 12, "vatPct": 27, "confirm": true }
}

haszno_account_configure

A hitelesítési adatokat a ~/.config/haszno/config.json fájlba írja (600-as jogosultsággal), a fájlban már meglévő többi kulcsot megtartva. API-t nem hív. A futó szerver az induláskor betöltött adatokkal dolgozik tovább, ezért utána indítsd újra. Írás

Bemeneti paraméterek:

Az apiKey és a basicAuth közül pontosan egyet adj meg; ha mindkettőt vagy egyiket sem, az eszköz hibát ad.

Visszatérési érték: { saved: true, configFile, apiUrl, authMethod }.

Példahívás:

{
  "name": "haszno_account_configure",
  "arguments": { "apiUrl": "https://haszno.com", "apiKey": "haszno_live_...", "confirm": true }
}

Beszállítói katalógus (haszno_catalog_*)

A partnerhálózat beszállítói, akiket a bolt beköthet. A haszno_catalog_list_categories és a haszno_catalog_list_suppliers is a GET /api/network/suppliers végpontot kéri le, és helyben szűr és lapoz.

haszno_catalog_list_categories

Csak olvasás

Mikor hívd meg: ha érvényes category értékeket keresel a haszno_catalog_list_suppliers és a haszno_catalog_supplier_products eszközhöz.

Bemeneti paraméterek: nincs.

Visszatérési érték: { categories: string[] }, ábécérendben.

Példahívás:

{
  "name": "haszno_catalog_list_categories",
  "arguments": {}
}

haszno_catalog_list_suppliers

Csak olvasás

Bemeneti paraméterek:

Visszatérési érték: { suppliers: [{ id, name, category, country, connected, productCount, avgResellerMarginPct, shopUrl }], total, page, pages }.

Példahívás:

{
  "name": "haszno_catalog_list_suppliers",
  "arguments": { "category": "kert", "limit": 10 }
}

haszno_catalog_supplier_products

Egy partner-beszállító katalógusának termékeit adja vissza (GET /api/network/suppliers/:id/products), helyben szűrve és lapozva. Csak olvasás

Bemeneti paraméterek:

Visszatérési érték: { products: [{ id, sku, name, ean, category, wholesaleNet, rrpGross, stock, potentialMargin }], total, page, pages }. A wholesaleNet nettó HUF; az rrpGross és a potentialMargin.priceGross bruttó HUF.

Példahívás:

{
  "name": "haszno_catalog_supplier_products",
  "arguments": { "supplier_id": 3 }
}

haszno_catalog_supplier_view

A beszállító adatait és termékenként összesített viszonteladói piaci statisztikát ad vissza (GET /api/network/supplier-view/:supplierId): resellerCount, minGross / avgGross / maxGross, belowRrp, lossCount és saturation (0–100). Csak olvasás

Mikor hívd meg: egy beszállító értékelésére, mielőtt bekötöd.

Bemeneti paraméterek:

Példahívás:

{
  "name": "haszno_catalog_supplier_view",
  "arguments": { "supplier_id": 3 }
}

haszno_catalog_connect_supplier

Beköt egy partner-beszállítót, és az összes termékét importálja a boltba (POST /api/network/suppliers/:id/connect). Írás

Bemeneti paraméterek:

Visszatérési érték: { status, imported, skipped }.

Példahívás:

{
  "name": "haszno_catalog_connect_supplier",
  "arguments": { "supplier_id": 3, "confirm": true }
}

haszno_catalog_sync_supplier

Szinkronizálja a beszerzési árakat és a készletet egy bekötött partner-beszállítótól (POST /api/network/suppliers/:id/sync). Írás

Bemeneti paraméterek:

Visszatérési érték: { costChanges, stockOuts, total }.

Példahívás:

{
  "name": "haszno_catalog_sync_supplier",
  "arguments": { "supplier_id": 3, "confirm": true }
}

Partnerkatalógus-keresés és importlista

haszno_catalogue_search

Keres a partner-termékkatalógusban (GET /api/catalogue/products). Csak olvasás

Mikor hívd meg: ha a felhasználó új, listázható termékeket keres.

Bemeneti paraméterek:

Visszatérési érték: { items, total, facets }.

Példahívás:

{
  "name": "haszno_catalogue_search",
  "arguments": { "cats": "kert", "minMarginPct": 20, "inStock": true, "sort": "margin_desc" }
}

haszno_import_list_list

Az importlista elemeit listázza — ez az átmeneti terület a katalógus és a webshop között (GET /api/import-list). Csak olvasás

Bemeneti paraméterek:

Visszatérési érték: { items, total }.

Példahívás:

{
  "name": "haszno_import_list_list",
  "arguments": { "status": "varakozik" }
}

haszno_import_list_add

Katalógustermékeket vesz fel az importlistára (POST /api/import-list). Webshopban addig nem jön létre termék, amíg a haszno_import_list_push le nem fut. Ennek az eszköznek nincs confirm paramétere. Írás

Bemeneti paraméterek:

Visszatérési érték: { added, skipped } — a skipped a listán már szereplő termékeket számolja.

Példahívás:

{
  "name": "haszno_import_list_add",
  "arguments": { "networkProductIds": [101, 102, 103] }
}

haszno_import_list_push

Importlista-elemeket tol ki egy bekötött webshopba. A bekötés állapota kapcsolva kell legyen (ellenőrizd a haszno_connections_list eszközzel). Írás

Bemeneti paraméterek:

Példahívás:

{
  "name": "haszno_import_list_push",
  "arguments": { "ids": [201, 202], "targetConnectionId": 5, "confirm": true }
}

Webshop-bekötések

haszno_connections_list

A bolt webshop-bekötéseit listázza (GET /api/connect/stores); az állapotszűrést helyben végzi. Csak olvasás

Mikor hívd meg: a haszno_import_list_push előtt, a targetConnectionId megkereséséhez.

Bemeneti paraméterek:

Visszatérési érték: { connections: [{ id, platform, name, status, domain, lastError, connectedAt, lastSyncAt }] }.

Példahívás:

{
  "name": "haszno_connections_list",
  "arguments": { "status": "kapcsolva" }
}

Árjavaslatok

haszno_proposals_list

Az árjavaslatokat listázza (GET /api/proposals). A termékszűrést és a lapozást helyben végzi. Csak olvasás

Bemeneti paraméterek:

Visszatérési érték: { _meta: { total, offset, limit, hasMore }, proposals: [{ id, productId, productName, productSku, oldPriceGross, proposedPriceGross, diffGross, reason, source, status, batchId, createdAt, decidedAt }] }.

Példahívás:

{
  "name": "haszno_proposals_list",
  "arguments": { "status": "pending" }
}

haszno_proposals_market

Egy terméket ad vissza a jelenlegi, a javasolt és a piaci áraival, valamint a függő árjavaslataival, a legújabbal kezdve. A GET /api/products és a GET /api/proposals?status=pending végpontot olvassa. Csak olvasás

Mikor hívd meg: mielőtt egy termék árjavaslatait jóváhagyod vagy elutasítod.

Bemeneti paraméterek:

Visszatérési érték: { product: { id, sku, name, supplierName, costNet, stock, listed, current, recommended, market, rrpGross }, pendingProposals: [...] }.

Példahívás:

{
  "name": "haszno_proposals_market",
  "arguments": { "productId": 42 }
}

haszno_proposals_approve

Jóváhagyja az árjavaslatokat, és azonnal alkalmazza az árakat (POST /api/proposals/approve). Mentsd el a visszakapott batchId értéket — a haszno_proposals_rollback eszköznek szüksége van rá. Írás

Bemeneti paraméterek:

Visszatérési érték: { batchId, applied, note }.

Példahívás:

{
  "name": "haszno_proposals_approve",
  "arguments": { "ids": [42, 43], "confirm": true }
}

haszno_proposals_reject

Elutasítja az árjavaslatokat (POST /api/proposals/reject). Az árak nem változnak; az árjavaslatok rejected állapottal megmaradnak az előzményekben. Írás

Bemeneti paraméterek:

Visszatérési érték: { rejected, note }.

Példahívás:

{
  "name": "haszno_proposals_reject",
  "arguments": { "ids": [44], "confirm": true }
}

haszno_proposals_rollback

Visszaállítja a jóváhagyott köteg előtti árakat (POST /api/proposals/rollback); az árjavaslatok állapota rolled_back lesz. Írás

Bemeneti paraméterek:

Visszatérési érték: { rolledBack, note }.

Példahívás:

{
  "name": "haszno_proposals_rollback",
  "arguments": { "batchId": "b-1234abcd", "confirm": true }
}

Automatizálási szabályok

haszno_automation_get

Az automatizálás globális vészkapcsolóját adja vissza (GET /api/automation). Amíg a paused értéke true, az árjavaslatok jóváhagyása HTTP 409-et ad. Csak olvasás

Bemeneti paraméterek: nincs.

Visszatérési érték: { paused: boolean }.

Példahívás:

{
  "name": "haszno_automation_get",
  "arguments": {}
}

haszno_rules_list_templates

A beépített szabálysablonokat listázza (GET /api/rules/templates), például keszlet_or (készlethiány-védelem), arjavaslat (árjavaslat piaci frissítéskor), felar_savok (felársávok) és veszteseg_riasztas (veszteségriasztás). Csak olvasás

Bemeneti paraméterek: nincs.

Visszatérési érték: minden sablon kulcsa, neve, leírása, eseménye, feltételei és műveletei.

Példahívás:

{
  "name": "haszno_rules_list_templates",
  "arguments": {}
}

haszno_rules_list

A bolt automatizálási szabályait listázza (GET /api/rules). Csak olvasás

Bemeneti paraméterek: nincs.

Visszatérési érték: minden szabály azonosítója, neve, bekapcsoltsága, eseménye, feltételei, műveletei, sablonkulcsa és létrehozási dátuma.

Példahívás:

{
  "name": "haszno_rules_list",
  "arguments": {}
}

haszno_rules_list_runs

A szabályfuttatási naplót adja vissza, a legújabbal kezdve (GET /api/rule-runs). A „Levéve” kezdetű összegzésű bejegyzések levételek, amelyeket a haszno_rules_undo_unlists visszacsinálhat. Csak olvasás

Bemeneti paraméterek:

Visszatérési érték: bejegyzések futásazonosítóval, szabályazonosítóval, szabálynévvel, eseménnyel, termékazonosítóval (vagy null), összegzéssel és időbélyeggel.

Példahívás:

{
  "name": "haszno_rules_list_runs",
  "arguments": { "limit": 10 }
}

haszno_rules_create

Létrehoz egy szabályt (POST /api/rules). Írás

Bemeneti paraméterek:

Visszatérési érték: a létrehozott szabály az id mezővel.

Példahívás:

{
  "name": "haszno_rules_create",
  "arguments": {
    "name": "Unlist when out of stock",
    "trigger": "feed_import",
    "conditions": [{ "field": "stock", "op": "lte", "value": 0 }],
    "actions": [{ "type": "unlist" }],
    "confirm": true
  }
}

haszno_rules_update

Módosít egy szabályt (PATCH /api/rules/:id). Csak az elküldött mezők változnak. Írás

Bemeneti paraméterek:

Példahívás:

{
  "name": "haszno_rules_update",
  "arguments": { "id": 7, "enabled": false, "confirm": true }
}

haszno_rules_delete

Véglegesen törli a szabályt és a teljes futási előzményét (DELETE /api/rules/:id). Nem vonható vissza; ha csak megállítanád, használd a haszno_rules_update eszközt enabled: false értékkel. Írás

Bemeneti paraméterek:

Példahívás:

{
  "name": "haszno_rules_delete",
  "arguments": { "id": 7, "confirm": true }
}

haszno_rules_run

Egy szabályt futtat az összes érintett terméken, az eseményétől függetlenül (POST /api/rules/:id/run). Írás

Bemeneti paraméterek:

Visszatérési érték: { applied, skipped, errors }.

Példahívás:

{
  "name": "haszno_rules_run",
  "arguments": { "id": 7, "confirm": true }
}

haszno_rules_run_all

Minden bekapcsolt, manual eseményű szabályt lefuttat (POST /api/rules/run-all). Írás

Bemeneti paraméterek:

Visszatérési érték: összesített { applied, skipped, errors }.

Példahívás:

{
  "name": "haszno_rules_run_all",
  "arguments": { "confirm": true }
}

haszno_rules_trigger

Lefuttat minden bekapcsolt szabályt, amely az adott eseményre figyel (POST /api/rules/trigger). Írás

Bemeneti paraméterek:

Visszatérési érték: összesített { applied, skipped, errors }.

Példahívás:

{
  "name": "haszno_rules_trigger",
  "arguments": { "trigger": "market_price", "confirm": true }
}

haszno_rules_undo_unlists

Visszalistázza a szabály által levett termékeket, és a naplóbejegyzéseket visszavontként jelöli (POST /api/rule-runs/undo). Csak a „Levéve” kezdetű összegzésű, még vissza nem vont bejegyzésekre hat. Írás

Bemeneti paraméterek:

Visszatérési érték: { relisted }.

Példahívás:

{
  "name": "haszno_rules_undo_unlists",
  "arguments": { "ids": [311, 312], "confirm": true }
}

haszno_automation_set

Be- vagy kikapcsolja az automatizálás globális vészkapcsolóját (PUT /api/automation). Az aktuális állapot újbóli beállítása ártalmatlan. Írás

Bemeneti paraméterek:

Visszatérési érték: { paused }.

Példahívás:

{
  "name": "haszno_automation_set",
  "arguments": { "paused": true, "confirm": true }
}

Rendelések

A pénzértékek egész forintok, bruttó. Rendelésállapotok: received, forwarded, shipped, error.

haszno_orders_list

A GET /api/orders végpontot kéri le, és tömör sorokat ad vissza eseménynapló nélkül; az állapotszűrést és a korlátot helyben alkalmazza. Csak olvasás

Bemeneti paraméterek:

Visszatérési érték: { orders: [{ id, externalId, customerName, address, status, totalGross, supplierOrderId, trackingNumber, itemCount, createdAt }], total, showing }.

Példahívás:

{
  "name": "haszno_orders_list",
  "arguments": { "status": "forwarded" }
}

haszno_orders_get

Egy rendelést ad vissza a tételeivel, eseménynaplójával, beszállítói rendelésazonosítójával és nyomkövetési számával. A GET /api/orders által visszaadott listában keres. Csak olvasás

Bemeneti paraméterek:

Példahívás:

{
  "name": "haszno_orders_get",
  "arguments": { "id": 123 }
}

haszno_orders_ship

Feladottnak jelöl egy rendelést (POST /api/orders/:id/ship). forwarded állapotú rendelésekhez használd; egy már feladott rendelésen újra hívni biztonságos. Írás

Bemeneti paraméterek:

Visszatérési érték: a frissített rendelés.

Példahívás:

{
  "name": "haszno_orders_ship",
  "arguments": { "id": 123, "confirm": true }
}

haszno_orders_receive

Új rendelést küld a továbbítási folyamatba (POST /api/webhooks/order). Minden SKU-nak már léteznie kell a bolt termékei között. Írás

Bemeneti paraméterek:

Visszatérési érték: az új rendelés { id } értéke.

Példahívás:

{
  "name": "haszno_orders_receive",
  "arguments": {
    "externalId": "WC-9001",
    "customerName": "Kovács János",
    "address": "Budapest, Fő utca 1.",
    "items": [{ "sku": "DEMO-5", "qty": 2 }],
    "confirm": true
  }
}

haszno_orders_create_demo

Véletlenszerű demórendelést hoz létre készleten lévő termékekből (POST /api/demo/order). Írás

Bemeneti paraméterek:

Visszatérési érték: az új rendelés { id } értéke.

Példahívás:

{
  "name": "haszno_orders_create_demo",
  "arguments": { "confirm": true }
}

Termékötletek

haszno_ideas_list

Lekéri a GET /api/recommendations végpontot, majd helyben szűr, trendpontszám és haszon szerint rendez, és korlátoz. Csak olvasás

Bemeneti paraméterek:

Visszatérési érték: { anchor, geo, total, filtered, truncated, items: [{ rank, id, sku, name, supplier, stock, costNet_HUF, suggestedPriceGross_HUF, marginNet_HUF, marginPct, trendScore }] }.

Példahívás:

{
  "name": "haszno_ideas_list",
  "arguments": { "min_score": 50, "limit": 10 }
}

haszno_ideas_ai_shortlist

Legfeljebb 5, a bolthoz legjobban illő terméket kér az AI-tól (POST /api/recommendations/ai). Adatot nem módosít, de fizetős AI-hívást indíthat; változatlan bemenetnél a szerver 24 órán át gyorsítótárazott eredményt ad (cached: true). Csak olvasás

Bemeneti paraméterek:

Visszatérési érték: { summary, cached, picks: [{ productId, networkProductId, name, supplier, recommendedPriceGross_HUF, marginNet_HUF, marginPct, fit, aiReason }], usage }.

Példahívás:

{
  "name": "haszno_ideas_ai_shortlist",
  "arguments": { "confirm": true }
}

haszno_ideas_ai_description

Magyar webshopos termékleírást generál a bolt egyik termékéhez (POST /api/products/:id/ai-description). A szöveget csak visszaadja, nem menti. Fizetős AI-hívást indít. Csak olvasás

Bemeneti paraméterek:

Visszatérési érték: { product_id, description }.

Példahívás:

{
  "name": "haszno_ideas_ai_description",
  "arguments": { "product_id": 55, "confirm": true }
}

haszno_ideas_fill_keywords

AI-val kitölti a Google Trends-kulcsszót minden olyan terméknél, amelynek még nincs, és el is menti (POST /api/trends/keywords). Ha nincs hiányzó kulcsszó, újrafuttatva { updated: 0 } értéket ad. Írás

Bemeneti paraméterek:

Visszatérési érték: { updated }.

Példahívás:

{
  "name": "haszno_ideas_fill_keywords",
  "arguments": { "confirm": true }
}

Feedek

A feed tartalmát szövegként a content mezőben adhatod át, vagy az MCP-szerver beolvassa a filePath útvonalról. A filePath csak .csv, .tsv, .txt vagy .xml végű lehet, és nem lehet rejtett mappában (például ~/.ssh vagy ~/.config).

haszno_feeds_import_supplier

Beszállítói katalógusfeedet importál (POST /api/feeds/import): létrehozza az új termékeket, SKU alapján frissíti a meglévőket, majd lefuttatja a feed_import szabályokat. Írás

Bemeneti paraméterek:

Visszatérési érték: { created, updated, total }.

Példahívás:

{
  "name": "haszno_feeds_import_supplier",
  "arguments": { "supplierId": 3, "format": "csv", "content": "sku,name,price\nABC-1,Widget,2990", "confirm": true }
}

haszno_feeds_import_market

Versenytársi piaci árakat importál CSV-ből (POST /api/market-prices/import), a sorokat SKU alapján párosítja a termékekhez, majd lefuttatja a market_price szabályokat. Ugyanazt a CSV-t újraimportálva ugyanazok az értékek állnak be. Írás

Bemeneti paraméterek:

Visszatérési érték: { matched, total }.

Példahívás:

{
  "name": "haszno_feeds_import_market",
  "arguments": { "content": "sku,market_price\nABC-1,2890", "confirm": true }
}

haszno_feeds_outbound_info

A bolt nyilvános feedjeinek címét adja vissza: <base>/feed/arukereso.xml és <base>/feed/google.xml, ahol a <base> a HASZNO_API_URL / ARFUTAR_API_URL értéke, alapértelmezésben https://haszno.com. Csak olvasás

Bemeneti paraméterek:

Visszatérési érték: { arukereso_url, google_url, note }, vagy fetch_summary: true esetén { arukereso: { url, item_count, sample }, google: { url, item_count, sample } } (ha egy feed nem tölthető le, a számok helyett error mező áll).

Példahívás:

{
  "name": "haszno_feeds_outbound_info",
  "arguments": { "fetch_summary": true }
}

P2P partner-meghívók

haszno_peers_invite_list

Az általad létrehozott meghívókódokat listázza (GET /api/peers/invites). Csak olvasás

Bemeneti paraméterek: nincs.

Visszatérési érték: { invites: [...] }; minden meghívónak van code, supplierId, expiresAt, acceptedBy (függőben null) és revokedAt (aktívan null) mezője.

Példahívás:

{
  "name": "haszno_peers_invite_list",
  "arguments": {}
}

haszno_peers_invite_create

Egyszer használható meghívókódot hoz létre, amellyel egy másik Haszno-bolt hozzáfér az egyik beszállítód katalógusához (POST /api/peers/invites). Írás

Bemeneti paraméterek:

Visszatérési érték: { code, expiresAt, supplierId }.

Példahívás:

{
  "name": "haszno_peers_invite_create",
  "arguments": { "supplierId": 3, "expiresAt": "2027-01-01T00:00:00Z", "confirm": true }
}

haszno_peers_invite_accept

Elfogad egy meghívókódot, és partnerkapcsolatot hoz létre (POST /api/peers/invites/:code/accept). A kód ezután érvénytelen. Írás

Bemeneti paraméterek:

Visszatérési érték: az új kapcsolat: { id, supplierId, partner, createdAt }.

Példahívás:

{
  "name": "haszno_peers_invite_accept",
  "arguments": { "code": "INV-XYZ", "acceptorId": "my-shop", "confirm": true }
}

Blog / piaci betekintők

haszno_blog_latest

A legutóbb közzétett piaci betekintő bejegyzéseket adja vissza (GET /api/blog). Az adatok legalább 5 bolt összesítéséből származnak; egyetlen bolt adata sem szerepel bennük. Csak olvasás

Bemeneti paraméterek:

Visszatérési érték: { posts, total }; minden bejegyzésnek van title, summary, bodyMd, period, periodStart, periodEnd, publishedAt és opcionális data mezője.

Példahívás:

{
  "name": "haszno_blog_latest",
  "arguments": { "period": "het", "limit": 3 }
}

Tervezett eszközök

A saját bolti termékek eszközei szerepelnek a skill references/tools.md fájljában, de az MCP-szerver még egyiket sem regisztrálja. Meghívásuk „tool not found” hibát ad.

Amíg ezek az eszközök nem érhetők el, használd a CLI megfelelőit: haszno products list, haszno products update, haszno products listing, haszno products apply-prices, haszno products describe.

Kapcsolódó témák

• CLI-referencia — ugyanezek a műveletek a terminálból.
• Agent skill — munkafolyamat-receptek és biztonsági szabályok agentek számára.
• Hitelesítés — API-kulcs és demó-hozzáférési adatok részletei.
• Hibák és sebességkorlátok — hibaséma és újrapróbálkozási útmutató.