跳至内容
文档

通过 MCP 用你自己的 AI 写作

让 Claude 或其他 MCP 客户端从内容队列中写作:认领选题、阅读写作简报、提交初稿、译文和封面,或在 Mac 上无人值守运行。

资源 → 内容 → 设置阅读需 3 分钟

内容引擎还有第二位写手:你自己的 AI。任何登录了 AutoPSEO 的 MCP 客户端,例如 Claude Code、Claude 应用或 Cursor,都可以从同一个队列中领取选题,阅读相同的简报和规则,并提交通过与 AutoPSEO 写手相同检查的初稿。以这种方式写成的初稿不计入每月文章配额。你可以在对话中与它协作,也可以让它按计划无人值守地写作。

连接你的 AI

MCP 端点为 https://app.autopseo.com/mcp。有两种接入方式,都在你账户的 MCP & API 页面:

  • 在“Connect by signing in”下使用 OAuth 登录。在 Claude Code 中:claude mcp add --transport http autopseo https://app.autopseo.com/mcp,然后执行 /mcp 并选择 Authenticate。
  • API 密钥,以 apk_live_ 开头,通过 Authorization: Bearer <key> 发送。会产生更改的内容工具需要 Read & write 密钥;Read only 密钥只能使用读取类工具。

你的角色同样重要:拥有查看权限的成员只能使用读取类工具,而只被邀请加入部分网站的成员只能看到这些网站。完整的工具目录(包括 Search Console 工具)见 MCP 页面;密钥管理见 MCP & ChatGPT app。

在内容页面的 Settings 下,Who writes the topics in the queue 决定由谁处理队列:AutoPSEO, at the pace above 或 Your own AI, through MCP。选择你自己的 AI 后,AutoPSEO 的写手将不再领取队列中的任务。无论选哪一项,“Your own AI can write and rewrite articles at any time, whichever you choose here.”要进行认领和提交,该网站的引擎必须处于开启状态,且套餐有效。

内容工具

工具权限作用
content_instructions读取根据某个网站的设置生成的、一次完整无人值守运行的全部流程
content_report读取设置、内容类型、配额、任务数量、最新的 20 篇已上线文章以及被拒绝的交付
content_list_tasks读取任务列表,按潜力从高到低排列,并标明每个任务由谁持有
content_find_pages读取查找你网站上与某个查询匹配的页面,用于检查覆盖情况和挑选链接
content_get_page读取一篇文章的线上正文、审核中的草稿、历史修订版本,以及 28 天内的搜索数据
content_get_translation读取某一种语言:原文、翻译规则和当前译文
content_get_brief付费写作规则、简报、允许使用的链接、类型化页面的地址,以及是否需要封面
content_add_topics写入规划 1 到 200 个选题;它们会经过筛选关卡和审核
content_claim写入将任务保留两小时:按任务、按页面(rewrite、optimize 或 refresh)或按关键词认领
content_submit写入检查并保存草稿;存在错误时不会保存任何内容
content_submit_translation写入检查并保存草稿或已上线文章的某一种语言版本
content_cover写入检查场景描述,并获取图像提示词、参考图和上传地址
content_set_cover写入设置或替换封面,或获取封面的上传地址
content_publish写入批准草稿,或恢复到较早的修订版本
content_unpublish写入下线一篇文章
content_merge写入将一篇文章合并到另一个页面,并设置 301 重定向
content_decline写入永久拒绝一个任务,并说明原因
content_propose_value写入在询问你的网站之后,为类型化内容类型提议一个新值
content_submit_value写入提交新值的相关事实以供审核
content_remove_path写入请求你的网站下线某个值的路径

只读密钥或拥有查看权限的成员,会被所有非读取类工具拒绝。负责发布、下线、合并或移除路径的工具,会提示 AI 仅在获得你许可后才执行操作。

撰写文章

  1. 选择任务。 content_list_tasks 显示队列中的内容;content_find_pages 检查你的网站是否已覆盖该主题。
  2. 认领任务。 content_claim { taskId } 将任务保留两小时,再次认领会续期。你也可以通过 pageId 和 kind 认领一篇已上线的文章,或者从关键词开始,还可以选择性地附带内容类型键。关键词会先经过筛选关卡。
  3. 阅读简报。 content_get_brief 返回 rules(与 AutoPSEO 写手获得的写作规则相同)、brief、allowedLinks 和 cover.wanted。首次调用会研究搜索结果并消耗研究额度;之后针对同一任务的调用是免费的。
  4. 撰写并提交。 按照交付中描述的格式,将文章以 JSON 形式通过 content_submit 发送。如果未通过某项检查,返回内容会以“Not saved. Fix these and submit again:”开头并附上问题列表;allowedLinks 之外的链接会被转换为粗体文字。当任务修改的是已上线文章时,请传入 baseRev,即你所依据的修订版本;如果文章已有更新,提交会因冲突而被拒绝。
  5. 翻译。 对每一种其他语言,先调用 content_get_translation,再调用 content_submit_translation。各语言可以并行提交。参见翻译。
  6. 添加封面(当简报表明需要封面时,见下文)。
  7. 发布。 草稿会停留在审核状态。content_publish { taskId } 会批准它,该工具只在你明确表示同意时才会使用。

保留时间到期的任务会由每五分钟运行一次的调度程序释放:任务会回到队列中。content_decline 会永久拒绝一个任务,需要填写 3 到 300 个字符的原因,此后该任务不会再被推荐。

修改审核中的草稿

当审核人要求修改时,无需把草稿退回:

  1. 使用任务(或页面,或关键词)调用 content_claim,会把你的草稿带回写作状态,这样在此期间无人能将其发布。
  2. content_get_page 将草稿以 draft 返回。
  3. content_submit 在同一地址保存下一个修订版本,并将旧草稿标记为已被替换。
  4. 重新提交译文:新的修订版本只包含它自己的语言,而 content_get_translation 会把被替换草稿的译文作为 current 提供给你。

如果保留时间先到期,草稿将保持原样返回审核。

提示词

服务器还提供提示词(prompt),在 Claude Code 中它们显示为斜杠命令,例如 /mcp__autopseo__write-articles:

提示词参数引导的流程
write-articlessite、count(1 到 10)逐步完成从队列中写文章
revise-draftsite、draft、changes修改处于审核中的草稿
optimize-pagesite、page改进一篇已上线的文章
refresh-decayedsite、limit(最多 10)更新点击量下滑的文章
connect-repoarticlesUrl在你网站的代码中构建带签名的 webhook 接收端

用你自己的 AI 制作封面

当你的网站展示封面时,content_get_brief 会返回 cover.wanted。你的 AI 可以通过 content_submit 的 cover 参数提交它生成的图片(一个 https 的 url,或最大 2.5 MB 的 base64 data),也可以用 PUT 把文件上传到 content_submit 返回的 coverUploadUrl,或稍后通过 content_set_cover 设置。它还可以使用 AutoPSEO 自带的提示词,通过 content_cover 来绘制。格式、尺寸和检查规则见封面。

费用说明

  • 你自己的 AI 提交的初稿和译文不计入每月文章配额,提交本身也免费。
  • 简报首次查看搜索结果,以及为某个可归入两种类型的关键词挑选内容类型时所调用的模型,会消耗研究额度。
  • 添加选题、拒绝任务和读取类工具均免费。在由 AutoPSEO 负责翻译的网站上,批准一份缺少语言版本的草稿,会启动翻译并消耗研究额度。

在 Mac 上无人值守运行

content_instructions 会返回一次无人值守运行对某个网站应完成的全部事项:生成报告、完成上一次运行遗留的工作、在花费额度获取简报前检查覆盖情况、拒绝重复选题、撰写、翻译、添加封面,并且仅在该网站的审核功能关闭时才发布。它从不下线文章,也不回滚文章,并以脚本可读取的一行结果收尾:

AUTOPSEO_RESULT property=<id> published=<n> review=<n> declined=<n> failed=<n> values=<n>

AutoPSEO 写手是一组 macOS 脚本,它在 launchd 下使用你自己的 Claude Code 和你自己的 Claude 订阅来运行上述流程。请联系我们获取这些脚本。设置步骤:

  1. 将 Claude Code 连接到 AutoPSEO(使用 Claude 中的连接器,或运行 claude mcp add --scope user --transport http autopseo https://app.autopseo.com/mcp,再在 /mcp 下选择 Authenticate)。
  2. 运行 ./install.sh。它会创建 ~/.autopseo/,其中包含 run.sh、cover-mcp.mjs 和一个示例 writer.json,并创建一个每天 15:07 运行的 launchd 任务(可通过 AUTOPSEO_HOUR 和 AUTOPSEO_MINUTE 修改)。该任务此时尚未加载。
  3. 填写 ~/.autopseo/writer.json:properties(每项包含 id,以及可选的 limit,即每次运行的新文章数量,默认 8,最多 20)、model 和 fallbackModel、供翻译子代理使用的可选 subagentModel、同一网站两次运行之间间隔的天数 everyDays(默认 3),以及 covers(codex,grok,或 off)。
  4. 试运行一次:AUTOPSEO_FORCE=1 ~/.autopseo/run.sh,然后查看 ~/.autopseo/logs/history.log。
  5. 使用 launchctl load ~/Library/LaunchAgents/com.autopseo.writer.plist 加载计划任务。

每次运行会为每个网站启动一个 claude -p,且只允许使用 AutoPSEO 工具和子代理:不能使用 shell、不能访问文件、不能联网。只有当运行输出结果行时才算成功。当 values 大于 0 时,第二个会话会处理类型化页面的新路径:它可以搜索并阅读网页,但只能使用处理值任务所需的工具。因临时原因失败的运行最多重试三次,达到用量上限时会停止其余网站的处理,看门狗会在五小时后结束运行,期间 Mac 会保持唤醒。

对于封面,脚本会为 Claude Code 提供第二个 MCP 服务器,它只有一个工具 make_cover,该工具使用 Codex CLI(以 ChatGPT 登录)或 Grok CLI 根据 AutoPSEO 的提示词绘图,二者各自运行在独立的沙盒中,并且只会上传到 app.autopseo.com。

如果只想让你自己的 AI 写作,请选择 Your own AI, through MCP 作为写手,并让 New articles per week 保持大于 0。该节奏同时也驱动着填充队列的每日审查和补充,因此设为 0 时,不会有新选题进入队列。

让你的 SEO 内容自动运行

连接 Search Console 和你的网站,AutoPSEO 会立即扫描并规划首批主题。无需信用卡。