~/orcamento
Quer um site ou sistema feito por mim?
Os projetos para clientes passam pela Web4Business, onde a equipe faz o orçamento.
~/redes
Onde me encontrar
- GitHubRepositórios, experimentos e projetos abertos.@cmacetko (abre em nova aba)
- LinkedInA trajetória profissional: mais de duas décadas construindo a web./in/cmacetko (abre em nova aba)
- InstagramO lado colorido: maquiagens, dia a dia e bastidores.@paloma_macetko (abre em nova aba)
- FacebookOnde compartilho a jornada com amigos e comunidade./cmacetko (abre em nova aba)
paloma_macetko:~/projetos/meuaccio $ cat README.md
MeuAccio
Favoritos em cards e listas, sincronizados com Chrome, Edge, Opera e Firefox pela extensão. Tem app, API REST e servidor MCP para a sua IA salvar e achar links.
- React 19
- Express 5
- MySQL
- Extensão MV3
- MCP + OAuth 2.1
01 · Visão geral
Favoritos em cards, em todo navegador e na sua IA
Um lugar só para os seus links: você cola o endereço e ele vira um card com título, descrição, imagem e ícone lidos do próprio site. Os cards ficam em listas com cor, e cada lista vira uma pasta de favoritos em todos os seus navegadores, com a extensão sincronizando nos dois sentidos. E a sua IA também salva e acha links, pelo servidor MCP ou pela API REST — tudo grátis, sem anúncios.
Os favoritos ficam presos em cada navegador, viram uma lista de títulos sem contexto e não conversam com mais nada. O MeuAccio junta tudo num mural visual, igual em todo navegador e aparelho — e ao alcance da sua IA.
O que faz
- Links em cards com capa, título e descrição lidos do site, em listas com cor
- Extensão para Chrome, Edge, Opera e Firefox que sincroniza os favoritos nos dois sentidos
- App para computador com atalho global para salvar o link copiado, e PWA no celular
- Servidor MCP com OAuth, API REST com OpenAPI e skill para agentes
- Importa os favoritos do navegador e exporta em JSON, CSV ou HTML
02 · Galeria
Telas do produto no ar
Capturadas de meuaccio.com.br. Clique numa tela para ver em tamanho real.
/Página inicial: cole um link, ele vira card e favorito em todo navegador./appO mural: links em cards, listas com cor na lateral, arquivo e lixeira./desenvolvedoresPara quem desenvolve: API REST, skill para agentes e conector MCP./downloadApp para o computador, com atalho global para salvar o link copiado./api/v1/docs/Documentação interativa da API em Swagger UI, gerada do OpenAPI 3.1.
03 · Stack
Do que é feito, camada por camada
Tirado do código-fonte e do que roda em produção.
Front-end
React 19 + Vite 8- SPA com React Router 7; as páginas públicas são pré-renderizadas no build, com JSON-LD, sitemap e llms.txt.
PWA- Service worker e share target: o celular manda links pelo menu Compartilhar.
Express 5- Servidor próprio do front, com compressão e proxy para a API.
Back-end
Node.js + Express 5- API com sessão JWT em cookie httpOnly, helmet, rate limit e validação com Zod.
SSE- O mural se atualiza quando a conta muda em outra aba, outro aparelho, pela API ou pelo MCP.
Leitor de metadados- Busca título, descrição, capa e ícone de cada site, com proteção contra SSRF.
Dados
MySQL + mysql2- Links, listas, sincronização por aparelho, OAuth e sessões, em migrations SQL.
FULLTEXT- Busca por prefixo no índice do banco, sem diferenciar acento e maiúsculas.
Extensão e desktop
Extensão Manifest V3- Um código só para Chrome, Edge, Opera e Firefox, empacotado para cada loja.
Electron 44 + updater- App com atalho global "Salvar link rápido" e atualização automática.
GitHub Actions- Gera os instaladores de Windows, macOS e Linux e publica o release.
IA e integrações
MCP SDK- Servidor MCP com ferramentas de links e listas, e search/fetch no formato do ChatGPT.
OAuth 2.1- PKCE obrigatório, registro dinâmico de cliente e refresh token rotativo — o mesmo login da extensão.
Firebase Auth · Resend · Turnstile- Login com Google, e-mails transacionais e proteção contra bots.
Qualidade
Vitest + supertest- Testes do back-end e do front, incluindo as rotas da API.
node:test · oxlint- Testes da extensão e do app desktop, e lint no front.
04 · Destaques
Decisões técnicas que valem a leitura
Sincronização nos dois sentidos
A extensão ouve os favoritos do navegador, ignora o eco das próprias mudanças e envia em fila; o que muda no mural chega por um feed paginado por revisão. A primeira sincronização é uma união: junta os dois lados e não apaga nada.
Ler outros sites sem abrir a rede interna
Antes de buscar o título e a capa de um link, o servidor confere o IP resolvido a cada redirecionamento e recusa endereços internos, com limite de redirecionamentos, tempo e tamanho.
A mesma URL nunca entra duas vezes
O endereço é normalizado — sem utm_*, fbclid, âncora, com domínio em minúsculas e parâmetros ordenados — e vira um hash. Salvar de novo responde 409 dizendo onde o link já está.
Metadados compartilhados entre contas
Título, descrição e imagem de cada site ficam num cache único, revalidado em lotes com FOR UPDATE SKIP LOCKED: sites populares com mais frequência, falhas com novas tentativas espaçadas.
Imagens por proxy
O navegador nunca busca a capa direto no site: a rota recebe o id do cache, não uma URL. Sem bloqueio de hotlink, sem conteúdo misto e sem rastreamento de quem vê o card.
Um login para a IA e para a extensão
O conector MCP e a extensão entram pelo mesmo OAuth 2.1 do site, com descoberta via .well-known e escopos próprios. Scripts usam API Key pessoal, documentada em OpenAPI e num skill.md para agentes.