Pixelesq

Pixelesq Agent Skills

通过任何 AI Agent 管理基于 Pixelesq 构建的网站。逐个版块构建和编辑页面、向集合中编写内容、调整 SEO 和结构化数据、读取 Search Console 和网站分析数据、管理重定向和图像、重新设置主题样式，并在用户提出要求时发布。

此仓库同时包含三类内容：

• 七个技能，采用 Agent Skills 格式，可由 Claude Code、Cursor、Codex、Copilot、Gemini CLI、Goose 和其他兼容的 Agent 加载。
• 四个专业 Agent，适用于 Claude Code（以及任何读取 agents/*.md 的平台）。
• Pixelesq MCP 连接器，在 .mcp.json 中声明：https://mcp.pixelesq.app/mcp，包含 68 个工具，并通过你的 Pixelesq 账户进行 OAuth 登录。

安装

Claude Code（插件）

/plugin marketplace add pixelesq/pixelesq-skills
/plugin install pixelesq@pixelesq

然后运行 /mcp 并登录 Pixelesq。技能会按需加载，Agent 可通过 @pixelesq:site-manager、@pixelesq:seo-specialist、@pixelesq:content-strategist 和 @pixelesq:design-consultant 使用，连接器则从 .mcp.json 注册。

Claude Code（仅连接器）

claude mcp add --transport http pixelesq https://mcp.pixelesq.app/mcp

Claude.ai 和 Claude Desktop

依次打开“设置”、“连接器”、“添加自定义连接器”，粘贴 https://mcp.pixelesq.app/mcp，然后登录。

ChatGPT

依次打开“设置”、“应用和连接器”、“高级”、“开发者模式”、“创建”，然后粘贴 https://mcp.pixelesq.app/mcp。

Cursor

从 Cursor Marketplace 安装插件，或将服务添加到 mcp.json：

{ "mcpServers": { "pixelesq": { "url": "https://mcp.pixelesq.app/mcp" } } }

VS Code

{ "servers": { "pixelesq": { "type": "http", "url": "https://mcp.pixelesq.app/mcp" } } }

其他平台

克隆此仓库，将 Agent 的技能目录指向 skills/，并配置 MCP 服务 URL https://mcp.pixelesq.app/mcp。客户端可以动态注册，也可以提供客户端 ID 元数据文档；两种方式都受支持。

登录和权限范围

该连接器使用 OAuth 2.1 和 PKCE。使用 Google 登录，或使用 Pixelesq 邮箱和发送给你的验证码登录。需要拥有至少一个项目的 Pixelesq 账户；请在 https://app.pixelesq.ai 注册。

登录时会授予权限范围，并将其写入令牌：projects:read、content:read、content:write、publish、analytics:read。超出授权范围的工具会拒绝请求，并提示客户端重新连接。

如何确保编辑安全

• 每次保存都会更改草稿。只有通过 publish_page、publish_partial、publish_entry、设置 publish: true 的 update_theme，以及 update_form_schema（表单没有草稿）才会更改线上网站；技能会指导 Agent 先进行确认。
• 每次保存都会携带读取前获取的 lastVersion；如果版本已过期，系统会拒绝保存，而不是覆盖他人的更改。
• 发布时会携带用户审阅的内容在读取时获取的 expectedRevisionId 和 expectedHeadAnchor；如果草稿已有变动，系统会拒绝发布。
• 保存时会逐字段合并，数组会整体替换，null 会清除字段。Agent 只会修改用户要求的内容。
• 结构性版块编辑（插入、移除、重新排序、绑定）会使用 idempotencyKey，以便在响应丢失时安全重试。

技能

技能	用途	参考资料
getting-started	连接客户端、完整工具列表、权限范围、安全规则
website-management	页面、区块、局部内容、集合、条目、图片、表单、域名	区块指南（96 种区块类型）、网站配方、区块目录 JSON
content-creation	以品牌语调撰写博客文章、着陆页、条目和区块文案	质量评估标准
design-theming	主题颜色、字体、间距、圆角、外观、按风格选择区块	字体搭配、区块视觉指南
seo-optimization	Search Console、元数据、结构化数据、索引、重定向	JSON-LD 配方、社交元数据规范
analytics-growth	流量、搜索表现、表单、AI 引荐、Web Vitals
site-operations	上线检查、发布顺序、域名、恢复、监控	上线前检查清单、Webhook 模式

Agent

Agent	侧重点
site-manager	端到端处理任何网站任务，并将深度工作委派给专家
seo-specialist	审计、Search Console、元数据、结构化数据、重定向
content-strategist	符合品牌调性的写作和条目创建
design-consultant	主题、排版、构图、区块替换

68 个工具

类别	工具
项目	list_projects、get_project、list_domains、search_content
页面	list_pages、get_page、get_page_content、get_page_revisions、create_page、duplicate_page、update_page_meta、save_page_content、publish_page、unpublish_page、delete_page、revert_page_revision、revert_page_revision_to_version
区块	list_section_types、get_section_defaults、get_section_content、save_section_content、insert_section、remove_section、reorder_sections、bind_section_to_collection、unbind_section_from_collection
集合和条目	list_collections、get_collection、create_collection、update_collection_schema、list_entries、get_entry、create_entry、save_entry_content、update_entry、duplicate_entry、publish_entry、delete_entry
局部内容	list_partials、get_partial_content、save_partial_content、publish_partial、unpublish_partial
SEO 和分析	get_gsc_connection_status、get_search_performance、get_page_index_status、get_all_page_statuses、inspect_url、get_site_analytics、get_ai_referral_analytics
重定向	list_redirects、create_redirect、update_redirect、delete_redirect
表单	list_forms、get_form、create_form、update_form_schema、get_form_submissions
资源和图片	list_assets、upload_asset、upload_image、search_stock_images、generate_image、get_image_job、get_imagegen_quota
主题	get_theme、update_theme

Claude 客户端可使用其中的 62 个工具：三个 AI 图片生成工具在这些客户端中不可用，但可在其他客户端中使用。读取工具不会更改任何内容；写入工具带有提示，可让客户端在运行前征求确认。

仓库布局

pixelesq-skills/
├── .claude-plugin/
│   ├── plugin.json            Claude Code plugin manifest
│   └── marketplace.json       lets the repo install as a marketplace
├── .cursor-plugin/plugin.json Cursor plugin manifest
├── .mcp.json                  the connector for Claude Code (http transport)
├── mcp.json                   the same connector in Cursor's format
├── AGENTS.md                  context for agents that read AGENTS.md
├── CHANGELOG.md
├── agents/                    four specialist agents
├── assets/logo.svg
├── scripts/generate-section-guide.mjs
└── skills/
    ├── getting-started/
    ├── website-management/    references: section-catalog.json, section-guide.md, site-recipes.md
    ├── content-creation/      references: quality-rubric.md
    ├── design-theming/        references: font-pairings.md, section-visual-guide.md
    ├── seo-optimization/      references: json-ld-recipes.md, social-meta-specs.md
    ├── analytics-growth/
    └── site-operations/       references: pre-launch-checklist.md, webhook-patterns.md

保持内容更新

• 区块指南由程序生成。使用连接器的 list_section_types（所有分组及完整详细信息）刷新 skills/website-management/references/section-catalog.json，然后运行 node scripts/generate-section-guide.mjs。
• 工具列表与连接器的 README 保持一致，该 README 由工具注册表生成。
• 发布前请验证：claude plugin validate .
• OpenAI 插件门户要求将技能打包为 ZIP：node scripts/build-openai-bundle.mjs 会生成 dist/pixelesq-openai-plugin.zip（包含 Agent Plugins 清单和 skills/）。

Links

• Pixelesq
• Connector documentation
• Agent Skills
• Model Context Protocol
• Privacy policy and terms

License

MIT