跳至內容
文件

透過 MCP 用你自己的 AI 寫作

讓 Claude 或其他 MCP 用戶端從內容佇列撰寫文章:認領主題、讀取 brief、提交草稿、翻譯與封面圖,或在 Mac 上無人值守地執行。

資源 → 內容 → 設定閱讀時間 3 分鐘

內容引擎多了第二位寫手:你自己的 AI。任何已登入 AutoPSEO 的 MCP 用戶端,例如 Claude Code、Claude 應用程式或 Cursor,都能從同一個佇列領取主題,讀取相同的 brief 與規則,並提交通過與 AutoPSEO 寫手相同檢查的草稿。以這種方式撰寫的草稿不會計入每月文章額度。你可以在對話中與它協作,也可以讓無人值守的排程執行自動寫作。

連接你的 AI

MCP 端點為 https://app.autopseo.com/mcp。有兩種連接方式,都在帳號的 MCP & API 頁面:

  • 以 OAuth 登入:在「Connect by signing in」下操作。在 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_instructionsread依據資源設定產生的單次完整無人值守執行指示
content_reportread設定、內容類型、額度、任務數量、最新的 20 篇已上線文章,以及被拒絕的交付
content_list_tasksread任務清單,最有潛力者優先,並標示各任務由誰持有
content_find_pagesread找出網站中符合某個查詢的頁面,用於檢查涵蓋範圍並挑選連結
content_get_pageread文章的上線內容、審核中的草稿、各修訂版本,以及 28 天內的搜尋數據
content_get_translationread單一語言:原文、譯者規則與目前的譯文
content_get_briefpaid寫作規則、brief、允許使用的連結、類型頁面的位址,以及是否需要封面圖
content_add_topicswrite規劃 1 到 200 個主題;它們會經過關卡與審核
content_claimwrite將任務保留兩小時:依任務、依頁面(rewrite、optimize 或 refresh)或依關鍵字
content_submitwrite檢查並儲存草稿;仍有錯誤時不會儲存任何內容
content_submit_translationwrite檢查並儲存草稿或已上線文章的單一語言版本
content_coverwrite檢查畫面場景,並取得圖像提示詞、參考圖與上傳位址
content_set_coverwrite設定或替換封面圖,或取得封面圖的上傳位址
content_publishwrite核准草稿,或還原先前的修訂版本
content_unpublishwrite下架文章
content_mergewrite將文章合併至另一個頁面,並設定 301 轉址
content_declinewrite附上原因,永久拒絕某項任務
content_propose_valuewrite在詢問你的網站後,為類型內容提出新值
content_submit_valuewrite送出新值的相關事實以供審核
content_remove_pathwrite請你的網站移除某個值的路徑

唯讀金鑰或僅有檢視權限的成員,會被所有非 read 的工具拒絕。會發布、下架、合併或移除路徑的工具,會提示 AI 只能在取得你同意後才執行。

撰寫文章

  1. 挑選任務。 content_list_tasks 會顯示佇列中的任務;content_find_pages 用來檢查你的網站是否已涵蓋該主題。
  2. 認領任務。 content_claim { taskId } 會將任務保留兩小時,再次認領即可續約。你也可以用 pageId 與 kind 認領已上線的文章,或從關鍵字開始,並可選擇附上內容類型 key。關鍵字會先通過關卡。
  3. 讀取 brief。 content_get_brief 會回傳 rules(與 AutoPSEO 寫手使用的寫作規則相同)、brief、allowedLinks 以及 cover.wanted。第一次呼叫會研究搜尋結果並消耗研究點數;同一任務之後的呼叫則免費。
  4. 撰寫並提交。 以 delivery 所述的 JSON 格式,透過 content_submit 送出文章。若未通過檢查,回應會以「Not saved. Fix these and submit again:」開頭並附上清單;allowedLinks 以外的連結會被轉為粗體文字。當任務是修改已上線的文章時,請傳入 baseRev,即你所依據的修訂版本;如果文章已有更新,提交會因衝突而被拒絕。
  5. 翻譯。 對每個其他語言,先呼叫 content_get_translation,再呼叫 content_submit_translation。各語言可以平行送出。請見翻譯。
  6. 新增封面圖:當 brief 指出需要時(見下文)。
  7. 發布。 草稿會停留在審核狀態。content_publish { taskId } 會核准草稿,此工具只在你明確下達指示時才應使用。

保留期限到期後,每五分鐘一次的排程會釋放該任務:任務會回到佇列。content_decline 以 3 到 300 個字元的原因永久拒絕任務,之後不會再被提議。

修改審核中的草稿

當審核者要求修改時,不需要退回草稿:

  1. 以任務(或頁面,或關鍵字)呼叫 content_claim,會將你的草稿拉回撰寫狀態,在此期間無人能發布它。
  2. content_get_page 會以 draft 回傳該草稿。
  3. content_submit 會在相同位址儲存下一個修訂版本,並將舊草稿標示為已被取代。
  4. 重新送出譯文:新的修訂版本只包含它自己的語言,而 content_get_translation 會以 current 提供被取代草稿的譯文。

如果保留期限先到期,草稿會原封不動地回到審核狀態。

提示詞

伺服器也提供提示詞,在 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 設定。它也可以透過 content_cover 使用 AutoPSEO 自己的提示詞來生成圖片。格式、尺寸與檢查規則請見封面圖。

費用

  • 來自你自己 AI 的草稿與譯文不會計入每月文章額度,提交也不收費。
  • brief 首次查看搜尋結果,以及為兩種類型都適用的關鍵字挑選內容類型時所呼叫的模型,會使用研究點數。
  • 新增主題、拒絕任務與讀取類工具皆免費。在由 AutoPSEO 負責翻譯的網站上,核准缺少語言版本的草稿時,會以研究點數啟動翻譯。

在 Mac 上無人值守執行

content_instructions 會回傳一次無人值守執行針對某個資源應做的所有事:回報、完成前一次執行遺留的工作、在花費於 brief 之前先檢查涵蓋範圍、拒絕重複的任務、撰寫、翻譯、新增封面圖,並且只在網站的審核功能關閉時才發布。它絕不會下架文章或回滾,並以一行可供腳本讀取的結果作結:

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 會立即掃描並規劃首批主題。無需信用卡。