MARCØ

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

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.

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.

Vs. tutto il mercato: l'argomento di costo

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

Specialisti in dettaglio

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

Generation & deploy

Observability, auth, infra

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_id via 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.it con 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

Pricing & ICP §08

Tier

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.

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.

Manuale operativo: DietaMenu §11

Lifecycle end-to-end di un brand cliente dentro MARCØ — dal register agency al sito live, audit GEO, fix automatici, social posting e analytics ongoing. Esempio: DietaMenu (piattaforma SaaS B2B per nutrizionisti italiani), gestito da agency Schedy Studio.

Step 0 — Setup tenant Agency root

1. Apri /register → email agency@schedy.app, brand Schedy Studio, slug auto schedy-studio, tier Agency.
2. Promote role + active tier via SQL (workaround backend pre-auto-derive role):
   docker exec marco-postgres psql -U marco -d marco -c "UPDATE users SET role='agency' WHERE email='agency@schedy.app'; UPDATE tenants SET status='active' WHERE slug='schedy-studio';"
3. Email verify: clicca link in mail Brevo (o GET /api/v1/auth/email/verify?token=... con il token da users.email_verification_token).

Step 1 — Creare il brand DietaMenu

1. Login agency@schedy.app → atterri su /chat (Schedy Studio agency root).
2. Vai su /clients → bottone + Nuovo brand → nome DietaMenu, slug auto dietamenu → submit. Card brand creata sotto I tuoi brand (1/5 attivi).
3. Click Apri → su card DietaMenu → full reload /dashboard → header destra ora mostra Brand: DietaMenu + KPI bar BENVENUTO DietaMenu · tier starter. Sei dentro il brand — chat/audit/siti/social adesso lavorano nel contesto DietaMenu.
4. Per tornare ad Agency root in qualsiasi momento: dropdown Brand: DietaMenu ▾ → ← Torna ad Schedy Studio.

Step 2 — Workflow brand_kit_basic (research → identity)

Genera market research + tone of voice + palette + 3 tagline + logo concept. ~$0.08 / 90s.

1. /chat (in contesto DietaMenu) → dropdown workflow → Brand kit (research → identity).
2. Composer: incolla brief 1-3 righe (cosa fa, target, USP, tone preferito).
3. SSE streaming live: 2 step (Market Research via Tavily → Brand Identity con palette+tagline+logo via fal.ai).
4. Output JSON includes: tagline_candidates[3], palette (5 swatch + hex), tone_of_voice, brand_guidelines_doc, logo_url (fal.ai).

Step 3 — Workflow site_launch (deploy CF Pages)

Genera HTML/CSS/JS + visual hero + SEO @graph + llms.txt + deploy real Cloudflare Pages. ~$0.33 / 5min.

1. /chat → dropdown workflow → site_launch (tier Growth+: super_admin o agency bypassa il gate).
2. Brief esteso (vedi card di esempio sotto).
3. SSE 4 step: Brand Identity (riusa Step 2 se presente in history) → SEO Agent (@graph LocalBusiness/Service/Organization + JSON-LD) → Visual Agent (hero image FAL flux-pro) → Site Builder (HTML/CSS/JS responsive + llms.txt + robots.txt 14 AI bot whitelist + sitemap + deploy CF Pages).
4. Output: production_url tipo https://marco-dieta-menu-dietamenu.pages.dev. Live in ~10 sec dopo "deploy_completed".

DietaMenu — Piattaforma AI per menù dietetici personalizzati
Target: nutrizionisti / dietisti / biologi nutrizionali italiani 30-55
   con studio privato o online (50-300 pazienti)
USP:  1) AI italiana addestrata su LARN + tabelle CREA
      2) 3 min vs 30 min per piano custom
      3) Lista spesa auto + export PDF brandizzato col logo dello studio
Pricing teaser: 3 piani — €29 solo / €69 studio / €149 clinica
Tone: clinico ma accessibile, italiano professionale, no buzzword wellness
Pagine: hero + come-funziona + 3 testimonial nutrizionisti + pricing + CTA "Prova gratis 14gg"
Slug: dietamenu

Step 4 — Workflow geo_audit (baseline score)

Audit GEO del sito appena deployato. Score composite 0-100 su 5 dimensioni weighted + 10 action items prioritizzati. ~$0.008 / 17s.

1. /audit (sidebar III.) → form URL → incolla production_url dello Step 3.
2. SSE: 1 agent (geo_audit) con 5 sub-step paralleli (visibility 25%, schema 20%, technical 20%, content 15%, platform 20%).
3. Report renderizzato: hero score + 5 DimensionCard + Citability/Schema SubCard + 10 ActionRow priorità H/M/L.
4. Auto-save snapshot in audit_history table → tracciato per delta cross-time.

Storia & reprise audit (multi-sessione)

La pagina /audit conserva le sessioni audit cross-navigazione (pattern simile alla chat history):

• Toolbar in cima con bottone ↳ Storia audit (N) ▾ → dropdown con ultime 10 audit del tenant.
• Ogni row: timestamp · score color-coded (≥80 verde, 60-79 terra, <60 rosso) · URL · classification · workflow_origin. Click su una row → ripristina il report dal report_snapshot JSONB salvato in DB (vista archivio immediata, no re-fetch agent).
• Ultimo report attivo salvato in localStorage tenant-scoped (marco-audit-current-v1:{tenant_id}) → navighi via e torni, vedi ancora il report.
• Bottone + Nuovo audit → reset completo (clear localStorage + form + report + brief) per partire da zero.

Step 5 — Workflow geo_fix (re-iterazione su audit)

Workflow chained 6 step: parte dal baseline geo_audit, rifa research/identity/seo/site_builder con feedback action items, fa re-audit, computa delta. ~$0.35 / 6min.

1. Dalla pagina /audit (post-baseline) → sezione Rilancio MARCØ-ready → toggle geo_fix (vs site_launch) → click "Rilancia".
2. SSE live: 6 step indicator [geo_audit (baseline cache) · market_research · brand_identity · seo · site_builder · geo_audit_after].
3. Output: nuovo production_url ottimizzato + DeltaPanel con score before/after + dimension_deltas (es. visibility +18, schema +25...).

Step 6 — Social posting (Composio multi-tenant)

Pre-requisito: auth_config managed creato in Composio dashboard per ogni piattaforma. Stato 2026-05-13: LinkedIn ✅ live, Instagram / TikTok / YouTube backlog (auth_config setup ~5min ognuno + workflow social_post estensione toolkit-agnostic).

1. /integrations (sidebar X.) → card LinkedIn → click Connetti → OAuth redirect Composio → consent → callback → status ACTIVE su ca_... connected_account_id.
2. Da /chat in contesto DietaMenu → workflow social_post (M5+) → MARCØ genera 1 post (copy + visual brand-aligned) → preview → publish.
3. Per schedulare batch: /campaigns page → form schedule (toolkit + scheduled_at + payload) → worker async polling 60s con FOR UPDATE SKIP LOCKED esegue automatic.

Step 7 — Analytics ongoing + Federated opt-in

1. /analytics → audit_history delta tracking → grafico temporale score (richiede ≥2 audit nello stesso URL).
2. /federated → Attiva consenso → tenant entra nel federated learning loop. Eventi anonimizzati (k≥5 + DP ε=1.0 + AES-256-GCM) contribuiscono al miglioramento prompt/workflow MARCØ aggregati cross-tenant. Beneficio per il brand: ricevi auto prompt+workflow ottimizzati basati su pattern emergenti (~30gg lag). Revocabile in qualsiasi momento (Art. 7 GDPR).

Costi totali stimati per brand (mese)

Margine lordo a tier Starter €29: ~98.7%. Per il caso reale FORMA ALTA (case study #1, 2026-05-12) il margine confermato sul tier è stato 96.7%.

Endpoint backend MARCØ riferimento rapido

Questo manuale è il golden path. Ogni step ha fallback documentati (vedi STATUS.md sezioni "Sessioni recenti") + atomi vault (esperienza/patterns/) per i pattern non ovvi.