Vai al contenuto

Report e grafici

Otto strumenti MCP di sola lettura per vedere come va la community e trasformarlo in un grafico o in una tabella nella conversazione — vendite, abbonamenti e MRR, membri attivi, coinvolgimento e classifica, eventi, corsi, l'attività di un membro e il pannello del mese — con ricette pronte.

Chiedi all'assistente come vanno le vendite, chi partecipa di più o cosa ha fatto una persona, e lui risponde con i numeri e, se vuoi, con un grafico o una tabella direttamente nella conversazione (in Claude, come artefatto). Gli otto strumenti di questa pagina consultano soltanto: nessuno cambia nulla nella community.

In sintesi

StrumentoCosa faRuolo minimoTipo
sales_reportVendite per giorno, settimana o mese, per piano, prodotto o metodo di pagamento, e il totale dalla prima venditaAdmin o finanzaSolo lettura
subscriptions_reportMRR, abbonamenti nuovi e annullati, churn, omaggi e downsellAdmin o finanzaSolo lettura
members_reportMembri nuovi, attivi e inattivi, per gruppo e per tagModeratoreSolo lettura
engagement_reportPost, commenti, reazioni, chi partecipa di più, post senza risposta e i punti della classificaModeratoreSolo lettura
events_reportEventi e quanti hanno risposto ci sarò, forse e non ci saròModeratoreSolo lettura
courses_reportIscrizioni, completamenti e avanzamento per corsoModeratoreSolo lettura
member_activityCosa ha fatto una persona: conteggi, punti della classifica e linkAdminSolo lettura
community_overviewQuesto mese rispetto al mese scorso, in una sola richiestaModeratore o finanzaSolo lettura

Chi vede cosa. Il denaro (vendite e abbonamenti) è del proprietario, dell'admin e di finanza. La community (membri, coinvolgimento, eventi e corsi) è del proprietario, dell'admin e del moderatore. L'attività di una persona specifica è solo del proprietario e dell'admin. In community_overview, ognuno vede solo il blocco della propria area: finanza vede il denaro, il moderatore vede la community.

Come arrivano le risposte

Ogni risposta arriva pronta per diventare un grafico:

ParteCos'è
seriesUna riga per periodo (period), con i numeri di quel periodo. I periodi vuoti compaiono con zero, così il grafico non salta un mese
totalsLa somma dell'intervallo richiesto
currencyLa valuta degli importi (una per consultazione; di default, la valuta in cui la community vende di più)
timezoneIl fuso orario usato per contare i giorni

Parametri comuni:

ParametroValoriDefault
intervalday, week (inizia il lunedì) o monthmonth
from, toDate AAAA-MM-GG, incluse. Vengono allargate fino all'inizio e alla fine del periodo: con month, il 15/03 diventa l'01/0330 giorni, 12 settimane o 12 mesi fino a oggi
timezoneUn fuso orario come America/Sao_PauloIl fuso del paese della community

Una consultazione copre al massimo 366 giorni, 156 settimane o 120 mesi. Per un periodo più lungo, usa un intervallo più ampio.

Cosa significa ogni numero:

  • Le vendite vengono dall'estratto conto: il netto del report è il netto dell'estratto conto nello stesso periodo. L'unica commissione che compare è la commissione della piattaforma, che non dipende dal metodo di pagamento.
  • L'MRR è il ricavo ricorrente mensile: ogni abbonamento pagante convertito al mese (l'annuale diviso per 12). Gli omaggi e gli abbonamenti in prova restano fuori.
  • Attivo è chi ha fatto almeno una cosa nel periodo: ha pubblicato, commentato, reagito, risposto a un evento (ci sarò o forse), si è iscritto o ha studiato in un corso, o ha guadagnato punti in classifica (incluso l'accesso giornaliero, quando la classifica è attiva). Solo leggere non conta, perché le visualizzazioni non vengono registrate.
  • La presenza agli eventi non esiste: Memberfy registra la risposta di ogni persona (ci sarò, forse, non ci sarò), non chi ha partecipato. Il report lo dice (attendanceTracked: false).

sales_report

Solo lettura

Report delle vendite. Per periodo: lordo, commissione della piattaforma, interessi della rateizzazione, netto, numero di vendite, scontrino medio, rimborsi e contestazioni (separati), e il netto dopo di essi. Riporta anche i prelievi richiesti e completati e il totale dalla prima vendita. Ruolo minimo: admin o finanza.

Parametri: quelli comuni, più group_by (product, plan, payment_method o product_type) e currency.

Restituisce: series, totals, allTime (da sempre), payouts e, con group_by, groups: ogni piano, prodotto o metodo di pagamento con la propria serie. Una vendita che non appartiene a nessun piano finisce nel gruppo senza nome.

Chiedi così: "Quanto ho guadagnato in totale da quando ho iniziato a vendere?"

Dopo: la risposta suggerisce, in next_steps, lo stesso report sul periodo immediatamente precedente, con le date già pronte, per confrontare. Vedi Prossimi passi.

subscriptions_report

Solo lettura

Report degli abbonamenti. Per periodo: MRR, abbonamenti paganti, nuovi, annullati, churn (la percentuale di quelli attivi all'inizio del periodo che sono stati annullati), in prova e omaggi. Ruolo minimo: admin o finanza.

Parametri: quelli comuni, più currency.

Restituisce: series, totals, la fotografia di oggi in current (MRR, ARR, per stato, quanti termineranno a fine periodo, in ritardo, omaggi), byPlan e downsell (offerte di ultima occasione mostrate e accettate).

Chiedi così: "Com'è andato l'MRR quest'anno? Qual è stato il churn di ogni mese?"

Lo storico viene ricostruito a partire dalle date di inizio e di fine di ogni abbonamento. Un ritardo già risolto o una pausa non lasciano una data, quindi compaiono solo nella fotografia di oggi.

members_report

Solo lettura

Report dei membri. Per periodo: quanti sono entrati, quanti erano attivi, il totale a fine periodo e gli inattivi. Ruolo minimo: moderatore.

Parametri: quelli comuni.

Restituisce: series, totals, current (totale, attivi e inattivi negli ultimi 30 giorni, per ruolo), byGroup e byTag.

Chiedi così: "Quanti nuovi membri abbiamo avuto ogni settimana nell'ultimo trimestre, e quanti erano attivi?"

engagement_report

Solo lettura

Report di coinvolgimento e classifica. Per periodo: post del feed, contenuti, commenti, reazioni, membri attivi e punti della classifica. Mostra anche dove avviene la conversazione, chi ha partecipato di più, i post a cui nessuno ha risposto e i dati che formano la classifica. Ruolo minimo: moderatore.

Parametri: quelli comuni, più order_by (points, interactions, posts, comments o reactions; di default points con la classifica attiva), page e limit (fino a 100).

Restituisce: series, totals, bySpace, members (paginato: post, commenti, reazioni, interazioni, punti nel periodo e il livello di oggi), unansweredPosts e ranking (le regole dei punti, i punti per azione e per periodo e quanti membri ci sono in ogni livello).

Chiedi così: "Chi sono i 10 più coinvolti del mese? E quali azioni hanno dato più punti?"

events_report

Solo lettura

Report degli eventi. Per periodo: gli eventi che si sono svolti e le risposte ricevute. Per evento: quanti hanno detto ci sarò, forse e non ci sarò, con il link. Ruolo minimo: moderatore.

Parametri: quelli comuni, più page e limit.

Restituisce: series, totals ed events. La presenza non viene registrata, e l'assistente lo dice se chiedi chi ha partecipato.

Chiedi così: "Quante persone hanno confermato a ogni evento di questo semestre?"

courses_report

Solo lettura

Report dei corsi. Per periodo: iscrizioni, corsi completati e lezioni completate. Per corso: iscrizioni, completamenti, tasso di completamento e l'avanzamento medio degli iscritti. Ruolo minimo: moderatore.

Parametri: quelli comuni, più page e limit.

Restituisce: series, totals e courses, con il link di ogni corso.

Chiedi così: "Quale corso ha il tasso di completamento più basso?"

member_activity

Solo lettura

Attività di un membro. Cosa ha fatto una persona nella community, nel periodo e da sempre: post, commenti, reazioni, risposte agli eventi, iscrizioni, acquisti, abbonamenti, corsi completati e certificati. Riporta i punti della classifica per azione, il livello e la posizione, e gli elementi recenti con il link. Ruolo minimo: admin.

Parametri: member (l'id del profilo, da list_members, l'e-mail o il link del profilo copiato dall'app) e quelli comuni. Per la cronologia di tutto ciò che la persona ha fatto, con data e ora, usa list_activity_logs.

Restituisce: counts, ranking e recent. Degli acquisti, solo l'importo pagato e il metodo di pagamento. Non c'è registro della navigazione: il report mostra cosa la persona ha fatto, non cosa ha visto.

Chiedi così: "Cosa ha fatto [email protected] nella community negli ultimi 3 mesi?"

community_overview

Solo lettura

Pannello generale della community. Questo mese fino a oggi rispetto al mese scorso intero e rispetto al mese scorso fino allo stesso giorno: ricavi e MRR, nuovi membri, coinvolgimento e gli eventi dei prossimi 30 giorni. Ruolo minimo: moderatore o finanza; ognuno vede il blocco della propria area.

Parametri: timezone.

Restituisce: money (per proprietario, admin e finanza) e community (per proprietario, admin e moderatore).

Chiedi così: "Come va il mese rispetto al precedente?"

Ricette

Grafico dei ricavi per mese e per piano

Per chi: proprietario, admin o finanza.

Fai un grafico a barre impilate dei ricavi netti mese per mese nel 2026, un colore per piano, e sotto una tabella con il totale di ogni piano e lo scontrino medio.

#StrumentoCosa fa
1sales_reportinterval: month, from: 2026-01-01, to: 2026-12-31, group_by: plan

Risultato: il grafico e la tabella nella conversazione. Ogni piano in groups arriva già con la serie completa, con zero nei mesi senza vendite. Per vedere anche i rimborsi, chiedi "e una linea con i rimborsi".

I 10 più coinvolti

Per chi: proprietario, admin o moderatore.

Chi sono stati i 10 membri più coinvolti negli ultimi 30 giorni? Mostrali in una tabella con post, commenti, reazioni, punti e livello, e dimmi quali azioni hanno dato più punti.

#StrumentoCosa fa
1engagement_reportinterval: day, limit: 10, order_by: points

Risultato: la tabella con i primi 10 e un riassunto di ranking.byAction. Con la classifica disattivata, chiedi order_by: interactions. Per vedere il dettaglio di una persona dell'elenco, prosegui con member_activity.

Riepilogo della settimana

Per chi: qualsiasi ruolo dello staff. Finanza riceve solo la parte del denaro; il moderatore, solo quella della community.

Fai il riepilogo della settimana: vendite e abbonamenti nuovi, nuovi membri, chi ha partecipato di più, i post rimasti senza risposta e i prossimi eventi con quanti hanno confermato. Chiudi con tre suggerimenti su cosa fare.

#StrumentoCosa fa
1community_overviewIl mese fino a oggi, per dare contesto
2sales_reportinterval: day, gli ultimi 7 giorni
3engagement_reportinterval: day, gli ultimi 7 giorni, limit: 5
4events_reportDalla prossima settimana in poi

Risultato: il riepilogo nella conversazione. Se vuoi pubblicarlo, chiedi "scrivi un post con questo per il Feed e mostramelo prima": l'assistente usa create_post dopo il tuo ok.

Correlati