# Áttekintés

> A Haszno egy fejlesztői előzetesben lévő magyar dropshipping SaaS. HTTP API-t, CLI-t, MCP-szervert és agent skillt kínál integrálóknak és AI-agenteknek.

## Mit csinál a Haszno

A Haszno magyar webshop-tulajdonosokat köt össze dropshipping-beszállítókkal. Figyeli a versenytársak piaci árait, minden termékhez ajánlott eladási árat számol, és automatikusan frissíti a csatlakoztatott webshopokban a listázásokat. A bejövő vevőrendeléseket a megfelelő beszállítónak továbbítja.

Fejlesztőként vagy integrálóként négy felületen keresztül kezeled a Hasznót:

| Felület | Mi ez | Mire a legjobb |
|---|---|---|
| **HTTP API** | REST API a `https://haszno.com` címen | Egyedi integrációk, webhookok, szerveroldali automatizálás |
| **CLI** | `haszno` parancssori eszköz (Node.js, `npx`-szel futtatható) | Shell-szkriptek, cron-feladatok, Codex, Cursor terminál |
| **MCP-szerver** | stdio MCP-szerver (`haszno-mcp`) | Claude Code, Claude Desktop, bármilyen MCP-kompatibilis AI-kliens |
| **Agent skill** | Claude Code-ba telepíthető útmutatófájlok | Megtanítja az AI-agentnek a domain-modellt, a biztonsági szabályokat és a munkafolyamat-recepteket |

## Mit tehetsz ma

> [!NOTE]
> A Haszno **Fejlesztői előzetesben** van. Az API-nak nincs verzióprefixe. Visszafelé nem kompatibilis változások előzetes értesítés nélkül is előfordulhatnak. Lásd a [Changelog és verziózás](changelog.md) oldalt a kivezetési tervért.

**Hitelesítési adatok nélkül** olvashatod az összes nyilvános demóvégpontot — kategóriák, termékek, árazási adatok, beszállítólista, Haszon-mérő összefoglalója, beállítások és még sok más. Az összes visszaadott adat szintetikus, a demóhoz generált példaadat. A `/api/settings` és `/api/impact` válaszokban szerepel a `"demo": true` mező; más demóvégpontok (kategóriák, termékek stb.) ezt a jelzőt nem tartalmazzák.

**Belépési munkamenettel** (regisztrálhatsz a `https://haszno.com` oldalon) kezelheted saját API Bearer-tokeneidet, de a `haszno.com`-on futó hosztolt demóban az adatvégpontok továbbra is szintetikus demóadatot adnak vissza. Önálló regisztrációval a teljes, boltonkénti adat még nem érhető el.

**A Haszno csapatától kapott HTTP Basic hitelesítési adatokkal** teljes olvasási és írási hozzáférést kapsz a megosztott demótelepítéshez, beleértve a rendelésbeküldést, szabálykezelést és feed-importot.

**Saját telepítésen** a saját kulcsoddal véded az API-t: állítsd be a szerveren a `HASZNO_API_KEY`-t, a kliensek (köztük a CLI és az MCP-szerver) pedig az `x-api-key` fejlécben küldik. Hogy ma hol fogad el az API Bearer-tokent, azt a [Hitelesítés](authentication.md) oldal írja le.

A részletekért lásd a [Hitelesítés](authentication.md) oldalt.

## Alap URL

A dokumentáció összes példájában `https://haszno.com` szerepel alap URL-ként.

## Böngészd a dokumentációt

<div class="entry-cards">
  <a class="entry-card" href="quickstart.html">
    <span class="card-icon" aria-hidden="true">↗</span>
    <span class="card-arrow" aria-hidden="true">→</span>
    <strong>Gyors kezdés</strong>
    <p>Küldd el az első API-kérésedet két percen belül — hitelesítési adatok nélkül.</p>
  </a>
  <a class="entry-card" href="api-reference.html">
    <span class="card-icon" aria-hidden="true">{ }</span>
    <span class="card-arrow" aria-hidden="true">→</span>
    <strong>API-referencia</strong>
    <p>Minden nyilvános végpont: paraméterek, válaszmezők és másolható példák.</p>
  </a>
  <a class="entry-card" href="agents.html">
    <span class="card-icon" aria-hidden="true">&gt;_</span>
    <span class="card-arrow" aria-hidden="true">→</span>
    <strong>CLI és MCP</strong>
    <p>Telepítsd a CLI-t vagy az MCP-szervert, és kezdd el automatizálni a boltodat terminálból vagy AI-agenttel.</p>
  </a>
  <a class="entry-card" href="authentication.html">
    <span class="card-icon" aria-hidden="true">#</span>
    <span class="card-arrow" aria-hidden="true">→</span>
    <strong>Hitelesítés</strong>
    <p>Hogyan működnek a hitelesítési adatok — a hitelesítés nélküli demóolvasástól az API-kulcsokig és a Bearer-tokenekig.</p>
  </a>
</div>