MARCØ

WIKI — VOL. I
EDIZIONE 2026-05-11
VERSIONE 0.9.0-RC

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.

Time-to-brand
40s
brand_kit_basic E2E
Time-to-site
~3min
site_launch E2E
Cost/site
$0.16
USD, 4-step pipeline
Entry tier
€29
/mese Starter

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

01 / Brand Identity

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.

02 / Sito web

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.

03 / Contenuti cross-canale

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.

04 / Posting autonomo

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.

05 / Analytics + feedback loop

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

┌─────────────────────────────────────────────────────────────┐ │ FRONTEND · Next.js 14 App Router · Tailwind · TypeScript │ │ Chat SSE streaming + dashboard 3-livelli + WL theming │ └──────────────────────┬──────────────────────────────────────┘ │ HTTPS ┌──────────────────────▼──────────────────────────────────────┐ │ GATEWAY · FastAPI · CORS · LicenseGuard · TenantMiddleware│ └──────────────────────┬──────────────────────────────────────┘ │ ┌──────────────────────▼──────────────────────────────────────┐ │ MACRO-AGENT CORE · LangGraph state graph │ │ ┌───────────┐ ┌─────────┐ ┌──────────┐ │ │ │STRATEGIST │ │ CONTENT │ │ EXECUTOR │ │ │ └─────┬─────┘ └────┬────┘ └────┬─────┘ │ └────────┼─────────────┼────────────┼─────────────────────────┘ │ │ │ ┌────────▼─────────────▼────────────▼─────────────────────────┐ │ OPENSWARM SIDECAR · Docker container, internal network │ │ 10 agenti specialisti che eseguono i deliverable reali │ │ · Market Research · Brand Identity · SEO │ │ · Site Builder + CF · Content Creator · Visual │ │ · Video · Social Automation · Analytics │ └──────────────────────┬──────────────────────────────────────┘ │ ┌──────────────────────▼──────────────────────────────────────┐ │ LLM ROUTER · LiteLLM con chain fallback │ │ OpenRouter → Anthropic → OpenAI → Google → Groq → Ollama │ │ Task-based: Haiku (cheap) · Sonnet (medium) · Opus (premium)│ └─────────────────────────────────────────────────────────────┘

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.

WorkflowStepTempoCosto
brand_kit_basicmarket_research → brand_identity40s$0.026
site_launchmarket_research → brand_identity → seo → site_builder + CF deploy~3min$0.160
social_post M5content_creator → visual → social_automation~2min$0.05
content_calendar M5strategist 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.

★ Differenziatore architetturale

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

ApproccioCosto/mese PMITime-to-launchMigliora con l'uso?
Agenzia tradizionale€2k–€10k4–8 settimaneSolo se cambi staff
HubSpot + freelance€800–€1.5k2–4 settimaneNo
Wix + ChatGPT manuale€50–€2003–7 giorniNo
MARCØ Starter€29<3 minutiSì, federated
MARCØ Growth€69<3 minutiSì, 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-AgentSpecialisti delegatiOutput principali
StrategistMarket Research + Brand Identity + SEOSegmenti, competitor, brand kit, keyword strategy
ContentContent Creator + Visual + VideoCopy multi-canale, immagini, video brevi
ExecutorSite Builder + Social Automation + AnalyticsSito 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:

[Tenant A] post #42 ─ engagement +35% ─┐ [Tenant B] post #17 ─ engagement +28% ─┼─► COLLECTOR (M5+) [Tenant C] post #91 ─ engagement +41% ─┘ con consenso GDPR esplicito │ ▼ ANONYMIZER k-anonymity k≥5 + differential privacy │ ▼ ENCRYPTOR AES-256-GCM │ ▼ AGGREGATOR (M8) pattern clustering + anomaly detection │ ▼ BACKTESTER z-test, causal inference │ ▼ (se significativo) VERSIONER prompt v1.0 → v1.1 knowledge base delta │ ▼ PROPAGATION Tenant D, E, F, ... parte già con v1.1

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

ComponenteTecnologiaRuolo
BackendPython 3.12 + FastAPIAPI gateway, auth, tenant routing
FrontendNext.js 14 App Router + TSDashboard 3-livelli + chat SSE
Macro-orchestrationLangGraph + LangSmithState graph + observability + evals
Execution agenticaOpenSwarm fork (Docker sidecar)10 agenti specialisti isolati
LLM routingLiteLLMMulti-provider fallback chain
DatabasePostgreSQL 16 + pgvectorMulti-tenant con RLS
Vector storeChromaDB → Qdrant (M8)RAG ibrido
Cache/QueueRedis + BullMQRate limiting, job async
SearchTavily + FirecrawlDeep research live

Generation & deploy

Image genfal.ai (flux-pro + SDXL) + GPT-Image fallback
Video genfal.ai (Sora 2 / Veo 3 / Seedance)
Site deployCloudflare Pages Direct Upload (3-step Wrangler-like)
Social automationComposio (OAuth per-tenant, 10k+ servizi)

Observability, auth, infra

Telemetry federatedApache Kafka + AES-256-GCM
TracingLangSmith + OpenTelemetry + Grafana + Loki
AuthClerk (fase 1) → Keycloak self-hosted (fase 2, WL)
PaymentsStripe (subscriptions + metering + WL billing)
HostingHetzner EU (GDPR) — Docker Compose → K8s
LicenseKeygen.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_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

RuoloPathCosa 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€/meseInclude
Starter€29Brand kit + sito web + 1 canale social automatizzato. HITL opzionale.
Growth€69Starter + 4 canali social + automazione completa + analytics cross-channel
Agency€149Multi-brand fino a 5 clienti + dashboard agency + report consolidati
White-Label M7€299Rivendita 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.

MTitoloDurataDeliverable chiaveStatus
M0Foundation + OpenSwarm Integration7ggMonorepo + sidecar + Market Research + Brand Identity da CLI
M1Knowledge Base + Deep Research Engine7ggRAG ibrido + 6 framework marketing + Tavily/Firecrawl/OS Deep Research
M2Brand Identity completo + Visual Agent7ggBrand kit completo (logo/palette/guidelines) + asset library tenant-scoped
M3Site Builder + SEO + Cloudflare Pages10ggSito generato e deployato in autonomia — primo deliverable vendibile✓ LIVE
M4Content Creator + Video Agent10gg30 post/mese cross-canale + video fal.ai, HITL configurabile✓ scaffold
M5Social Automation + Strategist orchestrator10ggPosting autonomo IG/LI/TT/YT + telemetry collector ON✓ scaffold
M6Frontend Dashboard 3 livelli8ggChat + campaign builder + analytics view (cliente/WL/super admin)✓ live
M7Multi-Tenancy + Auth + Billing + WL7ggStripe prod + Clerk/Keycloak + tier WL €299 funzionante✓ scaffold
M8Federated Intelligence Hub + Analytics10ggKafka encrypted + k-anonymity + DP + aggregator + auto prompt versioning✓ scaffold
M9Eval suite + Hardening + GDPR + Launch7gg50+ eval cases per agente + GDPR audit + go-livein 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.

Servizi up
6/6
healthy
Agenti
9/10
overlay + LLM live
Workflow E2E
2
brand_kit + site_launch
Build
0.9.0
rc · pre-v1.0

Demo URL live (Cloudflare Pages)

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.