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

Příspěvek na X, který mě na to navedl, odkazuje na 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

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 QUICKSTART.md takto:

npm install -g @vishalgojha/social-flow
social onboard
social doctor
social status

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.

social ai --provider deterministic "list ads account act_123"
social ai --provider ollama "get my facebook profile"

Podle 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

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.

Obsah