文档
MCP 与 ChatGPT 应用
通过登录或 API 密钥,将 Claude、ChatGPT、Cursor 或任意 MCP 客户端连接到 AutoPSEO 的 72 个工具,涵盖 Search Console、GA4、研究数据和内容引擎。
AutoPSEO 提供一个 MCP(Model Context Protocol)服务器,地址为 https://app.autopseo.com/mcp。任何支持 HTTP 协议 MCP 的助手都可以接入:既可以登录你的 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 传输),以及位于 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 写作。
读取、写入与付费工具
每个工具都有一个访问类别。Read 工具只查看数据(共 33 个),write 工具会修改你的工作区(共 22 个),paid 工具只读取数据,但会购买研究数据(共 17 个)。只读密钥只能调用 read 工具。拥有 Read 权限的团队成员同样只能调用 read 工具,无论他们使用哪个密钥或登录方式;每位成员也只能访问邀请中指定的资源(共享与团队访问)。
限制与错误
调用频率上限为每个密钥每分钟 60 次,每个账号每小时 1,000 次(该账号下所有密钥合计)。超过任一上限时,服务器会返回 HTTP 429 并附带 Retry-After 响应头,大多数客户端会自动等待并重试;initialize 和 ping 握手不计入次数。试用期结束且未订阅后,工具会返回“subscription required”。助手服务商仅在你发起请求时才会接收你的数据;如需停止,请让工具退出登录或撤销其密钥。更多示例请参阅 Search Console MCP 页面。