Posy
Crie e edite uma página de link-in-bio feita à mão: adicione links, escolha um visual e publique em posy.page.
Servidor MCP hospedado
npx add-mcp 'https://posy.page/api/mcp'Instala no Claude Code, Codex, Cursor e outros
Documentação
Posy é uma página de link-in-bio com aparência artesanal.
Escolha um visual, adicione seus links, publique. Edite você mesmo, ou deixe sua IA fazer isso.
Gratuito e de código aberto. Use em posy.page ou rode você mesmo.
Site · Documentação · Conecte sua IA · Self-host · Contribuindo

O que é Posy
Posy é uma página de link-in-bio com aparência artesanal. Você escolhe um visual, adiciona seus links e publica. Edite você mesmo em um estúdio tranquilo, ou peça para sua IA fazer isso por você. Sua página é um pequeno arquivo JSON que você pode levar para qualquer lugar.

Os visuais
Os mesmos links, desenhados como uma mesa de madeira com polaroids, uma gravura japonesa, uma área de trabalho deixada aberta, uma aquarela, uma impressão de duas tintas ou a tela de um netrunner. Cada visual tem quatro paletas, e você pode trocar a qualquer momento.
![]() | ![]() | ![]() |
![]() | ![]() | ![]() |
No posy.page, Painted, Desk e Lofi são gratuitos, e os outros vêm com o Pro. No self-hosted, todos os visuais estão desbloqueados. Veja-os ao vivo na galeria de visuais.
Veja cada visual em uma área de trabalho
![]() | ![]() |
![]() | ![]() |
![]() | ![]() |
Blocos, paletas e layouts
| Bloco | O que mostra |
|---|---|
| Link | Favicon, título e uma imagem de pré-visualização opcional |
| Social | 29 plataformas (X, Instagram, GitHub, LinkedIn, YouTube, TikTok, Bluesky, Threads, Substack…) e e-mail |
| Nota | Texto curto com negrito, itálico e links |
| Seção | Um título que inicia um novo grupo de blocos |
| Imagem | Sua foto ou arte, com legenda e link opcionais |
| Vídeo | YouTube, carrega apenas quando reproduzido |
| Música | Incorporação do Spotify |
| GitHub | Um repositório com estrelas e linguagem ao vivo, atualizado diariamente |
Três layouts: bento (uma grade), list (uma coluna) e canvas (posicione blocos livremente). Fotos podem ser impressas natural, mono, dither ou ascii.
Além das paletas de cada visual: Cream, Lavender, Mint, Sky, Peach, Paper, Blush, Sage, Midnight, Mocha, Dusk e Ocean, qualquer cor de destaque e pares de fontes.

Crie sua página
Reivindique seu nome em posy.page. Cole um link em qualquer lugar para adicionar um bloco, arraste para organizar e pressione Publicar. Sua página fica no ar em um minuto.
Só olhando? Abra posy.page/new, cole alguns links e veja sua página antes de se cadastrar.
Gratuito, Pro e self-hosted
| posy.page Gratuito | posy.page Pro | Self-hosted | |
|---|---|---|---|
| Blocos, editor, API, MCP, CLI | Todos | Todos | Todos |
| Visuais | Painted, Desk, Lofi | Todos | Todos |
| Seu próprio domínio | Não | Sim, HTTPS configurado para você | Sim, aponte para seu servidor |
| Analytics | Básico | 12 meses + CSV | 12 meses + CSV |
| Rodapé "Feito com Posy" | Exibido | Oculte-o | Oculte-o |
| Configuração e manutenção | Nenhuma | Nenhuma | Você |
O Pro custa $5 por mês ou $48 por ano. Sua página funciona igual em qualquer lugar: Configurações → Baixar page.json em um, Importar page.json no outro.

Conecte sua IA
Posy tem um servidor MCP hospedado, então sua IA pode criar e editar sua página. Você entra com sua conta Posy; não há chave para copiar. Tudo o que ela faz vai para seu rascunho, e nada fica no ar até você, ou ela, publicar.
https://posy.page/api/mcp
Um clique
Alguns passos
claude mcp add --transport http posy https://posy.page/api/mcp # Claude Code, then /mcp → Authenticate
codex mcp add posy --url https://posy.page/api/mcp # Codex
No ChatGPT, abra Plugins, pressione +, escolha Adicionar servidor MCP personalizado, cole a URL e selecione OAuth.
No seu próprio servidor, use https://YOUR-POSY/api/mcp. Posy está no registro oficial de MCP como io.github.Himanshu-Sangshetti/posy.
Sem conector? Entregue um arquivo de página
Qualquer chat pode escrever sua página como um pequeno arquivo JSON. Cole-o em posy.page/new e ele se torna uma página.
Ou pule o arquivo: uma IA pode entregar um link que abre uma pré-visualização ao vivo, sem necessidade de login.
https://posy.page/new?name=Mira%20Sol&look=washi&links=https://github.com/mira,hi@mira.so
O arquivo de página, ferramentas MCP, REST, llms.txt e a CLI
{
"posy": 1,
"name": "Mira Sol",
"bio": "Writer and editor.",
"location": "Lisbon",
"look": "washi",
"links": [
"https://substack.com/@mira",
"https://x.com/mira",
"hi@mira.so",
{ "heading": "Writing" },
"https://mira.so/letters"
]
}
Cada campo: o arquivo de página.
| Ferramenta | O que faz |
|---|---|
get_page | Seu rascunho, URL pública e o que fazer em seguida |
create_page | Reivindique um nome de usuário e crie sua página (uma vez) |
import_page | Carregue uma página inteira de um arquivo de página |
add_tile | Adicione um link, ou muitos de uma vez. Posy escolhe o bloco certo |
update_tile, move_tile, remove_tile | Altere, reordene ou exclua um bloco |
set_theme, set_profile | Visual, cores, fontes, nome e bio |
publish | Torne o rascunho público |
list_options | Visuais, paletas, fontes e tamanhos permitidos |
| Superfície | Onde |
|---|---|
| REST | /api/v1/page com uma chave Bearer da página Agentes. Especificação: /openapi.json, guia: Referência da API |
| JSON público | /api/v1/public/<username> para qualquer página publicada |
llms.txt | posy.page/llms.txt para o aplicativo, /<username>/llms.txt para qualquer página |
| Schemas | schema/page.schema.json e /schema/brief.schema.json |
| Plugin | Habilidades de Claude Code e Cursor em plugin/ |
export POSY_URL=https://posy.page POSY_API_KEY=posy_...
npm run posy -- add https://github.com/owner/repo --size w
npm run posy -- theme --preset moonlit --layout list
npm run posy -- publish
Guia completo: docs/ai-agents.md. Trabalhando neste repositório com um agente de codificação? Leia AGENTS.md.

Rode você mesmo
Ou com Docker:
git clone https://github.com/Himanshu-Sangshetti/posy.git && cd posy
docker build -t posy . && docker run -p 3000:3000 -v posy-data:/data \
-e NEXT_PUBLIC_SITE_URL=http://localhost:3000 -e BETTER_AUTH_URL=http://localhost:3000 \
-e BETTER_AUTH_SECRET=$(openssl rand -base64 32) posy
Abra http://localhost:3000 e cadastre-se: a primeira conta é dona da instância, e todos os visuais estão desbloqueados. Domínios, backups e todas as configurações: guia de self-hosting · .env.example
Construído com
Next.js 16 · React 19 · TypeScript · Tailwind CSS 4 · Motion · dnd-kit · shadcn/ui · Better Auth · Drizzle + libSQL · Zod · MCP
Um schema, src/lib/schema.ts, descreve uma página. Ele alimenta o JSON Schema, a API REST, as ferramentas MCP e o editor, para que nunca se desalinhem.
Como as peças se encaixam
flowchart LR
studio["Studio<br/>(browser)"] --> app
agent["AI agents"] -- "MCP /api/mcp" --> app
scripts["Scripts, CLI"] -- "REST /api/v1" --> app
app["Next.js app<br/>page schema in Zod"] --> db[("SQLite or Turso<br/>(Drizzle + libSQL)")]
app --> files[("Uploads<br/>data dir or Vercel Blob")]
app --> page["/username<br/>+ llms.txt + public JSON"]
| Onde | O quê |
|---|---|
src/components/page/styles/ | Os visuais, um .tsx + .css cada |
src/components/studio/ | O editor |
src/app/api/ | REST (v1), MCP (mcp), autenticação e uploads |
src/lib/ | Schema, visuais, paletas, fontes, detecção de links |
A partir do código-fonte: npm install && npm run dev (Node 22 ou 24). Seus dados locais ficam em ~/.posy.
Contribuindo
Issues e pull requests são bem-vindos. Comece com CONTRIBUTING.md.
- Adicione um visual. Um visual é um arquivo
.tsxe um.cssmais uma página de laboratório para verificá-lo em cada paleta. Os passos: Adicionando um visual. - Pegue uma issue. Boas primeiras issues e ideias de visuais são um bom lugar para começar.
- Antes de um PR:
npm run check,npm test, enpm run e2epara mudanças de UI.
Comunidade, segurança e licença
- Perguntas e ideias: issues. Siga o Código de Conduta.
- Encontrou uma vulnerabilidade? Veja SECURITY.md e reporte-a em particular.
- Posy é licenciado sob MIT. A arte que acompanha os looks é de domínio público, CC0, ou feita para Posy; cada arquivo e sua fonte está em public/looks/CREDITS.md. Parte dela foi gerada com Krea 2, cuja licença comunitária permite uso comercial apenas se sua empresa fatura menos de US$ 1 milhão por ano. Leia a nota no arquivo de créditos primeiro.
- Arquivos de marca e cores: BRAND.md.
Feito à mão, com um gato dormindo na mesa.



















