Setup: Curadoria Oftalmológica Automatizada

🤖

Módulo 01

Agente Claude Cowork

Configure o agente que executa automaticamente toda semana, busca artigos nas principais revistas e gera o JSON com os resumos.

1 Acessar o Claude Cowork ▼

O Claude Cowork é a interface de agentes autônomos do Claude. Ele permite criar agentes com instruções detalhadas que executam tarefas complexas — incluindo navegação na web, escrita de arquivos e push para o GitHub.

🌐

claude.ai

Sua conta

→

🤝

Cowork

Agentes autônomos

→

➕

Novo Agente

Curadoria Oftalmo

1
Acesse claude.ai e faça login com sua conta Anthropic
2
No menu lateral esquerdo, clique em Cowork
3
Clique em "+ New Agent" no canto superior direito
4
Você verá o editor de instruções do agente — é aqui que colaremos o prompt

💡

O Cowork exige conta Claude Pro ou Team. Se ainda não tem, acesse claude.ai/upgrade para verificar os planos disponíveis.

2 Criar o agente com nome e descrição ▼

Configure o nome e descrição do agente antes de colar as instruções. Isso facilita identificação e o gerenciamento de múltiplos agentes.

Configuração do agente

Nome:      Curadoria Semanal Oftalmologia
Descrição: Agente de curadoria semanal de literatura científica
            oftalmológica para o Dr. [Seu Nome].
            Busca, resume e publica artigos automaticamente.

Modelo:    Claude Sonnet 4.5 (ou o mais recente disponível)
Ferramentas: WebSearch ✓  Bash/Terminal ✓  Read/Write files ✓

⚠️

Certifique-se de habilitar as ferramentas WebSearch, Bash e File System nas configurações do agente — sem elas, o fluxo não funciona.

3 Colar as instruções completas do agente ▼

Estas são as instruções completas que definem todo o comportamento do agente: onde buscar, como estruturar os dados, como fazer o deploy. Cole integralmente no campo "Instructions" do agente.

✅

O prompt já contém todos os caminhos, URLs, formato JSON e comandos git configurados para o projeto do Dr. [Seu Nome]. Adapte apenas os caminhos se for replicar para outro projeto.

Você é um agente de curadoria semanal de literatura oftalmológica para o Dr. [Seu Nome] (médico oftalmologista). ## OBJETIVO A cada execução semanal, gerar um novo arquivo JSON com os artigos curados da semana, atualizar o índice e fazer commit + push para o repositório GitHub (seu-usuario/seu-repositorio), que dispara o deploy automático. ## CAMINHOS Local (projeto Vite): - Raiz: /Users/voce/Documents/Site-Medico/ - Diretório de dados: .../public/curadoria/data/ - Arquivo de índice: data/index.json - Arquivos de semana: data/YYYY-WXX.json ## ESCOPO DA BUSCA Período: artigos publicados/indexados nos últimos 7 dias. Áreas (3-5 artigos CADA): 1. Retina Clínica e Cirúrgica 2. Cirurgia de Catarata 3. Cirurgia Refrativa Fontes: PubMed, Ophthalmology (AAO), JAMA Oph, AJO, Retina, Cornea, JCRS, Ophthalmology Retina, BJO, Acta Oph, Eye (Nature), Graefe's, Frontiers Oph, ABO/SciELO, RBO, CBO, SBRV. ## REGRAS DE INTEGRIDADE (CRÍTICAS) - NUNCA inventar referências, DOIs, autores, datas ou conclusões - Sempre fornecer link real; sem link, não incluir - Se resumo baseado só em abstract: marcar abstractOnly: true - Indicar tipo de estudo (RCT, meta-análise, revisão, etc.) ## FLUXO DE EXECUÇÃO Etapa 1 — Calcular ID da semana (date +%G-W%V) Etapa 2 — Buscas WebSearch por área temática Etapa 3 — Gerar JSON da semana (YYYY-WXX.json) Etapa 4 — Atualizar index.json Etapa 5 — git add → commit → push origin main ## SAÍDA FINAL 1. Qtd artigos curados por área 2. ID da semana gerada 3. Status deploy (git push OK / erro) 4. 1-2 destaques principais 5. Link: https://seudominio.com/curadoria/

Prompt completo para copiar

# Cole este texto integralmente no campo "Instructions" do agente

Você é um agente de curadoria semanal de literatura oftalmológica para o
Dr. [Seu Nome] (médico oftalmologista).

## OBJETIVO
A cada execução semanal, gerar um novo arquivo JSON com os artigos curados
da semana, atualizar o índice e fazer commit + push para o repositório
GitHub (seu-usuario/seu-repositorio), que dispara o deploy automático do site.
O HTML estático (public/curadoria/index.html) carrega esses JSONs
dinamicamente — você NÃO precisa modificar o HTML, apenas os JSONs em
public/curadoria/data/.

## CAMINHOS
Local (projeto Vite):
- Raiz: /Users/voce/Documents/Site-Medico/
- Dir. dados: .../public/curadoria/data/
- Índice: data/index.json
- Semana: data/YYYY-WXX.json

Repositório GitHub:
- Remote: https://github.com/seu-usuario/seu-repositorio.git
- Branch: main
- URL pública: https://seudominio.com/curadoria/

## ESCOPO DA BUSCA
Período: artigos dos últimos 7 dias. Se poucos resultados → 14 dias.

Áreas (3-5 artigos CADA):
1. Retina Clínica e Cirúrgica — DMRI, RD, oclusões, descolamento,
   vitrectomia, anti-VEGF, terapia gênica, OCT
2. Cirurgia de Catarata — FLACS, MICS, LIOs, complicações
3. Cirurgia Refrativa — LASIK, SMILE, PRK, ICL, cross-linking

Fontes: PubMed, Ophthalmology (AAO), JAMA Oph, AJO, Retina, Cornea,
JCRS, Ophthalmology Retina, BJO, Acta Oph, Eye (Nature), Graefe's,
EJO, Frontiers Oph, ABO/SciELO, RBO, CBO, SBRV.

## REGRAS DE INTEGRIDADE
- NUNCA inventar referências, DOIs, autores, datas ou conclusões
- Sempre link real (PubMed/DOI); sem link → não incluir
- resumo só em abstract público → abstractOnly: true
- Indicar studyType (RCT, meta-análise, série, revisão)
- Peso maior para retina (subespecialidade do Dr. [Seu Nome])

## FLUXO DE EXECUÇÃO
### Etapa 1 — ID da semana
date +%G-W%V  →  ex: 2026-W23

### Etapa 2 — Buscas por área
WebSearch para cada área, queries em PT e EN.

### Etapa 3 — JSON da semana
Crie public/curadoria/data/YYYY-WXX.json com:
{
  "id": "2026-W23",
  "period": "29 mai – 4 jun 2026",
  "label": "Semana de 29 mai – 4 jun 2026",
  "generatedAt": "2026-06-04T07:00:00-03:00",
  "executive": [
    {"topic": "Retina",    "text": "..."},
    {"topic": "Catarata",  "text": "..."},
    {"topic": "Refrativa", "text": "..."}
  ],
  "articles": [
    {
      "id": "ret-2026-06-04-id-unico",
      "area": "retina",
      "title": "Título original",
      "authors": "Sobrenome AB, et al.",
      "source": "Journal",
      "date": "4 jun 2026",
      "origin": "EUA",
      "originLabel": "Estados Unidos",
      "studyType": "RCT",
      "summary": "3-5 frases em PT sobre objetivo, métodos e achados.",
      "conclusion": "1-2 frases com conclusão dos autores.",
      "impact": "2-4 frases com impacto na prática brasileira.",
      "link": "https://pubmed.ncbi.nlm.nih.gov/XXXXXX/",
      "keywords": ["palavra1", "palavra2"],
      "abstractOnly": false
    }
  ]
}

### Etapa 4 — Atualizar index.json
Read index.json → prepend nova entrada → atualizar "latest" → Write.
Se weeks.length > 52 → remover mais antigas + deletar JSONs.

### Etapa 5 — Deploy via GitHub
cd "/Users/voce/Documents/Site-Medico"
git config user.email "seu-email@gmail.com" 2>/dev/null || true
git config user.name "Dr. [Seu Nome]" 2>/dev/null || true
git add public/curadoria/data/
git commit -m "curadoria: atualiza dados semana $(date +%G-W%V)"
git push origin main
echo "EXIT_CODE: $?"

## SAÍDA FINAL
1. Qtd artigos por área
2. ID da semana
3. Status git push (OK / erro)
4. 1-2 destaques principais
5. Link: https://seudominio.com/curadoria/

4 Configurar execução semanal (Schedule) ▼

O Cowork permite agendar execuções recorrentes. Configure para rodar toda segunda-feira de manhã, antes da jornada clínica.

Configuração de schedule

Frequência:  Semanal
Dia:          Segunda-feira
Horário:      07:00 (horário de Brasília, UTC-3)
Trigger:      Automático (sem confirmação manual)
Notificação:  Email ao término

            Por que segunda às 7h?

            Os artigos indexados no PubMed até domingo ficam disponíveis na busca na madrugada de segunda. Às 7h o Dr. [Seu Nome] já tem a curadoria pronta ao abrir o consultório.

1
No painel do agente, clique em Schedule
2
Selecione Weekly → Monday → 07:00 AM (BRT)
3
Ative "Run autonomously" — sem precisar de aprovação manual
4
Salve as configurações

5 Executar o primeiro teste manual ▼

Antes de deixar o agente rodar sozinho, valide o fluxo completo com uma execução manual. Isso confirma que as permissões de arquivo e git estão corretas.

1
Clique em "Run now" no painel do agente
2
Acompanhe o log em tempo real — aguarde a mensagem EXIT_CODE: 0
3
Verifique se o arquivo YYYY-WXX.json foi criado em public/curadoria/data/
4
Acesse seudominio.com/curadoria/ e confirme os novos artigos

⚠️

Se o agente retornar erro de git push (401/403), o Personal Access Token precisa ser configurado no Keychain. Siga o Módulo 2 antes de executar.

🐙

Módulo 02

Repositório GitHub

Configure o repositório que recebe os JSONs gerados pelo agente e dispara o deploy automático. O Cowork faz push direto para o main.

🤖

Cowork Agent

gera JSON

→

🐙

GitHub repo

seu-usuario/seu-repositorio

→

⚙️

Actions CI

build + deploy

→

🌐

Hostinger

site ao vivo

1 Criar o repositório no GitHub ▼

1
Acesse github.com → clique em + New repository
2
Nome: dr.raphael · Visibilidade: Private (recomendado) ou Public
3
Inicialize com README · Adicione .gitignore do tipo Node
4
Clique em "Create repository"

Bash — clonar e configurar localmente

# Clone o repositório recém-criado
git clone https://github.com/seu-usuario/seu-repositorio.git
cd dr.raphael

# Configure identidade git (necessário para o agente fazer commit)
git config user.email "seu-email@gmail.com"
git config user.name  "Dr. [Seu Nome]"

2 Criar a estrutura de pastas do projeto ▼

A estrutura abaixo é a que o agente espera encontrar. O HTML de curadoria já está publicado — o agente só precisa criar/atualizar os JSONs.

Estrutura do projeto

Site Dr. [Seu Nome]/
├── public/
│   └── curadoria/
│       ├── index.html          ← HTML estático (não alterar)
│       └── data/
│           ├── index.json       ← índice das semanas
│           ├── 2026-W22.json    ← semana anterior
│           └── 2026-W23.json    ← criado pelo agente ✓
├── src/                         ← código Vite/React (se houver)
├── package.json
└── vite.config.ts

Bash — criar estrutura inicial

# Criar pastas necessárias
mkdir -p public/curadoria/data

# Criar o index.json inicial (vazio)
cat > public/curadoria/data/index.json <<'EOF'
{
  "weeks": [],
  "latest": ""
}
EOF

# Commit inicial
git add .
git commit -m "init: estrutura curadoria oftalmológica"
git push origin main

3 Criar o Personal Access Token (PAT) ▼

O PAT permite que o agente faça git push sem precisar de senha interativa. Crie um token com escopo mínimo necessário.

1
Acesse github.com → Settings → Developer settings → Personal access tokens → Fine-grained tokens
2
Clique em Generate new token
3
Nome: cowork-curadoria-medica
4
Expiration: 1 year (lembre de renovar anualmente)
5
Repository access: Only select repositories → dr.raphael
6
Permissions: Contents → Read and write
7
Clique Generate token e copie agora — não será exibido novamente

⚠️

Copie e salve o token em um local seguro agora. Você só verá o valor completo uma vez. Se perder, basta gerar um novo token.

github.com/settings/tokens/new

New fine-grained personal access token

Token name
cowork-curadoria-medica

Expiration
Custom → 1 year from today

Repository access
✓ seu-usuario/seu-repositorio

Permissions → Contents
✓ Read and write

4 Armazenar o PAT no macOS Keychain ▼

O agente usa o git credential helper do macOS, que busca o token automaticamente no Keychain. Configure uma vez e nunca mais precisará inserir senha.

Terminal — salvar credencial no Keychain

# Método 1: via git credential helper (recomendado)
# Ao executar o primeiro push, o macOS perguntará as credenciais:
# Username: seu-usuario-github
# Password: cole o PAT (não sua senha do GitHub)

git push https://github.com/seu-usuario/seu-repositorio.git main
# → macOS exibirá janela de autenticação → Use o PAT como senha

# Método 2: via security command (salvar manualmente no Keychain)
security add-internet-password \
  -a "seu-usuario" \
  -s "github.com" \
  -p "SEU_TOKEN_AQUI" \
  -T ""

# Verificar se foi salvo
security find-internet-password -s "github.com" -a "seu-usuario"

💡

Uma vez armazenado no Keychain, o agente consegue fazer push automaticamente toda semana sem intervenção. O macOS credential helper é ativado por padrão no git do macOS.

5 Apontar o projeto local para o remote ▼

O agente opera na pasta local do projeto. Confirme que o remote está configurado corretamente antes da primeira execução automática.

Bash — verificar e configurar remote

cd "/Users/voce/Documents/Site-Medico"

# Verificar remote atual
git remote -v

# Se não existir, adicionar:
git remote add origin https://github.com/seu-usuario/seu-repositorio.git

# Se existir com URL errada, atualizar:
git remote set-url origin https://github.com/seu-usuario/seu-repositorio.git

# Confirmar branch main está rastreando o remote
git branch --set-upstream-to=origin/main main

# Teste de push (deve pedir token na primeira vez)
git push origin main

✅

Quando o push retornar EXIT_CODE: 0, o GitHub está configurado e o agente pode operar de forma autônoma.

🌐

Módulo 03

Hostinger + Deploy Automático

Configure o deploy automático via GitHub Actions: a cada push no main, o site é buildado e publicado no Hostinger sem nenhuma ação manual.

1 Configurar o hPanel do Hostinger com Git ▼

O Hostinger tem integração nativa com GitHub no hPanel. Você pode conectar diretamente o repositório sem precisar de FTP.

1
Acesse hpanel.hostinger.com → selecione seu plano de hospedagem
2
Menu lateral → Advanced → Git
3
Em "Clone a Repository", insira a URL do repositório GitHub
4
Branch: main · Diretório: public_html (ou o diretório do domínio)
5
Clique Create — o Hostinger gera uma chave SSH pública
6
Adicione essa chave SSH no GitHub: repo → Settings → Deploy keys → Add key

💡

O método hPanel→Git é o mais simples. Porém para projetos com build Vite (npm run build), é necessário o GitHub Actions (próximo passo) — o hPanel Git faz pull simples, sem build.

hpanel.hostinger.com → Advanced → Git

Git Repositories

● seu-repositorio (main)

github.com/seu-usuario/seu-repositorio.git

Diretório: /public_html

Conectado Último pull: há 2 min

2 Criar o workflow GitHub Actions (build + deploy) ▼

Para projetos com build Vite, o GitHub Actions faz o build e envia os arquivos estáticos para o Hostinger via SSH/FTP a cada push.

.github/workflows/deploy.yml

name: Deploy → Hostinger

on:
  push:
    branches: [ main ]

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'

      - name: Install dependencies
        run: npm ci

      - name: Build Vite project
        run: npm run build
          # Gera pasta dist/ com HTML estático

      - name: Deploy via FTP para Hostinger
        uses: SamKirkland/FTP-Deploy-Action@v4.3.5
        with:
          server: ftp.seudominio.com
          username: ${{ secrets.FTP_USER }}
          password: ${{ secrets.FTP_PASS }}
          local-dir: ./dist/
          server-dir: public_html/
          dangerous-clean-slate: false
                # false = não apaga arquivos que não mudaram

            Alternativa: só os JSONs mudam

            Se o projeto não tem build Vite (HTML puro), simplificamos o workflow para enviar apenas a pasta public/curadoria/data/ — muito mais rápido.

.github/workflows/deploy-data-only.yml — para HTML estático puro

name: Deploy JSONs → Hostinger

on:
  push:
    branches: [ main ]
    paths:
      - 'public/curadoria/data/**'
      # Dispara APENAS quando a pasta de dados mudar

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Deploy data JSONs via FTP
        uses: SamKirkland/FTP-Deploy-Action@v4.3.5
        with:
          server:     ${{ secrets.FTP_SERVER }}
          username:   ${{ secrets.FTP_USER }}
          password:   ${{ secrets.FTP_PASS }}
          local-dir:  ./public/curadoria/data/
          server-dir: public_html/curadoria/data/

3 Adicionar secrets do FTP no GitHub ▼

As credenciais FTP ficam armazenadas como secrets no GitHub — nunca no código-fonte. O Actions as injeta no ambiente de execução.

1
No repositório GitHub → Settings → Secrets and variables → Actions
2
Clique em New repository secret
3
Adicione os 3 secrets abaixo:

GitHub Secrets necessários

FTP_SERVER  →  ftp.seudominio.com
                (encontrar em hPanel → FTP Accounts → server hostname)

FTP_USER    →  u123456789
                (usuário FTP principal do Hostinger)

FTP_PASS    →  SuaSenhaFTPAqui
                (senha FTP — diferente da senha do painel Hostinger)

🔑

Para encontrar os dados FTP: hPanel → Hospedagem → FTP Accounts. O servidor FTP geralmente é ftp.seudominio.com ou files.000webhost.com.

github.com/seu-usuario/seu-repositorio/settings/secrets/actions

Actions secrets

FTP_SERVER Updated

FTP_USER Updated

FTP_PASS Updated

4 Primeiro deploy manual para validar ▼

Faça um push de teste para disparar o workflow e confirmar que tudo está conectado.

Bash — forçar trigger do workflow

cd "/Users/voce/Documents/Site-Medico"

# Fazer qualquer mudança pequena para acionar o pipeline
echo "# Deploy test $(date)" >> .deploy-test
git add .deploy-test
git commit -m "ci: teste deploy automático"
git push origin main

# Acompanhar o workflow em tempo real (requer GitHub CLI)
gh run watch

1
Vá em github.com/seu-usuario/seu-repositorio/actions
2
Você verá o workflow Deploy → Hostinger rodando
3
Aguarde o ✓ success em todos os steps
4
Acesse seudominio.com e confirme que o site está atualizado

5 Verificação final — fluxo completo de ponta a ponta ▼

Com tudo configurado, o fluxo completo acontece assim toda segunda-feira às 7h:

🤖

Cowork Agent dispara automaticamente

Segunda, 07:00 BRT — sem intervenção

🔍

Busca nas revistas

PubMed + 15 fontes · 3 áreas · ~15 artigos

📝

Gera e salva os JSONs

YYYY-WXX.json + index.json atualizados

🐙

git push → GitHub

Dispara GitHub Actions automaticamente

⚙️

GitHub Actions faz o deploy

FTP upload dos novos JSONs para o Hostinger

🌐

Site atualizado ao vivo

seudominio.com/curadoria/ com os novos artigos

🎉

Configuração concluída! O Dr. [Seu Nome] recebe os artigos da semana toda segunda-feira — sem abrir o computador, sem copiar nada, sem nenhuma interação manual.

Checklist final

✓ Agente Cowork criado com instruções completas
✓ Schedule semanal configurado (segunda 07:00 BRT)
✓ Repositório GitHub criado (seu-usuario/seu-repositorio)
✓ Estrutura public/curadoria/data/ criada
✓ Personal Access Token gerado e salvo no Keychain
✓ git remote configurado e testado
✓ .github/workflows/deploy.yml criado e commitado
✓ Secrets FTP_SERVER, FTP_USER, FTP_PASS no GitHub
✓ Primeiro deploy manual validado com ✓ success
✓ seudominio.com/curadoria/ acessível ao vivo