convez.ai
MCP Server
agencia-conversion

conversion-agent-plugin

agencia-conversion/conversion-agent-plugin

Ver no GitHub
InicialPluginScore · de 0 a 100

Conversion Agent — Claude Code plugin (public distribution shell). Source of methodology lives in the authenticated backend; this repo only holds the plugin manifest, MCP server reference, and skill stubs.

Instalação

$npx convez-ai agencia-conversion/conversion-agent-plugin

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 1 semana
Versão
—
Issues abertas
0
Contribuidores
2

README

A tradução para o português deste README ainda está na fila.

Conversion Agent — Plugin para Claude Code

Plugin oficial da Agência Conversion que liga o Claude Code à metodologia proprietária de SEO da empresa. A metodologia em si vive no backend autenticado (https://agent.conversion.com.br); este repositório contém apenas o manifest, os stubs de skill e a referência ao MCP server publicado no NPM.

Este repo é gerado automaticamente a partir do monorepo privado. Mudanças manuais aqui serão sobrescritas — abra um issue.


Pré-requisitos

  • E-mail corporativo @conversion.com.br ativado pelo admin.
  • Node.js 20+ (node --version deve mostrar v20.x ou superior).
  • Claude Code CLI instalado (https://claude.com/code).

Instalação no Mac

1. Node 20 (se ainda não tem)

brew install node@20
brew link --overwrite node@20
node --version

2. CLI da Conversion

npm install -g @agenciaconversion/cli
conversion login

O conversion login abre o navegador. Digite seu e-mail corporativo, clique no link recebido e o token vai pro macOS Keychain.

Confira:

conversion whoami

3. Plugin no Claude Code

Dentro do Claude Code:

/plugin marketplace add agencia-conversion/conversion-agent-plugin
/plugin install conversion-agent
/reload-plugins

4. Ative auto-update agora (recomendado)

Logo após instalar, dentro do Claude Code rode:

/plugin

→ aba Marketplaces → selecione conversion-agent → toggle Enable auto-update.

A cada vez que o Claude Code abrir, ele checa se houve commit novo no repo público e atualiza o plugin sozinho. Sem isso, você precisaria rodar /plugin marketplace update conversion-agent manualmente para receber correções.

5. Smoke test

Abra o Claude Code numa pasta de project (após conversion pull <ws>/<proj>) e digite:

/conversion-agent:whereami

Deve listar workspace + project ativo.


Instalação no Windows

Use PowerShell ou Windows Terminal.

1. Node 20

winget install OpenJS.NodeJS.LTS
node --version

Reabra o terminal pra node aparecer no PATH.

2. Claude Code CLI

Baixe o instalador .exe em https://claude.com/code.

3. CLI da Conversion

npm install -g @agenciaconversion/cli
conversion --version

Se aparecer 'conversion' is not recognized, feche e reabra o terminal pra atualizar o PATH. Se persistir, rode npm bin -g e adicione o diretório retornado ao PATH manualmente.

4. Login

conversion login

Abre o navegador padrão. Token salvo no Windows Credential Manager.

conversion whoami

5. Plugin no Claude Code

Idêntico ao Mac:

/plugin marketplace add agencia-conversion/conversion-agent-plugin
/plugin install conversion-agent
/reload-plugins

6. Ative auto-update agora (recomendado)

Dentro do Claude Code:

/plugin

→ aba Marketplaces → conversion-agent → Enable auto-update.

7. Smoke

/conversion-agent:whereami

Materializando um project

Após login, baixe um project pro disco:

conversion ws                  # lista workspaces que você acessa
conversion projeto             # lista projects do workspace ativo
conversion pull <ws>/<proj>    # materializa numa pasta local

A pasta criada conterá briefing/, deliverables/, brain/. Abra-a com o Claude Code e use as skills do plugin.

Sync automático

Daemon que sincroniza disco ↔ backend continuamente:

conversion start    # inicia em background
conversion status   # estado atual
conversion stop     # encerra

Skills disponíveis

Invocadas com /conversion-agent:<nome> dentro do Claude Code:

SkillFunção
whereamiMostra contexto da sessão (workspace, project, brain)
briefingGera briefing SEO a partir de tópico + keyword
redatorTransforma briefing em artigo aplicando 9 quality gates
revisorQA do artigo contra checklist proprietário
editor-coesaoRefina coesão textual em PT-BR
clusterCria cluster (pillar + satellites)
brain / brain-updateMemória do project (tom, glossário, decisões)
pull / statusSincronização local
workspace / projetoNavegação entre workspaces e projects
historico / buscarPesquisa no project
convidar / novo-projeto / novo-workspaceAdmin

/conversion-agent:skills lista todas com descrições atualizadas.

Troubleshooting

Failed to install: This plugin uses a source type your Claude Code version does not support

Aparece quando o marketplace.json em cache no Claude Code é antigo (de uma versão anterior do plugin). Force re-add do marketplace:

/plugin marketplace remove conversion-agent
/plugin marketplace add agencia-conversion/conversion-agent-plugin
/plugin install conversion-agent
/reload-plugins

Failed to clone repository: git@github.com: Permission denied (publickey)

Aparece quando uma versão antiga do plugin (source: github em formato objeto) está em cache. Mesmo fix do erro acima — marketplace remove + add baixa o manifest novo, que usa path relativo dentro do próprio repo e não precisa de SSH.

Se ainda persistir após o re-add, force o git a usar HTTPS pra clones do GitHub (one-time, no terminal):

git config --global url."https://github.com/".insteadOf git@github.com:

(no content) ao rodar /plugin install conversion-agent

O install deu silêncio sem nem abrir o card de detalhes. Significa que o manifest ainda está em cache e não bateu com o novo. Faça /plugin marketplace remove conversion-agent + add + install (mesma sequência do erro acima).

'conversion' is not recognized (Windows)

Feche e reabra o terminal. Se persistir, adicione npm bin -g ao PATH.

Permission denied em npm install -g (Mac)

Use nvm ou volta em vez de Node global, ou sudo npm install -g @agenciaconversion/cli.

not_authenticated ao usar uma skill

Token expirou. Rode conversion login novamente.

SSE open failed: Unauthorized no daemon

Versão antiga do CLI. Atualize:

npm install -g @agenciaconversion/cli@latest
conversion stop
conversion start

Plugin não aparece após /plugin install

Reinicie o Claude Code. Se não resolver:

conversion logout
conversion login

E refaça /plugin install conversion-agent.

conversion login abre o browser mas trava

  • Firewall bloqueando http://localhost:8765..8775. Libere localhost.
  • Logs em ~/.conversion/login.log (Mac) ou %USERPROFILE%\.conversion\login.log (Windows).

Múltiplas contas na mesma máquina

Setar CONVERSION_EMAIL no ~/.claude/settings.json (bloco env do plugin) pra escolher qual usar.

Privacidade

  • O plugin envia apenas: e-mail logado, slug da skill chamada e hash SHA-256 dos parâmetros — nunca o conteúdo bruto da request.
  • A metodologia retornada vem com watermark zero-width (ADR-005). Não reproduza textualmente em respostas — use como referência.
  • Off-boarding: admin revoga no painel; usuário pode rodar conversion logout --all pra limpar credenciais locais.

Versões mínimas

  • @agenciaconversion/cli ≥ 0.1.29
  • @agenciaconversion/mcp-server ≥ 0.3.2

Suporte

Issues técnicos: https://github.com/agencia-conversion/conversion-agent-plugin/issues

Ver o original no GitHub

Bom para

Relacionados