跳至內容
文件

MCP 與 ChatGPT 應用程式

透過登入或 API 金鑰,將 Claude、ChatGPT、Cursor 或任何 MCP 用戶端連接到 AutoPSEO 的 72 項工具,涵蓋 Search Console、GA4、研究資料與內容引擎。

MCP 與 API閱讀時間 1 分鐘

AutoPSEO 提供一個 MCP(Model Context Protocol)伺服器,位址為 https://app.autopseo.com/mcp。任何支援 MCP over HTTP 的 AI 助理都能連線,可以登入你的 AutoPSEO 帳號,也可以使用 apk_live_ API 金鑰。連線後,助理所能存取的資源、權限與方案,都與你本人相同。伺服器共註冊 72 項工具,分為三組:Search Console 與 GA4 報表、研究資料,以及內容引擎,你可以透過內容引擎讓自己的 AI 為網站撰寫文章。

透過登入連線

支援 MCP 登入的工具不需要金鑰。只要加入伺服器位址,在工具提示時登入 AutoPSEO 並核准授權,工具就會自行保存並更新存取權限。

  • Claude Code:執行 claude mcp add --transport http autopseo https://app.autopseo.com/mcp,接著輸入 /mcp,選擇 autopseo,再選擇 Authenticate。
  • 網頁版或桌面版 Claude:前往 Settings → Connectors → Add custom connector,貼上 https://app.autopseo.com/mcp,然後點選 Connect 並登入。
  • Cursor:將伺服器加入 ~/.cursor/mcp.json(適用所有專案)或 .cursor/mcp.json(僅適用單一專案),然後使用 Cursor 在旁邊顯示的 Connect 按鈕。
{ "mcpServers": { "autopseo": { "url": "https://app.autopseo.com/mcp" } } }

以這種方式連線的每個工具,都會顯示在 MCP & API 頁面的 Signed-in tools 底下,按下 Sign out 即可立即中斷其存取。建議第一個請求可以這樣問:「列出我帳號中的 Search Console 資源」。回覆能確認連線正常,也能讓助理取得其他工具所需的確切資源名稱。

ChatGPT

ChatGPT 透過開發人員模式連線,MCP & API 頁面的 ChatGPT app 區塊有逐步說明。簡單來說:在 ChatGPT 中開啟 Settings → Apps & Connectors → Advanced settings,啟用 Developer mode(該頁面列出 ChatGPT Plus、Pro、Business、Enterprise 與 Edu 方案),選擇 Create,為連接器命名,將 MCP 伺服器 URL 設為 https://app.autopseo.com/mcp,驗證方式選擇 OAuth,並在 ChatGPT 提示時登入 AutoPSEO。ChatGPT 的連接器只支援 OAuth 或不驗證,因此無法使用 API 金鑰。更多說明請見 ChatGPT 頁面。

使用 API 金鑰連線

金鑰適用於指令碼、排程工作,以及沒有瀏覽器的機器。在 MCP & API → API keys 中為金鑰命名並選擇權限範圍:

  • Read only:可查詢資料與執行報表,但無法新增、修改或刪除任何內容。
  • Read & write:包含唯讀金鑰的所有功能,另可使用會變更資料或消耗研究點數的工具。

完整金鑰為 apk_live_ 加上 32 個十六進位字元,只會顯示一次;AutoPSEO 僅儲存其 SHA-256 雜湊值。金鑰清單會顯示每把金鑰的建立時間、最後使用時間與請求次數,按下 Revoke 即可立刻停用金鑰。你最多可同時擁有 25 把有效金鑰。請以 Authorization: Bearer apk_live_... 傳送金鑰(也可使用 x-api-key 標頭):

claude mcp add --transport http autopseo https://app.autopseo.com/mcp --header "Authorization: Bearer apk_live_..."

該頁面還提供 OpenAI Responses API 的範例、以 curl 發送原始 JSON-RPC 的範例(伺服器採用 Streamable HTTP transport),以及位於 https://app.autopseo.com/v1 的 REST API。REST API 以相同的金鑰提供 19 項 Search Console 與 GA4 工具,並在 /v1/openapi.json 提供 OpenAPI 3.1 文件。

工具

MCP & API 頁面會隨時列出最新的工具名稱;撰寫本頁時共有 72 項。

Search Console 與 GA4(19 項工具)

list_properties、search_analytics、top_queries、top_pages、top_countries、compare_periods、content_decay、cannibalization、ctr_benchmark、page_poaching、rank_changes、new_lost_rankings、url_inspection、sitemaps、annotations、create_annotation、ga4_overview、ga4_breakdown 與 ga4_key_events。這些工具不消耗點數。若未指定日期,預設會以最近 28 個已穩定的日期,對比其前 28 天;任何人都可以在示範資源 sc-domain:demo.autopseo.app 上試用。content_decay 雖然名稱看起來屬於內容類,但實際歸在這一組:它用來找出點擊數持續流失的頁面。

研究(33 項工具)

  • 帳號與專案:whoami、create_project、get_project_context、update_project_context
  • 關鍵字:research_keywords、get_keyword_metrics、get_ranked_keywords、get_domain_keyword_suggestions、save_keywords、list_saved_keywords
  • 網域、搜尋結果頁與連結:get_domain_overview、get_serp_results、find_serp_competitors、get_backlinks_overview、get_backlinks_profile
  • 排名追蹤:create_rank_tracker、get_rank_tracker、add_rank_tracking_keywords、remove_rank_tracking_keywords、estimate_rank_tracker_cost、run_rank_tracker
  • 在地搜尋:search_local_businesses、get_local_serp_results、get_local_rank_grid、get_business_profile、get_business_reviews、get_business_updates、get_google_business_questions、list_business_categories
  • 網站稽核:run_site_audit、get_audit_status、get_audit_issues、get_audit_pages

其中許多工具會向 DataForSEO 購買資料,並動用你的研究點數,因此請讓每次請求保持精準,大批量執行前也請先確認。

內容引擎(20 項工具)

這些工具讓你自己的 AI 與 AutoPSEO 的寫作引擎使用同一個佇列:content_list_tasks、content_claim、content_get_brief、content_submit、content_publish、content_unpublish、content_get_page、content_report、content_find_pages、content_add_topics、content_decline、content_merge、content_cover、content_set_cover、content_get_translation、content_submit_translation、content_instructions、content_propose_value、content_submit_value 與 content_remove_path。伺服器另外提供五個提示:write-articles、optimize-page、revise-draft、connect-repo 與 refresh-decayed。

典型的工作流程如下:列出任務,認領其中一項(認領後會保留兩小時),閱讀簡報,撰寫並提交,修正檢查回報的問題,最後只在你下達指示時才發布。封面圖片與翻譯各有專屬工具。以這種方式撰寫的文章會通過與 AutoPSEO 自家文章相同的檢查,而且不會佔用你的文章額度;不過每份簡報第一次呼叫時,會以研究點數讀取即時的搜尋結果。完整流程請見用你自己的 AI 寫作。

讀取、寫入與付費工具

每項工具都有一個存取類別。讀取工具只查看資料(共 33 項),寫入工具會變更你的工作區(共 22 項),付費工具雖然只讀取資料,但會購買研究資料(共 17 項)。唯讀金鑰只能呼叫讀取工具。具有 Read 權限的團隊成員同樣只能呼叫讀取工具,無論使用哪把金鑰或哪種登入方式;每位成員也只能存取邀請中指定的資源(共用與團隊存取)。

限制與錯誤

每把金鑰每分鐘最多 60 次呼叫,每個帳號每小時最多 1,000 次呼叫(所有金鑰合計)。超過任一上限時,伺服器會回應 HTTP 429 並附上 Retry-After 標頭,大多數用戶端會自行等待並重試;initialize 與 ping 握手不計入次數。試用期結束且未訂閱時,工具會回應「subscription required」。你的資料只會在你發出請求時傳送給助理的供應商;登出工具或撤銷其金鑰即可停止傳送。更多範例請見 Search Console MCP 頁面。

讓你的 SEO 內容自動運行

連結 Search Console 與你的網站,AutoPSEO 會立即掃描並規劃首批主題。無需信用卡。