SEOPro AI

io.github.alpha-ai-labs由 GitHub 账号 alpha-ai-labs 发布v1.2.0更新于 Oct 24, 2026

Turn Search Console data into SEO actions, content, publishing, indexing, and AI insights.

已验证Streamable HTTP可网页运行效率与工作流数据与分析商业与电商

概览

AI 生成的概览

托管式 SEO MCP 服务器，把 Search Console 数据转化为审计、关键词计划、AI 文章生成、CMS 发布与收录提交。

可以做什么
  • 列出账户下的网站，读取账户上下文、内容统计与自动运营状态
  • 获取 Google Search Console 表现、热门关键词、月度趋势与 AI 助手引流数据
  • 对任意网址运行技术 SEO 审计、检查 AI 引用情况并查看外链概况
  • 读取与生成关键词/内容计划，并启动异步文章生成、轮询生成状态
  • 列出与阅读文章，将审核通过的草稿发布到已连接的 CMS，并提交网址收录及查询收录状态
适用场景
适合管理一个或多个网站的创始人、市场人员、顾问与代理机构，希望助手把 Search Console 洞察串成优先级建议、内容生成、发布与收录的完整闭环。
运行要求
远程 Streamable HTTP 端点，无需本地运行时或安装包。需要 SEOPro AI 账户（README 提到付费七天试用）、已连接的网站、搜索表现流程所需的 Google Search Console，以及发布流程所需的受支持 CMS 连接。每个请求都需认证：交互式客户端用 OAuth，开发者客户端可用可撤销的 SEOPro AI API 密钥作为 bearer token。
安装前请注意
发布操作会把内容推送到线上 CMS（除非设置 publish_as_draft），收录操作会向 Google/Bing 提交网址；两者都需显式确认参数，并应先取得用户同意。生成关键词计划时使用 replace_existing 会丢弃待处理主题。账户数据、网站内容与工具参数会发送到 SEOPro AI 后端，后端会记录运营元数据。API 密钥应存放在客户端密钥库中，不要写入配置文件。

安装

在 SourceWeft 中

  1. 打开 控制台中的 SEOPro AI，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.alpha-ai-labs%2Fseo-agent/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "seopro-ai": {
      "type": "http",
      "url": "https://api.seoproai.co/api/mcp"
    }
  }
}

README

SEOPro AI Agent Plugin

Run the full SEO loop from your AI assistant:

Search Console insight → prioritized action → generated article → CMS publishing → indexing → measurable Google and AI-referral results.

SEOPro AI is a hosted remote MCP server for anyone responsible for website growth, from founders and small teams to in-house marketers, consultants, and agencies. It is distributed as a portable Agent Plugin. The implementation stays on SEOPro AI infrastructure; this repository contains the public connection metadata, setup guides, reusable SEO workflows, and security documentation.

[Agency operators reviewing an SEO workflow]

Connect

Install as an Agent Plugin

This repository conforms to Agent Plugins 1.0.0. Add or clone the repository through a compatible client's plugin installation flow. The client discovers:

text
seoproai-mcp/├── plugin.json                   # Agent Plugins manifest├── mcp.json                      # Agent Plugins MCP config├── .claude-plugin/plugin.json    # Claude plugin manifest├── .mcp.json                     # Claude plugin MCP config└── skills/    └── seoproai-operator/        └── SKILL.md
  • plugin.json identifies the portable package.
  • mcp.json declares the hosted Streamable HTTP server.
  • .claude-plugin/plugin.json and .mcp.json make the same package native to Claude Code and Cowork.
  • skills/seoproai-operator/ supplies safe SEO workflows and approval gates for one or many websites.

Agent Plugins 1.0.0 intentionally leaves remote authentication to the client. Complete OAuth in the client or keep a scoped SEOPro AI API key in its secret store. Never add credentials to mcp.json, plugin.json, or SKILL.md.

Clients that do not yet load Agent Plugins can use the manual setup below.

Connect manually

Remote MCP URL

text
https://api.seoproai.co/api/mcp

No server package or local runtime is required. Interactive clients use OAuth. Developer clients may use a revocable SEOPro AI API key as a bearer token.

Official MCP Registry identifier: io.github.alpha-ai-labs/seo-agent

ClientAuthSetup
ClaudeOAuthSettings → Connectors → Add custom connector → paste the URL → Connect
ChatGPTOAuthSettings → Apps & Connectors → Advanced/Developer mode → Create → paste the URL
CodexOAuthcodex mcp add seopro-ai --url https://api.seoproai.co/api/mcp, then codex mcp login seopro-ai
Claude CodeOAuth or API keyclaude mcp add --transport http seopro-ai https://api.seoproai.co/api/mcp
HermesAPI keyAdd the URL and environment-backed bearer header in ~/.hermes/config.yaml
OpenClawOAuth or API keyAdd a Streamable HTTP entry under mcp.servers; prefer OAuth or keep a static key in an environment variable
Cursor / WindsurfOAuth or API keyAdd a remote Streamable HTTP server in MCP settings

See client setup for copy-paste configurations and current caveats.

Three SEO workflows

1. Find website quick wins

text
Using SEOPro AI, list my websites. For [website], review the last 28 days ofSearch Console performance. Find queries ranking 5–15 with meaningfulimpressions, group them by page, and give me a prioritized action plan. Do notmake any changes.

2. Build and generate a content plan

text
Using SEOPro AI, review [client site]'s search performance and current keywordplan. Propose a four-week content plan around [service/topic]. Show me the planbefore creating it. After I approve it, create the keyword plan and generateonly the first article.

3. Review, publish, index, and measure

text
Using SEOPro AI, show me the draft for [article]. Check its title, metadescription, structure, and relevance to the target keyword. Do not publishuntil I explicitly approve the final draft. After approval, publish it, submitthe published URL for indexing, and give me a 30-day measurement checklist.

The complete prompt pack is in agency prompt pack.

Demo and example data

[Example connected Search Console performance view]

The Search Console image is an example connected performance view. Results vary by website.

What the server exposes

The server provides 18 narrowly scoped tools across:

  • Websites and account context.
  • Search Console summaries, keywords, trends, and AI-referral traffic.
  • Technical audits, AI citations, and backlink profiles.
  • Keyword/content planning and asynchronous article generation.
  • Draft review and explicit-confirmation CMS publishing.
  • Explicit-confirmation indexing requests and indexing status.

Read tools are annotated as read-only and non-destructive. Publishing and indexing are annotated as externally consequential and require an explicit confirmation argument on every call.

Privacy and security

  • Authentication is required for every MCP request.
  • OAuth and API-key access can be revoked.
  • Website ownership and subscription limits are enforced by the same backend routes used by the SEOPro AI dashboard.
  • Analytics records operational metadata such as tool name, success, latency band, auth method, and normalized client family. It never records credentials, tool arguments, article content, website content, or returned customer data.
  • The public repository contains no hosted-server source code or credentials.

Read SECURITY.md, architecture and data handling, and the SEOPro AI Privacy Policy.

Requirements

  • An SEOPro AI account. The current acquisition offer is a $1 seven-day trial.
  • Connected websites and, for search-performance workflows, Google Search Console.
  • A supported CMS connection for publishing workflows.

Start at seoproai.co/mcp.

Repository map

  • plugin.json — Agent Plugins 1.0.0 package manifest.
  • mcp.json — Portable Streamable HTTP MCP connection without embedded credentials.
  • .claude-plugin/plugin.json — Claude Code and Cowork plugin manifest.
  • .mcp.json — Claude-native remote HTTP connector configuration without embedded credentials.
  • server.json — Official MCP Registry metadata for the hosted endpoint.
  • docs/client-setup.md — Client-specific setup.
  • docs/agency-prompt-pack.md — Safe, reusable agency prompts.
  • docs/compatibility.md — Tested client/auth matrix.
  • docs/troubleshooting.md — Connection and tool-call diagnostics.
  • docs/architecture-and-data-handling.md — Trust boundary and analytics disclosure.
  • docs/directory-listing-copy.md — Canonical short and long listing descriptions.
  • docs/90-second-demo-script.md — Timed narration, capture plan, and privacy checklist.
  • docs/example-tool-results.md — Fictional sample data for screenshots and reviews.
  • assets/ — Public workflow and product-proof visuals.
  • skills/seoproai-operator/ — Portable Agent Skill for founders, small teams, in-house marketers, consultants, and agencies.
  • scripts/validate_agent_plugin.py — Schema, transport, package-boundary, and skill validation used by CI.

Support

Email [email protected] or open a GitHub issue without including credentials or customer data. Service availability: seoproai.co.

License

Documentation and repository assets are licensed under MIT. The hosted SEOPro AI service and its implementation remain proprietary and are governed by the Terms.

来源：README.md，提交 b0ec8b7

工具

18

list_websites

List Account Websites

List the websites in the user's SEOPro AI account. Returns each website's numeric website_id (needed by most other tools), URL, platform and autopilot status. Call this first.

无需输入参数。

get_website_stats

Get Website Content Stats

Get content stats for a website: total articles, keywords tracked, published posts and whether SEO autopilot is enabled.

输入参数website_id必填

get_search_performance

Get Search Performance

Get the Google Search Console performance summary for a website: clicks, impressions, CTR, average position, top keywords, AI-assistant traffic sources and device/country breakdowns. Dates are YYYY-MM-DD; defaults to the last 30 days.

输入参数end_datestart_datewebsite_id必填

get_top_search_keywords

Find Top Search Keywords

List the website's top search keywords with clicks, impressions, CTR and average position. Great for finding quick wins (positions 5-15 with high impressions). Dates are YYYY-MM-DD; defaults to the last 30 days.

输入参数limitend_datestart_datewebsite_id必填

get_ai_search_traffic

Measure AI Search Traffic

Show traffic the website receives from AI assistants and AI search (ChatGPT, Perplexity, Claude, Gemini, etc.): sessions, engaged pages and per-source breakdowns. Dates are YYYY-MM-DD; defaults to the last 30 days.

输入参数limitend_datestart_datewebsite_id必填

run_seo_audit

Run Technical SEO Audit

Run a technical SEO audit on any URL: meta tags, headings, images, links, performance, content quality, security and social metadata, with a scored result. Rate-limited for free accounts.

输入参数url必填

check_ai_citations

Check AI Citations

Check whether AI assistants (ChatGPT, Claude, Gemini, Perplexity) mention or cite a website when answering questions in its niche. Takes 1-3 minutes; results are cached for 7 days.

输入参数url必填

get_keyword_plan

Get Keyword Content Plan

Get the website's scheduled keyword/content plan: which keywords are planned, their scheduled dates and statuses.

输入参数website_id必填

generate_keyword_plan

Generate Keyword Content Plan

Generate an AI keyword/content plan for the website. Optionally guide it with topic instructions and comma-separated primary/secondary keywords. Can take a minute or two. Set replace_existing=true only after the user explicitly approves discarding the current plan's pending topics; that path also requires confirm_replace_existing=true.

输入参数website_id必填primary_keywordsreplace_existingsecondary_keywordstopic_instructionsconfirm_replace_existing

generate_article

Generate SEO Article

Start generating an SEO article for a target keyword. Returns immediately; generation takes 5-10 minutes in the background — poll get_article_status for the scheduled_date until it shows a blog. scheduled_date is YYYY-MM-DD and defaults to today (UTC). One article is generated per website per date; if that date already has an article the existing blog_id is returned. Counts toward the plan's monthly limit.

输入参数topickeyword必填website_id必填scheduled_date

get_article_status

Check Article Generation Status

Check article generation/publication status per date. Dates are YYYY-MM-DD and default to the current month. A date with has_blog=true and a blog_id means the article is ready to read via get_article.

输入参数end_datestart_datewebsite_id必填

list_articles

List Website Articles

List the website's articles (drafts and published), newest first. Optionally filter by status (e.g. 'draft', 'published').

输入参数limitstatuswebsite_id必填

get_article

Review Article Draft

Read a single article by blog_id. By default returns metadata and a short excerpt; set include_content=true for the full HTML content.

输入参数blog_id必填include_content

publish_article

Publish Article to CMS

Publish an article to the website's connected platform (WordPress, Shopify, Webflow, etc.). Set publish_as_draft=true to push it as an unpublished draft in the CMS instead of going live. Before calling, show the user the article and destination and obtain explicit approval. Every call requires confirm_publish=true.

输入参数blog_id必填confirm_publishpublish_as_draft

request_indexing

Request Search Engine Indexing

Submit up to 50 URLs for search-engine indexing (Google/Bing) via SEOPro AI auto-indexing. Requires the auto-indexing feature on the account. Show the exact URL list and obtain explicit user approval first; every call requires confirm_indexing=true.

输入参数urls必填website_id必填confirm_indexing

get_indexing_status

Get Indexing Status

Get auto-indexing stats for the website: how many URLs are indexed, pending or failed.

输入参数website_id必填

版本历史

1
  1. v1.2.0最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分