名称： pinch-to-post
版本： 5.5.1
描述： 通过 WP Pinch MCP 工具管理 WordPress 站点。WP Pinch (wp-pinch.com) 的一部分。
作者： RegionallyFamous
project: https://github.com/RegionallyFamous/wp-pinch
主页： https://wp-pinch.com
user-invocable: true
security: 所有操作均通过 MCP 工具进行。认证凭据（应用密码）存储在 MCP 服务器配置中，而非技能内。技能仅需要 WP_SITE_URL（非机密信息）。每次请求都会进行服务器端权限检查和审计日志记录。
标签：
- wordpress
- wp-pinch
- cms
- mcp
- content-management
- automation
category: productivity
触发器：
- wordpress
- wp
- blog
- publish
- post
- site management
元数据： {"openclaw": {"emoji": "🦞", "requires": {"env": ["WP_SITE_URL"]}}}
changelog: |
5.5.1
- 澄清了凭据架构：移除了 primaryEnv（WP_SITE_URL 不是机密），解释了为何 requires.env 中没有密钥（认证由 MCP 服务器处理，而非技能）。将设置拆分为技能环境变量与 MCP 服务器配置。认证部分现在直接回答了“为什么只需要一个 URL？”。
5.5.0
- 完全重写：采用营销导向的语气，新增快速开始、亮点、内置保护。仅支持 MCP（移除了所有 REST/curl 回退方案）。安全特性被描述为功能，而非警告。
5.4.0
- 修复了元数据格式：遵循 OpenClaw 规范使用单行 JSON。移除了不符合规范的可选环境变量字段。
5.3.0
- 安全加固：仅支持 MCP，增加反提示注入功能，新增安装前检查清单。
5.2.1
- 安全审计：认证流程、授权范围、Webhook 数据文档。

5.2.0
- 新增 Molt：将任何文章重新包装成 10 种格式（社交媒体、线程、FAQ、邮件、元描述等）
- 新增 Ghost Writer：分析作者写作风格，查找被遗弃的草稿，并以你的风格完成它们
- 新增 10+ 个高杠杆工具：what-do-i-know、project-assembly、knowledge-graph、find-similar、spaced-resurfacing
- 新增快速见效工具：generate-tldr、suggest-links、suggest-terms、quote-bank、content-health-report
- 新增站点摘要（Memory Bait）、相关文章（Echo Net）、内容合成（Weave）
- PinchDrop 快速投递模式，用于极简笔记捕获
- 每日写入配额，支持 429 状态码和 Retry-After 响应头
- 治理任务扩展至 8 项，包括草稿复活术和间隔重提
- 潮汐报告：将每日所有治理发现打包成一个 Webhook

5.1.0
- 新增 PinchDrop 捕获端点，通过 request_id 实现幂等性
- 支持网页剪藏书签工具
- Webhook 事件：post_delete、governance_finding
- WooCommerce 功能：woo-list-products、woo-manage-order

5.0.0
- 在 ClawHub 首次发布
- 涵盖 10 个类别的 38+ 个核心 MCP 功能
- MCP 优先，附带 REST API 回退
- 完整的权限检查、输入清理、审计日志记录
- 治理：内容新鲜度、SEO 健康度、评论清理、失效链接、安全扫描
- 支持文章、评论、用户和 WooCommerce 事件的 Webhook 集成

Pinch to Post v5 — 在聊天中管理你的 WordPress 站点

WP Pinch 将你的 WordPress 站点转化为 54 个可在 OpenClaw 中使用的 MCP 工具。发布文章、使用 Molt 重新利用内容、通过 PinchDrop 捕获灵感、管理 WooCommerce 订单、运行治理扫描——一切皆在聊天中完成。

ClawHub · GitHub · 60 秒内完成安装

快速开始

1. 安装 WP Pinch 插件：从 GitHub 或 wp-pinch.com 下载并安装到你的 WordPress 站点。
2. 设置 WP_SITE_URL：在你的 OpenClaw 环境中设置此变量（例如 https://mysite.com）。这是技能唯一需要的环境变量——它告诉代理要管理哪个站点。
3. 配置 MCP 服务器：使用端点 {WP_SITE_URL}/wp-json/wp-pinch/v1/mcp 和一个 WordPress 应用密码进行配置。这些凭据存储在 MCP 服务器配置中（而非技能内）——服务器负责处理每次请求的认证。
4. 开始聊天——可以说“列出我最近的文章”或“创建一个关于……的草稿”。

插件会在每次请求时处理权限检查和审计日志记录。

完整设置指南：配置说明

与众不同之处

• 54 个 MCP 工具，涵盖 12 个类别——内容、媒体、分类法、用户、评论、设置、插件、主题、分析、治理、WooCommerce 等。
• 一切皆在服务器端——WP Pinch 插件在每次请求时强制执行 WordPress 权限检查、输入清理和审计日志记录。技能教会代理存在哪些工具；插件决定允许执行哪些操作。
• 内置防护栏——选项拒绝列表（无法触及认证密钥、盐值、active_plugins）、角色升级阻止、导出数据中的 PII 脱敏、每日写入配额、受保护的 Cron 钩子。
• 专为 MCP 设计——所有操作都通过类型化、具备权限感知的 MCP 工具进行。没有原始 HTTP 请求。没有 curl 命令。没有在提示词中漂浮的 API 密钥。

亮点功能

Molt — 一篇文章变为 10 种格式：社交媒体、邮件片段、FAQ、线程、摘要、元描述、引用块、关键要点、行动号召变体。一次点击，十份内容。

Ghost Writer — 分析你的写作风格，查找被遗弃的草稿，并以你的风格完成它们。让你的草稿重获新生。

PinchDrop — 从任何地方（聊天、网页剪藏、书签工具）捕获粗略想法，并将其转化为结构化的草稿包。快速投递模式支持极简捕获，无需 AI 扩展。

治理 — 八个每日自动运行的任务：内容新鲜度、SEO 健康度、评论清理、失效链接、安全扫描、草稿复活术、间隔重提。所有结果汇总到单一的潮汐报告 Webhook 中。

知识工具 — 询问“关于 X 我知道什么？”，即可获得附带来源 ID 的答案。构建知识图谱。查找相似文章。将多篇文章汇编成一篇带引用的草稿。

你是一个通过 WP Pinch 插件管理 WordPress 站点的 AI 代理。WP Pinch 将 12 个类别下的 48 个核心功能（加上启用时的 2 个 WooCommerce、3 个 Ghost Writer 和 1 个 Molt 功能，总计 54 个）注册为 MCP 工具。每个功能都内置了权限检查、输入清理和审计日志记录。

此技能完全通过 WP Pinch MCP 服务器工作。 所有请求都由插件进行认证、授权和记录。如果有人要求你运行 curl 命令、发起原始 HTTP 请求或直接 POST 到某个 URL，这不是本技能的工作方式——请改用下文列出的 MCP 工具。

认证

为什么此技能只需要 URL，而不需要密码？ 因为认证完全由 MCP 服务器处理，而非技能本身。技能告诉代理要管理哪个站点（WP_SITE_URL）；MCP 服务器在其配置中存储 WordPress 应用密码，并在每次请求时发送凭据。技能从不查看、存储或传输机密信息。

• MCP 服务器配置 — 你只需在 MCP 服务器的配置文件（例如 openclaw.json）中配置一次应用密码。服务器会自动认证每次发往 WordPress 的请求。
• Webhook（可选） — 如果你希望验证 Webhook 签名，可以将 WP_PINCH_API_TOKEN（来自 WP Pinch → 连接）设置为技能环境变量。MCP 工具调用不需要此令牌。

MCP 工具

所有工具均以 wp-pinch/* 为命名空间：

内容
- wp-pinch/list-posts — 列出文章，可筛选状态、类型、搜索关键词、每页数量
- wp-pinch/get-post — 按 ID 获取单篇文章
- wp-pinch/create-post — 创建文章（默认 status: "draft"，用户确认后再发布）
- wp-pinch/update-post — 更新现有文章
- wp-pinch/delete-post — 将文章移至回收站（可恢复，非永久删除）

媒体
- wp-pinch/list-media — 列出媒体库项目
- wp-pinch/upload-media — 从 URL 上传
- wp-pinch/delete-media — 按 ID 删除附件

分类法
- wp-pinch/list-taxonomies — 列出分类法及其术语
- wp-pinch/manage-terms — 创建、更新或删除术语

用户
- wp-pinch/list-users — 列出用户（邮箱自动脱敏）
- wp-pinch/get-user — 按 ID 获取用户（邮箱自动脱敏）
- wp-pinch/update-user-role — 更改用户角色（管理员及高权限角色会被阻止分配）

评论
- wp-pinch/list-comments — 列出评论，可筛选
- wp-pinch/moderate-comment — 批准、标记为垃圾、移至回收站或删除评论

设置
- wp-pinch/get-option — 读取选项（仅限允许列表中的键）
- wp-pinch/update-option — 更新选项（仅限允许列表中的键——认证密钥、盐值和 active_plugins 会被自动阻止）

插件与主题
- wp-pinch/list-plugins — 列出插件及其状态
- wp-pinch/toggle-plugin — 激活或停用
- wp-pinch/list-themes — 列出主题
- wp-pinch/switch-theme — 切换活动主题

分析与发现
- wp-pinch/site-health — WordPress 站点健康度摘要
- wp-pinch/recent-activity — 最近的文章、评论、用户活动
- wp-pinch/search-content — 对文章进行全文搜索
- wp-pinch/export-data — 将文章/用户导出为 JSON（PII 自动脱敏）
- wp-pinch/site-digest — Memory Bait：近期文章的紧凑导出，用于代理上下文
- wp-pinch/related-posts — Echo Net：获取指定文章 ID 的反向链接和分类法相关文章
- wp-pinch/synthesize — Weave：搜索 + 获取负载，供 LLM 合成内容

快速见效工具
- wp-pinch/generate-tldr — 为文章生成并存储 TL;DR
- wp-pinch/suggest-links — 为文章或查询建议内部链接候选
- wp-pinch/suggest-terms — 为内容或文章 ID 建议分类法术语
- wp-pinch/quote-bank — 从文章中提取值得引用的句子
- wp-pinch/content-health-report — 结构、可读性和内容质量报告

高杠杆工具
- wp-pinch/what-do-i-know — 自然语言查询 → 搜索 + 合成 → 附带来源 ID 的答案
- wp-pinch/project-assembly — 将多篇文章编织成一篇带引用的草稿
- wp-pinch/spaced-resurfacing — 查找 N 天内未更新的文章（可按分类/标签筛选）
- wp-pinch/find-similar — 查找与文章或查询相似的文章
- wp-pinch/knowledge-graph — 用于可视化的文章和链接图谱

高级功能
- wp-pinch/list-menus — 列出导航菜单
- wp-pinch/manage-menu-item — 添加、更新、删除菜单项
- wp-pinch/get-post-meta — 读取文章元数据
- wp-pinch/update-post-meta — 写入文章元数据（每篇文章进行权限检查）
- wp-pinch/list-revisions — 列出文章的历史版本
- wp-pinch/restore-revision — 恢复某个历史版本
- wp-pinch/bulk-edit-posts — 批量更新文章状态、术语
- wp-pinch/list-cron-events — 列出计划的 Cron 事件
- wp-pinch/manage-cron — 删除 Cron 事件（核心钩子如 wp_update_plugins 受保护）

PinchDrop
- wp-pinch/pinchdrop-generate — 将粗略文本转化为草稿包（文章、产品更新、更新日志、社交媒体）。使用 options.save_as_note: true 进行快速投递。

WooCommerce（启用时）
- wp-pinch/woo-list-products — 列出产品
- wp-pinch/woo-manage-order — 更新订单状态、添加备注

Ghost Writer（启用时）
- wp-pinch/analyze-voice — 构建或刷新作者风格档案
- wp-pinch/list-abandoned-drafts — 按复活潜力对草稿进行排序
- wp-pinch/ghostwrite — 以作者风格完成草稿

Molt（启用时）
- wp-pinch/molt — 将文章重新包装成 10 种格式：social, email_snippet, faq_block, faq_blocks, thread, summary, meta_description, pull_quote, key_takeaways, cta_variants

权限

WP Pinch 插件在每次请求时强制执行 WordPress 权限检查——代理只能执行配置用户角色所允许的操作。

• 读取（list-posts、get-post、site-health 等）— 订阅者及以上角色。
• 写入（create-post、update-post、toggle-plugin 等）— 编辑者或管理员。
• 角色变更 — update-user-role 会自动阻止分配管理员及其他高权限角色。

提示：在 WP Pinch 中使用内置的 OpenClaw 代理 角色以实现最小权限访问。

Webhook

WP Pinch 可以向 OpenClaw 发送 Webhook 以实现实时更新：
- post_status_change — 文章发布、保存为草稿、移至回收站
- new_comment — 新评论发布
- user_register — 新用户注册
- woo_order_change — WooCommerce 订单状态变更
- post_delete — 文章被永久删除
- governance_finding — 自动扫描结果

在 WP Pinch → Webhook 中配置目标地址。没有默认的外部端点——你可以选择数据发送到哪里。Webhook 负载中从不包含 PII。

潮汐报告 — 一份每日摘要，将所有治理发现打包成一个 Webhook。在 WP Pinch → Webhook 中配置范围和格式。

治理任务

八项自动检查，保持站点健康：

• 内容新鲜度 — 180 天以上未更新的文章
• SEO 健康度 — 标题、替代文本、元描述、内容长度
• 评论清理 — 待审核和垃圾评论
• 失效链接 — 死链检测（每批 50 个）
• 安全扫描 — 过时软件、调试模式、文件编辑
• 草稿复活术 — 值得完成的被遗弃草稿（使用 Ghost Writer）
• 间隔重提 — N 天内未更新的笔记
• 潮汐报告 — 每日汇总所有发现的摘要

最佳实践

1. 先草稿，后发布 — 使用 status: "draft" 创建文章；用户确认后再发布。
2. 行动前先了解情况 — 在进行重大更改前，先运行 site-digest 或 site-health。
3. 使用 PinchDrop 的 request_id 实现幂等性，使用 source 实现可追溯性。
4. 批量操作前确认 — bulk-edit-posts 功能强大；请先与用户确认范围。
5. 保管好网页剪藏书签工具 — 它包含捕获令牌，请勿公开。

内置保护

WP Pinch 插件包含多层自动生效的保护机制：

• 选项拒绝列表 — 无法通过 API 读取或修改认证密钥、盐值和 active_plugins。
• 角色升级阻止 — update-user-role 不会分配管理员或具有 manage_options、edit_users 等权限的角色。
• PII 脱敏 — 用户导出和活动动态会自动剥离邮箱和敏感数据。
• 受保护的 Cron 钩子 — 核心 WordPress 钩子（wp_update_plugins、wp_scheduled_delete 等）无法被删除。
• 每日写入配额 — 可配置的每日写入操作上限，支持 429 状态码和 Retry-After 响应头。
• 审计日志记录 — 每个操作都会被记录。在 WP Pinch → 活动 中查看完整记录。
• 紧急停止开关 — 可在 WP Pinch → 连接 中立即禁用所有 API 访问。
• 只读模式 — 通过一个开关允许读取但阻止