MARCØ
Un'agenzia digitale automatizzata che non assume nessuno. Brand, sito, contenuti, posting social e analytics gestiti da un sistema agentico LLM-agnostico, in modalità SaaS multi-tenant, con un loop di apprendimento federato che migliora ogni tenant grazie agli esiti anonimi di tutti gli altri.
TL;DR §00
MARCØ è la prima agenzia digitale che si configura sola e migliora con l'uso collettivo dei clienti. Una PMI dice in chat «caffetteria specialty a Milano per giovani professionisti» e in meno di tre minuti riceve: nome di marca, tagline, palette, sito web pubblicato su CDN globale, calendario editoriale per Instagram/LinkedIn/TikTok, e tracking analytics che chiude il loop col macro-agente strategico.
Sotto il cofano: orchestrazione LangGraph (macro-agent strategici), execution OpenSwarm sidecar (10 agenti specialisti come microservizio Docker isolato), LiteLLM per routing multi-provider (Anthropic, OpenAI, Google, Groq, Ollama locale, OpenRouter), Cloudflare Pages per il deploy automatico dei siti generati, Composio per il posting su 10k+ servizi. Tutto in produzione su infrastruttura europea GDPR-compliant.
Cosa fa §01
MARCØ chiude l'intero ciclo del marketing digitale per piccole e medie imprese in autonomia. Niente brief, niente kickoff call, niente settimane di onboarding.
I 5 deliverable concreti
Brand kit completo in 40 secondi
Nome di marca, tagline, palette colori (primario/secondario/accent/neutri), tipografia consigliata, tone of voice, moodboard keywords. Generato da Claude Opus 4.7 con un sistema di prompt versionati e validati su 50+ test case.
Landing page production-grade deployata su CDN globale
HTML semantico, CSS responsive con palette brand, SEO ready (meta, OG, structured data JSON-LD), accessibility AA, <30KB totali. Deploy automatico su Cloudflare Pages via flow Direct Upload 3-step. URL live in <3 minuti dalla chat.
30 post/mese su Instagram, LinkedIn, TikTok, YouTube
Copy multi-canale generato con conoscenza dei limiti per piattaforma, varianti A/B, immagini via fal.ai (flux-pro / SDXL-fast) e video via Sora/Veo/Seedance. Calendario editoriale ottimizzato per ICP e tone of voice del brand.
Pubblicazione automatica via Composio (10k+ integrazioni)
OAuth per-tenant su IG/LI/TT/YT + altri. Scheduling, posting, error retry. Niente Zapier, niente n8n, niente manodopera. Human-in-the-loop opzionale per tier Starter/Growth.
Metriche cross-channel che chiudono il loop strategico
Meta Ads + Google Ads + IG Insights + LinkedIn Analytics + YouTube Analytics raccolte e aggregate. L'Analytics Agent non si limita a riportare i numeri: identifica pattern, suggerisce cambi strategici, e li propaga ai macro-agent per la prossima iterazione.
Come lo fa §02
L'architettura è un microkernel agentico con tre layer separati: orchestrazione strategica (Python/LangGraph), execution operativa (OpenSwarm sidecar Docker), e routing LLM intelligente (LiteLLM).
Pattern fork+overlay per OpenSwarm
OpenSwarm è un fork di VRSEN/OpenSwarm (basato su Agency Swarm) che vive come microservizio Docker sidecar, mai esposto pubblicamente. Il codice upstream è FROZEN in openswarm/src/: le modifiche MARCØ vivono in openswarm/overlay/ come subclass/extension, oppure in openswarm/patches/ come diff documentate. Ogni sync upstream richiede review manuale + eval suite completa prima del bump del commit pinato.
Workflow strutturati con registry
I task complessi (es. "genera brand kit + sito + posting") sono pipeline registrate in packages/api/agents/workflows.py come sequenze ordinate di chiamate ad agent. L'output di ogni step contribuisce all'input del successivo via callable input_builder. SSE streaming per ogni step → progress visibile in real-time davanti al cliente.
| Workflow | Step | Tempo | Costo |
|---|---|---|---|
brand_kit_basic | market_research → brand_identity | 40s | $0.026 |
site_launch | market_research → brand_identity → seo → site_builder + CF deploy | ~3min | $0.160 |
social_post M5 | content_creator → visual → social_automation | ~2min | $0.05 |
content_calendar M5 | strategist macro + 30 post + scheduling | ~15min | $1.20 |
Perché vince §03
Il mercato del marketing automation è affollato. Ma MARCØ non compete sullo stesso terreno di nessuno.
Vs. agenzie tradizionali
Un'agenzia digitale boutique addebita €2k–€10k/mese per un cliente PMI, con tempi di delivery in settimane e bottleneck umani su ogni hand-off. MARCØ fa lo stesso lavoro in minuti, h24, al costo di €29/mese in tier entry. Non sostituisce il team creativo senior — sostituisce le 8–10 risorse junior che fanno l'esecuzione operativa.
Vs. HubSpot / Mailchimp / Hootsuite
Quelli sono tool: ti danno la dashboard, devi avere il team che la usa. MARCØ è un operatore: il team è dentro la piattaforma. Non chiede al cliente di scrivere il post — lo genera, lo pubblica, lo analizza, e nella prossima iterazione cambia approccio se non funziona.
Vs. Wix AI / Squarespace AI / Webflow AI
Sono website builder AI-assistiti, fermi al sito. MARCØ fa il sito come uno dei 5 deliverable, e il sito è conseguenza della strategia (market research + brand identity + SEO), non punto di partenza generico.
Vs. AI agent platform generiche (CrewAI, AutoGPT, Make.com AI)
Quelle sono framework per costruirti i tuoi agent. MARCØ è un'agenzia chiavi in mano: gli agent sono già configurati, validati con eval suite (90%+ pass rate per ogni agente prima della promotion), e specializzati sul dominio marketing digitale per PMI italiane.
Federated Intelligence Loop
Quando il cliente A pubblica 10 post e l'Analytics Agent rileva che gli A/B con tagline più diretta hanno +35% engagement, quella conoscenza — anonimizzata via k-anonymity (k≥5) + differential privacy, criptata AES-256-GCM, mai un dato sensibile — viene aggregata sul Federated Hub. Quando il backtester conferma significatività statistica, il prompt versioning sale di una minor (v1.0 → v1.1) e il cliente B parte già col prompt migliorato. Ogni cliente migliora grazie a tutti gli altri, senza condividere niente.
Nessun competitor lo fa. HubSpot ha dati ma li tiene per sé. Le agenzie hanno conoscenza ma non scala. MARCØ scala la conoscenza in modo legalmente sicuro.
Vs. tutto il mercato: l'argomento di costo
| Approccio | Costo/mese PMI | Time-to-launch | Migliora con l'uso? |
|---|---|---|---|
| Agenzia tradizionale | €2k–€10k | 4–8 settimane | Solo se cambi staff |
| HubSpot + freelance | €800–€1.5k | 2–4 settimane | No |
| Wix + ChatGPT manuale | €50–€200 | 3–7 giorni | No |
| MARCØ Starter | €29 | <3 minuti | Sì, federated |
| MARCØ Growth | €69 | <3 minuti | Sì, federated |
I 10 agenti §04
L'orchestrator master è un'istanza LangGraph che coordina tre macro-agent strategici. Ogni macro-agent delega tasks operativi ai 10 specialisti dell'OpenSwarm sidecar via HTTP interno (http://openswarm:8080, rete Docker isolata).
Mapping macro → specialisti
| Macro-Agent | Specialisti delegati | Output principali |
|---|---|---|
| Strategist | Market Research + Brand Identity + SEO | Segmenti, competitor, brand kit, keyword strategy |
| Content | Content Creator + Visual + Video | Copy multi-canale, immagini, video brevi |
| Executor | Site Builder + Social Automation + Analytics | Sito live, post pubblicati, metriche |
Specialisti in dettaglio
01 · Market Research
Tavily search + Firecrawl scraping + LLM synthesis. Identifica segmenti ICP, competitor diretti/indiretti, trend di mercato, opportunità e minacce. Output strutturato JSON con sources reali.
02 · Brand Identity
Claude Sonnet 4.6 (via OpenRouter). Brief utente + segmenti da market research → brand name, tagline, palette (primary/secondary/accent/neutral_dark/neutral_light), tone of voice, logo brief. Opzionalmente invoca Visual Agent per generare 3 varianti logo.
03 · SEO
Keyword research con intent classification (informational/navigational/transactional/local), long-tail prioritization (le PMI non possono competere su head terms), meta tags per pagina, JSON-LD structured data (Organization + LocalBusiness), internal linking suggestions.
04 · Site Builder
Genera index.html self-contained (CSS+JS inline), robots.txt, sitemap.xml. Deploy automatico su Cloudflare Pages via flow Direct Upload 3-step Wrangler-like: (1) GET upload-token JWT, (2) POST /pages/assets/upload bulk, (3) POST /deployments con manifest. URL live in <30s post-generazione.
05 · Content Creator
Copy multi-canale con awareness dei limiti piattaforma (IG caption 2200 char, LinkedIn 3000, TikTok 2200, YouTube description 5000). Hook personalizzati per ICP, varianti A/B, CTA contestuali.
06 · Visual
Image gen via fal.ai (flux-pro per hero, SDXL-fast per post ricorrenti) o OpenAI gpt-image-1 fallback. Rotation provider per cost/quality. Brand palette propagata in prompt.
07 · Video
Generation via fal.ai (Sora 2 / Veo 3 / Seedance) per reels, shorts, YouTube intro. Budget cap per-tenant (default €10/mese) con abort hard se superato.
08 · Social Automation
Posting via Composio (10k+ integrazioni, scope minimo IG/LI/TT/YT). OAuth per-tenant, token mai globale. Retry logic, error handling, scheduling con rate-limit awareness.
09 · Analytics
Raccolta cross-channel (Meta Ads + Google Ads + IG Insights + LinkedIn Analytics + YouTube Analytics). Insights LLM con recommended_strategy_changes che chiude il loop verso il macro-agent Strategist per la prossima iterazione.
10 · Orchestrator (master)
Coordina i 3 macro-agent. State graph LangGraph con routing dinamico in base al request, observability via LangSmith, prompt versionati in prompt_registry/. Da M5+ promosso a stable e congelato (FROZEN path).
Federated Intelligence §05
Il meccanismo che rende MARCØ qualitativamente diverso da ogni competitor è il loop di apprendimento federato anonimizzato. Spiegato senza marketing-speak:
Cosa NON viene mai condiviso
- Nomi clienti, dati di contatto, copy specifico
- Performance numerics raw del singolo tenant
- Identificativi diretti o indiretti (k-anonymity garantisce ≥5 tenant indistinguibili in ogni cluster)
- Qualsiasi dato non aggregato
Cosa viene aggregato e ridistribuito
- Pattern strutturali: "tagline diretta <7 parole + CTA verbo imperativo: +28% CTR mediano (n=47 tenant, σ=0.12)"
- Failure modes anonimi: "meta description >160 char causa truncation Google nel 89% dei casi (n=120 siti)"
- Prompt evolutions retroattive che migliorano la qualità su tutta la base utenti
Il federated loop è ciò che trasforma MARCØ da "tool agentico con prompt fissi" a "agenzia che impara, scala, e si migliora". Senza richiedere al cliente di condividere niente.
Stack tecnologico §06
Core
| Componente | Tecnologia | Ruolo |
|---|---|---|
| Backend | Python 3.12 + FastAPI | API gateway, auth, tenant routing |
| Frontend | Next.js 14 App Router + TS | Dashboard 3-livelli + chat SSE |
| Macro-orchestration | LangGraph + LangSmith | State graph + observability + evals |
| Execution agentica | OpenSwarm fork (Docker sidecar) | 10 agenti specialisti isolati |
| LLM routing | LiteLLM | Multi-provider fallback chain |
| Database | PostgreSQL 16 + pgvector | Multi-tenant con RLS |
| Vector store | ChromaDB → Qdrant (M8) | RAG ibrido |
| Cache/Queue | Redis + BullMQ | Rate limiting, job async |
| Search | Tavily + Firecrawl | Deep research live |
Generation & deploy
| Image gen | fal.ai (flux-pro + SDXL) + GPT-Image fallback |
| Video gen | fal.ai (Sora 2 / Veo 3 / Seedance) |
| Site deploy | Cloudflare Pages Direct Upload (3-step Wrangler-like) |
| Social automation | Composio (OAuth per-tenant, 10k+ servizi) |
Observability, auth, infra
| Telemetry federated | Apache Kafka + AES-256-GCM |
| Tracing | LangSmith + OpenTelemetry + Grafana + Loki |
| Auth | Clerk (fase 1) → Keycloak self-hosted (fase 2, WL) |
| Payments | Stripe (subscriptions + metering + WL billing) |
| Hosting | Hetzner EU (GDPR) — Docker Compose → K8s |
| License | Keygen.sh / custom server con heartbeat 24h |
Multi-tenancy & White-Label §07
MARCØ è multi-tenant by design dal giorno zero. Tre livelli di isolation in base al tier:
Tenant isolation
- RLS PostgreSQL (Row Level Security): ogni query filtrata per
tenant_idvia session variable, mai possibile cross-tenant data leak. - Bucket storage scoped: asset library namespaced per tenant slug.
- Cloudflare Pages project per sito: naming
marco-{tenant_slug}-{site_slug}, isolation network-level. - Composio OAuth per-tenant: token mai globale, scope minimo per canale.
White-Label (tier €299/mese)
Un'agenzia o reseller compra MARCØ in modalità White-Label e lo rivende ai propri clienti con il suo logo, domini custom, branding. Per ogni cliente del WL:
- Container Docker dedicato: risorse limitate, isolation totale.
- Theming CSS via custom properties: 3 vars override (
--terra-500,--terra-700,--terra-100), palette ink + semantic non sovrascrivibile. - Custom domain:
app.agenzia-x.itcon TLS auto via Cloudflare. - Sub-billing: l'agenzia gestisce i propri clienti, MARCØ fatturà l'agenzia.
- License heartbeat 24h: se il container WL non fa check-in, disattivazione graduale.
Dashboard 3-livelli
| Ruolo | Path | Cosa vede |
|---|---|---|
super_admin | /admin/* | Tutti i tenant, container WL, federated metrics, versioning prompt |
wl_admin | /whitelabel/* | Solo i propri sub-clienti, branding, analytics aggregati |
member | /dashboard/* | Chat, campaigns, sites, analytics del proprio tenant |
Pricing & ICP §08
Tier
| Tier | €/mese | Include |
|---|---|---|
| Starter | €29 | Brand kit + sito web + 1 canale social automatizzato. HITL opzionale. |
| Growth | €69 | Starter + 4 canali social + automazione completa + analytics cross-channel |
| Agency | €149 | Multi-brand fino a 5 clienti + dashboard agency + report consolidati |
| White-Label M7 | €299 | Rivendita brandizzata con proprio logo, container dedicato, sub-billing |
Strategia pricing
Aggressivamente low-tier per acquisition rapida. A €29 il break-even per il cliente è ~3 ore di lavoro freelance equivalente al mese. Il margine MARCØ è positivo già da Starter perché il costo marginale per tenant è ~$0.50–$2/mese (LLM costs + storage + bandwidth aggregati).
ICP (Ideal Customer Profile)
- Profilo primario: PMI italiane 1–20 dipendenti che hanno bisogno di marketing digitale ma non possono permettersi un team interno o un'agenzia.
- Profilo secondario: creator, professionisti, consulenti che vogliono brand presence senza assumere PR.
- Profilo Agency tier: piccoli studi che gestiscono 3–10 clienti e vogliono leva produttiva.
- Profilo WL tier: agenzie strutturate, reseller, consulenti tech che vogliono offrire una piattaforma SaaS branded ai loro clienti senza svilupparla.
Roadmap M0–M9 §09
~83 giorni di sviluppo strutturato in 10 milestone. Ogni milestone ha eval suite (≥90% pass rate per ogni agente prima della promotion) e deliverable concreto.
| M | Titolo | Durata | Deliverable chiave | Status |
|---|---|---|---|---|
| M0 | Foundation + OpenSwarm Integration | 7gg | Monorepo + sidecar + Market Research + Brand Identity da CLI | ✓ |
| M1 | Knowledge Base + Deep Research Engine | 7gg | RAG ibrido + 6 framework marketing + Tavily/Firecrawl/OS Deep Research | ✓ |
| M2 | Brand Identity completo + Visual Agent | 7gg | Brand kit completo (logo/palette/guidelines) + asset library tenant-scoped | ✓ |
| M3 | Site Builder + SEO + Cloudflare Pages | 10gg | Sito generato e deployato in autonomia — primo deliverable vendibile | ✓ LIVE |
| M4 | Content Creator + Video Agent | 10gg | 30 post/mese cross-canale + video fal.ai, HITL configurabile | ✓ scaffold |
| M5 | Social Automation + Strategist orchestrator | 10gg | Posting autonomo IG/LI/TT/YT + telemetry collector ON | ✓ scaffold |
| M6 | Frontend Dashboard 3 livelli | 8gg | Chat + campaign builder + analytics view (cliente/WL/super admin) | ✓ live |
| M7 | Multi-Tenancy + Auth + Billing + WL | 7gg | Stripe prod + Clerk/Keycloak + tier WL €299 funzionante | ✓ scaffold |
| M8 | Federated Intelligence Hub + Analytics | 10gg | Kafka encrypted + k-anonymity + DP + aggregator + auto prompt versioning | ✓ scaffold |
| M9 | Eval suite + Hardening + GDPR + Launch | 7gg | 50+ eval cases per agente + GDPR audit + go-live | in corso |
Stato attuale §10
Cosa funziona OGGI in locale
Docker stack a 6 servizi healthy (Postgres + Redis + ChromaDB + OpenSwarm + API + Web). Frontend Next.js a http://127.0.0.1:3010, backend a :8010, sidecar a :8090.
Demo URL live (Cloudflare Pages)
- marco-smoke-quieto.pages.dev — sito "Quieto", studio yoga Bologna (generato da MARCØ da brief in 3 minuti)
- marco-smoke-deploy-fix-validation.pages.dev — landing test del flow Direct Upload
Gating verso v1.0 launch
- Hetzner servers staging+prod provisioned
- DNS + TLS + HSTS
- Stripe production bootstrap (€29/€69/€149/€299)
- Clerk app production + JWT issuer
- Penetration test + DPIA review counsel
- Privacy policy + ToS + Cookie banner + DPA template
- Trademark MARCØ depositato
- 3–5 case study reali da pilot
Backlog tecnico aperto
- Frontend action buttons inline chat ("Genera brand kit?" / "Genera sito?")
- Workflow
social_post+content_calendar(richiede FAL + Composio keys) - Backend wiring nuove pages dashboard (toglie mock)
- Stripe Connect setup per WL pass-through
Versione 0.9.0-rc. Scaffolding completo + 2 workflow E2E + deploy CF reale. Per il go-live v1.0 mancano scelte di business (provider keys, server prod, account billing) e compliance (pen test, DPIA, ToS). Il core agentico è in produzione locale ed è pitchabile a clienti pilot da subito.