====== Social Flow: AI přístup k Meta platformám ======

[[https://x.com/themattberman/status/2027220216409723296?s=46&t=TtlDajwieYswAAwtrnA-ow|Příspěvek na X]], který mě na to navedl, odkazuje na [[https://github.com/vishalgojha/social-flow|Social Flow]]. Podle README jde o deterministické CLI pro workflow nad Meta platformami, tedy hlavně pro Facebook, Instagram, WhatsApp a Ads Manager. Z pohledu AI je zajímavé tím, že vedle klasických příkazů nabízí i práci v přirozeném jazyce přes ''social ai'', agentický terminál ''social hatch'' a SDK vrstvu pro další integrace.

===== Co je Social Flow =====

[[https://github.com/vishalgojha/social-flow|Social Flow]] se v repozitáři popisuje jako deterministické CLI pro operace nad Meta ekosystémem. Cílem není jen obalit API několika příkazy, ale sjednotit běžné operace kolem profilů, příspěvků, reklamních účtů a související konfigurace do jednoho rozhraní.

Prakticky je důležité hlavně toto:

  * používá binárku ''social''
  * ukládá stav do ''~/.social-flow/config.json''
  * umí migrovat starší konfigurace z ''~/.social-cli/config.json'' a ''~/.meta-cli/config.json''
  * vedle CLI má i další vrstvy, například Hatch UI a SDK

Základní quickstart vypadá podle [[https://github.com/vishalgojha/social-flow/blob/main/QUICKSTART.md|QUICKSTART.md]] takto:

<code bash>
npm install -g @vishalgojha/social-flow
social onboard
social doctor
social status
</code>

===== Proč je to zajímavé pro AI =====

Pro AI použití je zajímavé, že projekt nepočítá jen s ručně psanými CLI příkazy. README přímo ukazuje režim ''social ai'', kde se zadává požadavek v přirozeném jazyce.

<code bash>
social ai --provider deterministic "list ads account act_123"
social ai --provider ollama "get my facebook profile"
</code>

Podle [[https://github.com/vishalgojha/social-flow/blob/main/PROJECT_SUMMARY.md|PROJECT_SUMMARY.md]] má být Social Flow spíš spolehlivá exekuční vrstva pro Meta operace než jen tenká API obálka. Dokument zároveň výslovně zmiňuje použití pro lidské operátory i autonomní agenty. To je přesně důvod, proč to dává smysl v AI sekci wiki: nejde jen o marketingový nástroj, ale o rozhraní, přes které může AI bezpečněji plánovat a provádět konkrétní akce nad Meta službami.

===== Jaký přístup projekt používá =====

Podle README a quickstartu je základní workflow postavené na tom, že se nejdřív provede onboarding a kontrola lokální připravenosti. Při ''social onboard'' se nastavují tokeny, výchozí hodnoty a AI provider. Dokumentace zároveň uvádí, že se při onboardingu standardně připravuje i Chromium pro browser automation, pokud se nepoužije volba ''--skip-browser''.

Projekt pak sjednocuje několik typů práce:

  * běžné dotazy a operace nad profilem, účty, příspěvky a reklamami
  * agentický terminál přes ''social hatch''
  * opakování a audit operací přes logy a replay
  * napojení do dalších systémů přes gateway a SDK

[[https://github.com/vishalgojha/social-flow/blob/main/sdk/README.md|SDK README]] navíc ukazuje, že nad gateway vrstvou existuje i typed klient pro TypeScript. Zajímavé je hlavně to, že pracuje s modelem ''plan'' a ''execute'' a vrací metadata jako ''risk'' nebo ''requiresApproval''. To naznačuje, že projekt počítá s řízeným prováděním akcí, ne jen s bezhlavým posíláním požadavků na API.

===== K čemu se to může hodit =====

Z dostupné dokumentace dávají smysl hlavně tyto scénáře:

  * AI nebo operátor potřebuje jednotné rozhraní pro práci s Meta účty bez psaní vlastních skriptů nad Graph API
  * tým chce mít jeden nástroj pro onboarding, kontrolu stavu, práci s účty a základní operace nad obsahem nebo reklamami
  * vývojář chce volat Meta operace z vlastního nástroje přes SDK místo přímého řešení jednotlivých API detailů
  * agentický workflow potřebuje krok plánování a schvalování před tím, než se provede rizikovější akce

Zajímavé je i to, že projekt výslovně zmiňuje Facebook, Instagram, WhatsApp a Ads Manager. Nejde tedy o obecný konektor na všechny sociální sítě, ale o poměrně konkrétní vrstvu nad Meta stackem.

===== Omezení a poznámky =====

  * Z veřejné dokumentace je zřejmé, že projekt míří hlavně na ''Meta operations'', ne na univerzální obsluhu všech sociálních sítí.
  * Pro použití je potřeba projít token setupem a mít přístup k příslušným Meta nástrojům a účtům.
  * Projekt je CLI a self-hosted orientovaný, takže dává větší smysl technicky zaměřenému uživateli nebo týmu než někomu, kdo hledá jednoduchou klikací SaaS aplikaci.
  * Licencování je podle README open-core: základ je pod MIT, ale část repozitáře má komerční licenci.

===== Zdroje =====

  * [[https://x.com/themattberman/status/2027220216409723296?s=46&t=TtlDajwieYswAAwtrnA-ow|Příspěvek na X, který mě na projekt navedl]]
  * [[https://github.com/vishalgojha/social-flow|Social Flow na GitHubu]]
  * [[https://github.com/vishalgojha/social-flow/blob/main/QUICKSTART.md|Social Flow – QUICKSTART.md]]
  * [[https://github.com/vishalgojha/social-flow/blob/main/PROJECT_SUMMARY.md|Social Flow – PROJECT_SUMMARY.md]]
  * [[https://github.com/vishalgojha/social-flow/blob/main/sdk/README.md|Social Flow SDK README]]