Is riligar-marketing-analytics-ga4 safe to install?

SaferSkills independently audited riligar-marketing-analytics-ga4 (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.

CategoryWeightCategory scoreContribution

Securityprompt, exec, net, exfil, eval

35%

100

35.0 pts

Supply chainhash, typosquat, maintainer, lockfile

20%

100

20.0 pts

Maintenancestaleness, pinning, CI

15%

100

15.0 pts

TransparencySKILL.md, perms, README

15%

100

15.0 pts

Communityinstalls, verify, response

15%

100

15.0 pts

Findings & checks · 0 flagged

Securityscore 100 · 0 findings

✓—All security checks passedNo findings in this category for the latest scan.pass

Supply chainscore 100 · 0 findings

✓—All supply chain checks passedNo findings in this category for the latest scan.pass

Maintenancescore 100 · 0 findings

✓—All maintenance checks passedNo findings in this category for the latest scan.pass

Transparencyscore 100 · 0 findings

✓—All transparency checks passedNo findings in this category for the latest scan.pass

Communityscore 100 · 0 findings

✓—All community checks passedNo findings in this category for the latest scan.pass

The primary manifest — the file an agent reads to learn what this artifact does.

.agent/skills/riligar-marketing-analytics-ga4/SKILL.md · 1 file

.agent/skills/riligar-marketing-analytics-ga4/SKILL.md8.0 KB · Markdown

name: riligar-marketing-analytics-ga4

description: Consulta dados do Google Analytics 4 via SDK oficial (google-analytics-data). Le propriedades, gera relatorios de sessoes, usuarios, pageviews, bounce rate, conversoes, fontes de trafego, landing pages, campanhas UTM, dispositivos, geo e dados em tempo real. Use quando o usuario mencionar google analytics, ga4, analytics, sessoes, usuarios, pageviews, bounce rate, fontes de trafego, landing pages, campanhas utm, tempo real, realtime, dados do site, comportamento do site, trafego do site, conversoes ga4. Tambem dispara com /riligar-marketing-analytics-ga4 setup.

RiLiGar Marketing Analytics GA4

Skill completa para consulta de dados do Google Analytics 4 via SDK oficial (google-analytics-data). Gera relatorios de sessoes, usuarios, pageviews, bounce rate, conversoes, fontes de trafego, landing pages, campanhas UTM, dispositivos, geo e dados em tempo real.

IMPORTANTE: Esta skill e o braco de execucao para GA4. Para inteligencia (diagnostico, auditoria, estrategia), use a skill riligar-marketing-ads como camada acima.

IMPORTANTE: Esta skill e separada do riligar-marketing-ads-google porque muita gente usa Meta Ads + GA4 sem Google Ads. Porem, se o usuario ja tem riligar-marketing-ads-google configurado, as credenciais OAuth podem ser compartilhadas.

IMPORTANTE: NUNCA usar MCPs (adloop, google-analytics-mcp, etc). Esta skill usa SOMENTE os scripts Python locais.

Setup (primeira vez)

Quando o usuario pedir para configurar, rodar setup, ou for a primeira vez usando a skill, o Claude deve guiar o setup interativo:

1. Verificar dependencias

pip3 install google-analytics-data google-auth

2. Verificar .env

Checar se existe ~/.claude/skills/riligar-marketing-analytics-ga4/.env. Se NAO existir, criar com o template:

# RiLiGar Marketing Analytics GA4 — Configuracao
# Os scripts leem este arquivo automaticamente. NAO precisa adicionar ao ~/.zshrc.

# OBRIGATORIO: Property ID do GA4 (ex: 123456789, sem "properties/")
GA4_PROPERTY_ID=""

# AUTH — Escolha UM dos dois modos:

# MODO 1: Service Account (mais simples pra GA4)
# Baixe o JSON da service account no Google Cloud Console
# e coloque o path completo aqui:
GA4_CREDENTIALS_PATH=""

# MODO 2: OAuth2 (compartilhado com riligar-marketing-ads-google)
# Se voce ja tem riligar-marketing-ads-google configurado, pode reusar as credenciais:
# GA4_CLIENT_ID=""
# GA4_CLIENT_SECRET=""
# GA4_REFRESH_TOKEN=""
# Ou deixe em branco e o script busca automaticamente no .env do riligar-marketing-ads-google.

Modo 1 (Service Account): Mais simples. Cria uma service account no Google Cloud Console, da acesso de leitura na propriedade GA4, baixa o JSON e coloca o path em GA4_CREDENTIALS_PATH.

Modo 2 (OAuth2): Se o usuario ja tem riligar-marketing-ads-google configurado com OAuth, os scripts buscam automaticamente as credenciais de ~/.claude/skills/riligar-marketing-ads-google/.env. Nao precisa configurar nada extra.

3. Cadastro de propriedades (contas.yaml) — SETUP CONVERSACIONAL

Depois que o .env estiver preenchido, o Claude DEVE proativamente guiar o cadastro:

Rodar read.py account para verificar acesso a propriedade
Perguntar ao usuario: "Qual o site/app principal? Me passa o nome do cliente, e eu preencho o contas.yaml pra ti."
Para cada cliente, perguntar:

Nome do cliente
Property ID do GA4

Preencher o contas.yaml automaticamente com as respostas
Perguntar: "Quer cadastrar mais algum cliente?"

Cadastro de clientes (contas.yaml)

Arquivo: ~/.claude/skills/riligar-marketing-analytics-ga4/contas.yaml

Antes de executar qualquer operacao, o Claude DEVE ler este arquivo para resolver nomes de clientes para property IDs. Quando o usuario disser "analytics do Meu Cliente" ou "sessoes da Meu Cliente", consultar o contas.yaml para obter o property_id do cliente.

Se o cliente nao estiver cadastrado, perguntar os dados e oferecer para adicionar ao arquivo.

Como usar

Todos os scripts estao em ~/.claude/skills/riligar-marketing-analytics-ga4/scripts/. O padrao e:

python3 <script>.py <subcomando> [argumentos]

O Claude deve interpretar o pedido do usuario e executar o script correto via Bash.

Referencia rapida de operacoes

Leitura (read.py)

Subcomando	O que faz	Exemplo
`properties`	Lista propriedades GA4 acessiveis	`read.py properties`
`account`	Detalhes de uma propriedade (nome, timezone, currency)	`read.py account --property 123456789`

Relatorios (reports.py) — CORE DA SKILL

Subcomando	O que faz	Exemplo
`overview`	Resumo geral (sessoes, usuarios, pageviews, bounce rate, conversoes)	`reports.py overview --date-range 30daysAgo`
`traffic-sources`	Fontes de trafego (source/medium) com metricas	`reports.py traffic-sources --date-range 7daysAgo`
`landing-pages`	Paginas de destino com bounce rate e conversoes	`reports.py landing-pages --date-range 30daysAgo --limit 20`
`campaigns`	Performance de campanhas UTM (source, medium, campaign)	`reports.py campaigns --date-range 30daysAgo`
`conversions`	Eventos de conversao com contagem e valor	`reports.py conversions --date-range 30daysAgo`
`devices`	Breakdown por dispositivo (desktop, mobile, tablet)	`reports.py devices --date-range 7daysAgo`
`geo`	Breakdown por pais/cidade	`reports.py geo --date-range 30daysAgo`
`daily`	Evolucao diaria de metricas	`reports.py daily --start-date 2026-03-01 --end-date 2026-03-31`
`custom`	Query custom (metricas e dimensoes livres)	`reports.py custom --dimensions date,sessionSource --metrics sessions,totalUsers`

Parametros comuns:

Parametro	O que faz	Exemplo
`--property`	Property ID do GA4	`123456789`
`--date-range`	Periodo relativo	`7daysAgo`, `30daysAgo`, `90daysAgo`, `365daysAgo`
`--start-date`	Data inicio	`2026-03-01`
`--end-date`	Data fim	`2026-03-31`
`--limit`	Limite de linhas	`50`

Tempo real (realtime.py)

Subcomando	O que faz	Exemplo
`now`	Usuarios ativos agora, paginas sendo vistas, fontes	`realtime.py now`
`events`	Eventos em tempo real	`realtime.py events`

Regras de seguranca

O Claude DEVE seguir estas regras ao executar operacoes:

Somente leitura — RiLiGar Marketing Analytics GA4 e uma skill de consulta, NAO modifica dados
Nunca hardcodar property IDs ou credenciais — sempre usar env vars ou contas.yaml
Respeitar rate limits — se receber erro de quota, aguardar 60 segundos antes de tentar novamente
Nunca assumir origem de dados — ao mostrar metricas, SEMPRE especificar o periodo e a propriedade consultada
NUNCA usar MCPs — esta skill usa SOMENTE os scripts Python locais, NUNCA tools de MCP (adloop, google-analytics-mcp, etc)

Fluxos comuns

Visao geral do site

reports.py overview --date-range 30daysAgo — resumo geral
reports.py traffic-sources --date-range 30daysAgo — de onde vem o trafego
reports.py devices --date-range 30daysAgo — desktop vs mobile
reports.py landing-pages --date-range 30daysAgo --limit 10 — principais paginas

Analise de campanhas UTM

reports.py campaigns --date-range 30daysAgo — performance por campanha
reports.py traffic-sources --date-range 30daysAgo — source/medium detalhado
reports.py landing-pages --date-range 30daysAgo — onde o trafego esta chegando

Monitoramento em tempo real

realtime.py now — quem esta no site agora
realtime.py events — o que estao fazendo

Evolucao diaria

reports.py daily --start-date 2026-03-01 --end-date 2026-03-31 — serie temporal
Comparar com periodo anterior para identificar tendencias

Diagnostico de bounce rate alto

reports.py landing-pages --date-range 30daysAgo --limit 20 — paginas com maior bounce
reports.py devices --date-range 30daysAgo — se mobile tem bounce maior
reports.py traffic-sources --date-range 30daysAgo — se alguma fonte tem bounce anomalo

riligar-marketing-analytics-ga4— agent skill

Is riligar-marketing-analytics-ga4 safe to install?

RiLiGar Marketing Analytics GA4

Setup (primeira vez)

1. Verificar dependencias

2. Verificar .env

3. Cadastro de propriedades (contas.yaml) — SETUP CONVERSACIONAL

Cadastro de clientes (contas.yaml)

Como usar

Referencia rapida de operacoes

Leitura (read.py)

Relatorios (reports.py) — CORE DA SKILL

Tempo real (realtime.py)

Regras de seguranca

Fluxos comuns

Visao geral do site

Analise de campanhas UTM

Monitoramento em tempo real

Evolucao diaria

Diagnostico de bounce rate alto

Audit the pieces. Scan the whole. Decide.