文件
透過 MCP 用你自己的 AI 寫作
讓 Claude 或其他 MCP 用戶端從內容佇列撰寫文章:認領主題、讀取 brief、提交草稿、翻譯與封面圖,或在 Mac 上無人值守地執行。
內容引擎多了第二位寫手:你自己的 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_instructions | read | 依據資源設定產生的單次完整無人值守執行指示 |
content_report | read | 設定、內容類型、額度、任務數量、最新的 20 篇已上線文章,以及被拒絕的交付 |
content_list_tasks | read | 任務清單,最有潛力者優先,並標示各任務由誰持有 |
content_find_pages | read | 找出網站中符合某個查詢的頁面,用於檢查涵蓋範圍並挑選連結 |
content_get_page | read | 文章的上線內容、審核中的草稿、各修訂版本,以及 28 天內的搜尋數據 |
content_get_translation | read | 單一語言:原文、譯者規則與目前的譯文 |
content_get_brief | paid | 寫作規則、brief、允許使用的連結、類型頁面的位址,以及是否需要封面圖 |
content_add_topics | write | 規劃 1 到 200 個主題;它們會經過關卡與審核 |
content_claim | write | 將任務保留兩小時:依任務、依頁面(rewrite、optimize 或 refresh)或依關鍵字 |
content_submit | write | 檢查並儲存草稿;仍有錯誤時不會儲存任何內容 |
content_submit_translation | write | 檢查並儲存草稿或已上線文章的單一語言版本 |
content_cover | write | 檢查畫面場景,並取得圖像提示詞、參考圖與上傳位址 |
content_set_cover | write | 設定或替換封面圖,或取得封面圖的上傳位址 |
content_publish | write | 核准草稿,或還原先前的修訂版本 |
content_unpublish | write | 下架文章 |
content_merge | write | 將文章合併至另一個頁面,並設定 301 轉址 |
content_decline | write | 附上原因,永久拒絕某項任務 |
content_propose_value | write | 在詢問你的網站後,為類型內容提出新值 |
content_submit_value | write | 送出新值的相關事實以供審核 |
content_remove_path | write | 請你的網站移除某個值的路徑 |
唯讀金鑰或僅有檢視權限的成員,會被所有非 read 的工具拒絕。會發布、下架、合併或移除路徑的工具,會提示 AI 只能在取得你同意後才執行。
撰寫文章
- 挑選任務。
content_list_tasks會顯示佇列中的任務;content_find_pages用來檢查你的網站是否已涵蓋該主題。 - 認領任務。
content_claim { taskId }會將任務保留兩小時,再次認領即可續約。你也可以用pageId與kind認領已上線的文章,或從關鍵字開始,並可選擇附上內容類型 key。關鍵字會先通過關卡。 - 讀取 brief。
content_get_brief會回傳rules(與 AutoPSEO 寫手使用的寫作規則相同)、brief、allowedLinks以及cover.wanted。第一次呼叫會研究搜尋結果並消耗研究點數;同一任務之後的呼叫則免費。 - 撰寫並提交。 以 delivery 所述的 JSON 格式,透過
content_submit送出文章。若未通過檢查,回應會以「Not saved. Fix these and submit again:」開頭並附上清單;allowedLinks以外的連結會被轉為粗體文字。當任務是修改已上線的文章時,請傳入baseRev,即你所依據的修訂版本;如果文章已有更新,提交會因衝突而被拒絕。 - 翻譯。 對每個其他語言,先呼叫
content_get_translation,再呼叫content_submit_translation。各語言可以平行送出。請見翻譯。 - 新增封面圖:當 brief 指出需要時(見下文)。
- 發布。 草稿會停留在審核狀態。
content_publish { taskId }會核准草稿,此工具只在你明確下達指示時才應使用。
保留期限到期後,每五分鐘一次的排程會釋放該任務:任務會回到佇列。content_decline 以 3 到 300 個字元的原因永久拒絕任務,之後不會再被提議。
修改審核中的草稿
當審核者要求修改時,不需要退回草稿:
- 以任務(或頁面,或關鍵字)呼叫
content_claim,會將你的草稿拉回撰寫狀態,在此期間無人能發布它。 content_get_page會以draft回傳該草稿。content_submit會在相同位址儲存下一個修訂版本,並將舊草稿標示為已被取代。- 重新送出譯文:新的修訂版本只包含它自己的語言,而
content_get_translation會以current提供被取代草稿的譯文。
如果保留期限先到期,草稿會原封不動地回到審核狀態。
提示詞
伺服器也提供提示詞,在 Claude Code 中會以斜線指令出現,例如 /mcp__autopseo__write-articles:
| 提示詞 | 參數 | 引導的流程 |
|---|---|---|
write-articles | site、count(1 到 10) | 逐步從佇列撰寫文章 |
revise-draft | site、draft、changes | 修改等待審核的草稿 |
optimize-page | site、page | 改進一篇已上線的文章 |
refresh-decayed | site、limit(最多 10) | 更新點擊數下滑的文章 |
connect-repo | articlesUrl | 在你網站的程式碼中建置已簽章的 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 訂閱執行這些工作。請聯絡我們取得腳本。設定步驟:
- 將 Claude Code 連接到 AutoPSEO(使用 Claude 中的連接器,或執行
claude mcp add --scope user --transport http autopseo https://app.autopseo.com/mcp,再於/mcp下選擇 Authenticate)。 - 執行
./install.sh。它會建立~/.autopseo/,其中包含run.sh、cover-mcp.mjs與範例writer.json,以及一個每天 15:07 執行的 launchd 工作(可透過AUTOPSEO_HOUR與AUTOPSEO_MINUTE調整)。此工作尚未載入。 - 填寫
~/.autopseo/writer.json:properties(每項含id,以及可選的limit,即每次執行的新文章數,預設 8,最多 20)、model與fallbackModel、供翻譯子代理使用的可選subagentModel、同一資源兩次執行之間相隔的everyDays(預設 3),以及covers(codex,grok或off)。 - 試跑一次:
AUTOPSEO_FORCE=1 ~/.autopseo/run.sh,然後查看~/.autopseo/logs/history.log。 - 載入排程:
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 時,不會有新主題進入佇列。