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.

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 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.

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.

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.

• 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.

• Příspěvek na X, který mě na projekt navedl
• Social Flow na GitHubu
• Social Flow – QUICKSTART.md
• Social Flow – PROJECT_SUMMARY.md
• Social Flow SDK README