---
title: "posty-cli: a parancssori eszköz | Posty dokumentáció"
description: "Telepítés, a kimeneti szerződés, a dátumkezelés, és mire jó egy parancssori eszköz egy ütemezőhöz."
canonical: https://posty.hu/dokumentacio/cli
source: https://posty.hu/dokumentacio/cli.md
---

Parancssor (CLI)

# posty-cli: a parancssori eszköz

Telepítés, a kimeneti szerződés, a dátumkezelés, és mire jó egy parancssori eszköz egy ütemezőhöz.

## Telepítés

Csomag

`posty-cli`

Parancs

`posty`

Telepítés

`npm install -g posty-cli`

Elérhetőség

A Pro csomagtól, ugyanaz a jogosultság, mint az API-nál. Lásd a [Csomagok](https://posty.hu/dokumentacio/csomagok) oldalt.

```
npm install -g posty-cli
posty --version
posty --help
```

Kód másolása

## Az első parancsok

```
posty auth:login          # böngészős bejelentkezés
posty auth:status         # melyik munkaterülethez van kötve a gép
posty integrations:list   # a bekötött csatornák, azonosítóval
```

Kód másolása

A csatornaazonosítót minden más parancs ezzel a névvel kéri. Írd ki egyszer, és tedd el.

## A kimeneti szerződés

JSON a kimenetre, minden más a hibakimenetre

Az eredmény JSON-ként a szabványos kimenetre megy, az állapotüzenetek és a hibák a hibakimenetre, és sikertelen futásnál a parancs nem nullával lép ki. Ez az, ami miatt a kimenet biztonságosan továbbadható más parancsoknak, a hívó program pedig tudja, mi történt.

```
# csak a csatornaazonosítók
posty integrations:list | jq -r '.[].id'

# ütemezett futásban a hibák a naplóba mennek, a JSON a feldolgozónak
posty posts:list --startDate ... --endDate ... > naptar.json 2>> hiba.log
```

Kód másolása

## Dátumok és időzónák

A dátumot mindig egyértelműen add meg. Két helyes alak van:

- **ISO 8601 kifejezett eltolással:** `2026-12-31T12:00:00Z` vagy `2026-12-31T12:00:00+01:00`.
- **Eltolás nélküli időpont, megadott időzónával:** `"2026-12-31 12:00"` a `--timezone Europe/Budapest` kapcsolóval.

A találgatás helyett hiba

Ha eltolás nélküli dátumot adsz meg, és nincs időzóna sem a kapcsolóban, sem a `POSTY_TIMEZONE` változóban, sem a `posty config:set timezone` beállításban, a parancs hibával áll le. Ez szándékos: a csendben rossz órára tett bejegyzés sokkal rosszabb, mint egy hibaüzenet.

```
posty config:set timezone Europe/Budapest
posty config:get timezone
```

Kód másolása

## Ügynököknek

A csomag tartalmaz egy `SKILL.md` fájlt, amely minden parancsot és kapcsolót leír. Egy terminálhoz férő ügynök ebből tanulja meg a használatot, weboldal olvasása nélkül.

Ha az ügynököd nem shellből dolgozik, hanem közvetlenül csatlakozna, használd inkább az [MCP-szervert](https://posty.hu/dokumentacio/mcp).

## Parancsok

[Hitelesítés — auth:login, auth:status, auth:logout, API-kulcs változóból.](https://posty.hu/dokumentacio/cli/hitelesites)[Bejegyzések — posts:create, posts:list, posts:status, posts:delete, find-slot.](https://posty.hu/dokumentacio/cli/bejegyzesek)[Csatornák — integrations:list, settings, trigger, groups.](https://posty.hu/dokumentacio/cli/csatornak)[Analitika — analytics:platform, analytics:post, posts:missing.](https://posty.hu/dokumentacio/cli/analitika)[Médiafeltöltés — upload, és hogyan kerül a fájl a bejegyzésbe.](https://posty.hu/dokumentacio/cli/feltoltes)[Platformpéldák — Kész parancsok X-, YouTube-, TikTok- és többcsatornás bejegyzésekhez.](https://posty.hu/dokumentacio/cli/peldak)

Dokumentációs oldalak

Hiányzik valami erről az oldalról? Írj a [norbert@posty.hu](mailto:norbert@posty.hu) címre, vagy használd a [Segítség](https://posty.hu/segitseg) oldal űrlapját.
