Posy

Name: Posy
Author: Himanshu-Sangshetti

远程服务

posy.page社交媒体91 周前更新

代码仓库访问官网

关于 Posy

Posy 是面向个人的开源简介链接页面工具，可自行编辑，也可借助 AI 创建和更新页面。它提供多种视觉样式与布局，并以便于迁移的 JSON 文件保存页面。

主要功能

01用链接和图块创建页面
02选择样式、配色与布局
03通过编辑器或 AI 修改草稿
04导入和导出 page.json
05发布页面或自行托管

适用场景

01创建个人简介链接页面
02让 AI 整理和更新页面内容
03在托管版与自托管版间迁移页面
04发布链接、社交资料、图片和媒体

MCP 相关

Posy 提供托管的 MCP 服务，地址为 https://posy.page/api/mcp。MCP 客户端可创建和编辑页面草稿、设置外观并发布页面。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://posy.page/api/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http himanshu-sangshetti-posy https://posy.page/api/mcp

Cursor.cursor/mcp.json{"mcpServers":{"himanshu-sangshetti-posy":{"type":"http","url":"https://posy.page/api/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"himanshu-sangshetti-posy":{"type":"http","url":"https://posy.page/api/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"himanshu-sangshetti-posy":{"type":"http","url":"https://posy.page/api/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"himanshu-sangshetti-posy":{"serverUrl":"https://posy.page/api/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

posy：一个看起来像是你亲手制作的个人主页链接页面。一个女孩在漂浮于彩绘天空中的小岛上伏案工作，旁边有一只风筝在飞。

Posy 是一个看起来像手工制作的个人主页链接页面。

选个风格，添加链接，然后发布。你可以自己编辑，也可以交给 AI 来编辑。
免费且开源。可在 posy.page 使用，也可以自行运行。

网站 · 文档 · 连接你的 AI · 自托管 · 参与贡献

README 配图

什么是 Posy

Posy 是一个看起来像手工制作的个人简介链接页。挑选一种风格，添加链接，然后发布。你可以在宁静的工作室里亲自编辑，也可以让 AI 帮你完成。你的页面是一个小巧的 JSON 文件，可以随身携带。

三个步骤：1，挑选一种风格。2，添加链接，Posy 会将每个链接变成合适的卡片。3，发布到 posy.page/you，或者让 AI 帮你完成所有步骤。

README 配图

多种风格

相同的链接，可以呈现为摆着拍立得照片的木桌、日本版画、打开的桌面、透明水彩、双色印刷画，或网行者的屏幕。每种风格都有四种配色，随时可以切换。

桌面端风格简介：Desk、Washi、Lofi、Painted、Cobalt 和 Night。

在 posy.page 上，Painted、Desk 和 Lofi 可免费使用，其他样式需 Pro。自托管版本可解锁所有外观。在外观图库中查看实时效果。

查看每种外观在桌面端的效果

方块、调色板和布局

| 磁贴 | 显示内容 | |---|---| | 链接 | 网站图标、标题和可选的预览图片 | | 社交 | 29 个平台（X、Instagram、GitHub、LinkedIn、YouTube、TikTok、Bluesky、Threads、Substack……）以及电子邮件 | | 备注 | 支持**粗体**、*斜体*和链接的简短文本 | | 分区 | 用于开启一组新磁贴的标题 | | 图片 | 你的照片或作品，可选配说明文字和链接 | | 视频 | YouTube，仅在播放时加载 | | 音乐 | Spotify 嵌入内容 | | GitHub | 显示实时星标数和语言的代码库，每天刷新一次 |

三种布局：bento（网格）、list（单列）和 canvas（自由摆放磁贴）。照片可处理为 natural、mono、dither 或 ascii 风格。在每种外观的配色方案上，还可搭配任意强调色和字体组合：Cream、Lavender、Mint、Sky、Peach、Paper、Blush、Sage、Midnight、Mocha、Dusk 和 Ocean。

README 配图

创建你的页面

在 posy.page 认领你的名称。 在任意位置粘贴链接即可添加磁贴，拖动磁贴进行排列，然后按下 Publish。一分钟内，你的页面就会上线。

只是想看看？ 打开 posy.page/new，粘贴几个链接，无需注册即可预览页面。

免费版、Pro 版和自托管版

	posy.page Free	posy.page Pro	Self-hosted
磁贴、编辑器、API、MCP、CLI	全部	全部	全部
外观	Painted、Desk、Lofi	全部	全部
自定义域名	否	是，自动为你配置 HTTPS	是，指向你的服务
分析	基础版	12 个月 + CSV	12 个月 + CSV
“Made with Posy”页脚	显示	可隐藏	可隐藏
设置和维护	无	无	由你负责

Pro 版每月 $5，或每年 $48。你的页面在不同版本间均可正常使用：在一处选择 Settings → Download page.json，在另一处选择 Import page.json。

README 配图

## 连接你的 AI

Posy 提供托管的 MCP 服务，因此你的 AI 可以创建和编辑你的页面。你只需使用 Posy 账号登录，无需复制密钥。 AI 的所有操作都会保存为草稿；只有你或它发布后，内容才会公开。

https://posy.page/api/mcp

一键连接

几步即可完成

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

在 ChatGPT 中，打开 Plugins，点击 +，选择 Add custom MCP server，粘贴 URL 并选择 OAuth。在你自己的服务器上，使用 https://YOUR-POSY/api/mcp。Posy 已列入官方 MCP 注册表，名称为 io.github.Himanshu-Sangshetti/posy。

没有连接器？给它一个页面文件

任何聊天都可以将你的页面写成一个小型 JSON 文件。将它粘贴到 posy.page/new，即可生成一个页面。

左侧是一个 JSON 页面文件，包含姓名 Mira Sol、washi 风格和几个链接。一支箭头指向手机上以 Washi 风格呈现的同一页面。

或者跳过文件：AI 可以给你一个链接，打开实时预览，无需登录。

https://posy.page/new?name=Mira%20Sol&look=washi&links=https://github.com/mira,[email protected]

页面文件、MCP 工具、REST、llms.txt 和命令行

{
  "posy": 1,
  "name": "Mira Sol",
  "bio": "Writer and editor.",
  "location": "Lisbon",
  "look": "washi",
  "links": [
    "https://substack.com/@mira",
    "https://x.com/mira",
    "[email protected]",
    { "heading": "Writing" },
    "https://mira.so/letters"
  ]
}

所有字段：页面文件。

工具	功能
`get_page`	你的草稿、公开 URL，以及下一步操作
`create_page`	认领用户名并创建页面（仅一次）
`import_page`	从页面文件加载完整页面
`add_tile`	添加一个或多个链接。Posy 会选择合适的图块
`update_tile`、`move_tile`、`remove_tile`	更改、重新排序或删除图块
`set_theme`、`set_profile`	外观、颜色、字体、姓名和简介
`publish`	发布草稿
`list_options`	可选的外观、配色、字体和尺寸

接口	位置
REST	`/api/v1/page`，使用 Agents 页面上的 Bearer 密钥。规范：`/openapi.json`，指南：API 参考
公开 JSON	`/api/v1/public/<username>`，用于获取任何已发布页面
`llms.txt`	应用： `posy.page/llms.txt`，任意页面：`/<username>/llms.txt`
Schema	`schema/page.schema.json` 和 `/schema/brief.schema.json`
插件	`plugin/` 中的 Claude Code 和 Cursor 技能

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

完整指南：docs/ai-agents.md。正在使用编码 Agent 开发此代码库？请阅读 AGENTS.md。

README 配图

自行运行

或者使用 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

打开 http://localhost:3000 并注册：第一个账户拥有此实例，所有外观均已解锁。域名、备份和所有设置：自托管指南 · .env.example

构建技术

Next.js 16 · React 19 · TypeScript · Tailwind CSS 4 · Motion · dnd-kit · shadcn/ui · Better Auth · Drizzle + libSQL · Zod · MCP

一个 Schema src/lib/schema.ts 描述一个页面。它驱动 JSON Schema、REST API、MCP 工具和编辑器，因此它们始终保持一致。

各部分如何协同

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"]

位置	内容
`src/components/page/styles/`	各种外观，每种各有一个 `.tsx` 和 `.css` 文件
`src/components/studio/`	编辑器
`src/app/api/`	REST（`v1`）、MCP（`mcp`）、身份验证和上传
`src/lib/`	Schema、外观、配色、字体、链接检测

从源码运行：npm install && npm run dev（Node 22 或 24）。本地数据保存在 ~/.posy。

## 贡献

欢迎提交问题和拉取请求。请先阅读 CONTRIBUTING.md。

添加外观。 外观由一个 .tsx 文件、一个 .css 文件以及一个用于在每种调色板中检查效果的实验页面组成。具体步骤：添加外观。
认领问题。 适合新手的问题和外观创意是不错的起点。
提交 PR 前： 对 UI 的更改，请运行 npm run check、npm test 和 npm run e2e。

社区、安全与许可证

问题和想法：问题列表。请遵守行为准则。
发现漏洞？请查看 SECURITY.md，并私下报告。
Posy 采用 MIT 许可证。随外观提供的艺术作品属于公有领域、采用 CC0 许可，或专为 Posy 创作；每个文件及其来源都列在 public/looks/CREDITS.md 中。其中一些作品由 Krea 2 生成，其社区许可证仅允许年收入低于 100 万美元的公司将其用于商业用途。请先阅读致谢文件中的说明。
品牌文件和颜色：BRAND.md。